Mac电脑上本地安装 redis并配置开启自启完整流程

文章目录

• • • [一、安装 Redis](#一、安装 Redis)
    • • [方法 1：通过源码编译安装（推荐）](#方法 1：通过源码编译安装（推荐）)
      • [方法 2：通过 Homebrew 安装（可选）](#方法 2：通过 Homebrew 安装（可选）)
    • [二、配置 Redis](#二、配置 Redis)
    • • [1. 创建配置文件和数据目录](#1. 创建配置文件和数据目录)
      • [2. 修改配置文件](#2. 修改配置文件)
    • 三、配置开机自启
    • • [1、通过 `launchd` 系统服务（原生支持）](#1、通过 launchd 系统服务（原生支持）)
      • [2. 设置权限并加载服务](#2. 设置权限并加载服务)
      • [3. 验证服务状态](#3. 验证服务状态)
    • [四、管理 Redis 服务](#四、管理 Redis 服务)
    • 五、常见问题解决
    • 六、可视化工具推荐

以下是在 Mac 电脑上本地安装 Redis 并配置开机自启的完整流程，涵盖 源码编译安装 和 配置系统级自启 的详细步骤：

---

一、安装 Redis

方法 1：通过源码编译安装（推荐）

# 1. 下载最新稳定版 Redis 源码
cd ~
curl -O https://download.redis.io/releases/redis-7.2.4.tar.gz
tar -xzvf redis-7.2.4.tar.gz
cd redis-7.2.4

# 2. 编译安装（需 Xcode 命令行工具）
make
sudo make install  # 安装到 /usr/local/bin

# 3. 验证安装
redis-server --version

方法 2：通过 Homebrew 安装（可选）

# 安装 Homebrew（若未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Redis
brew install redis

---

二、配置 Redis

1. 创建配置文件和数据目录

# 创建配置目录和数据目录
sudo mkdir -p /usr/local/etc/redis
sudo mkdir -p /usr/local/var/redis

# 复制默认配置文件
sudo cp ~/redis-7.2.4/redis.conf /usr/local/etc/redis/

2. 修改配置文件

sudo nano /usr/local/etc/redis/redis.conf

关键配置项：

daemonize yes                     # 后台运行
dir /usr/local/var/redis          # 数据存储路径
requirepass yourpassword          # 设置密码（可选）
bind 127.0.0.1                    # 只允许本地连接

---

三、配置开机自启

1、通过 launchd 系统服务（原生支持）

# 1. 创建 plist 文件
sudo vim /Library/LaunchDaemons/io.redis.redis-server.plist

写入以下内容（根据实际路径调整）：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>io.redis.redis-server</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/redis-server</string>
        <string>/usr/local/etc/redis/redis.conf</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>WorkingDirectory</key>
    <string>/usr/local/var/redis</string>
    <key>StandardErrorPath</key>
    <string>/usr/local/var/redis/redis.log</string>
    <key>StandardOutPath</key>
    <string>/usr/local/var/redis/redis.log</string>
</dict>
</plist>

2. 设置权限并加载服务

sudo chown root:wheel /Library/LaunchDaemons/io.redis.redis-server.plist
sudo launchctl load -w /Library/LaunchDaemons/io.redis.redis-server.plist

3. 验证服务状态

sudo launchctl list | grep redis
redis-cli ping  # 应返回 "PONG"

---

四、管理 Redis 服务

操作	命令
手动启动	sudo /usr/local/bin/redis-server /usr/local/etc/redis/redis.conf
停止服务	redis-cli shutdown 或 sudo killall redis-server
查看日志	tail -f /usr/local/var/redis/redis.log
卸载 Redis	删除 /Library/LaunchDaemons/io.redis.redis-server.plist 和 Redis 二进制文件

---

五、常见问题解决

1. 端口冲突

   • 修改 redis.conf 中的 port 6379 为其他端口。

2. 权限问题

   sudo chown -R $(whoami):admin /usr/local/var/redis

3. 连接失败

   • 检查是否设置了密码：redis-cli -a yourpassword

---

六、可视化工具推荐

• RedisInsight （官方工具）：下载地址
• Another Redis Desktop Manager ：GitHub

---

通过以上步骤，Redis 将在 Mac 启动时自动运行，并通过系统级服务管理确保稳定性。如需更简化的管理，可改用 Homebrew 安装并配合 brew services 命令。