Redis 安装与配置教程 (Windows, Linux, macOS)

sudo systemctl start redis-server
sudo systemctl enable redis-server

4. 检查状态:

sudo systemctl status redis-server

5. 验证安装:

redis-cli --version
redis-server --version

6. 使用 Redis 客户端:

redis-cli
127.0.0.1:6379> ping
PONG

方法二：源码编译安装 (获取最新版本)

1. 安装编译依赖:

sudo apt update
sudo apt install build-essential tcl

2. 下载并解压:

wget https://download.redis.io/releases/redis-7.2.4.tar.gz
tar xzf redis-7.2.4.tar.gz
cd redis-7.2.4

3. 编译与安装:

make
make test
sudo make install

4. 配置与运行:
   • Redis 默认安装在 /usr/local/bin。
   • 复制配置文件模板并编辑：

sudo mkdir /etc/redis
sudo cp redis.conf /etc/redis/redis.conf
sudo nano /etc/redis/redis.conf
# 根据需要修改配置，如 daemonize yes 以守护进程运行

• 启动服务：

redis-server /etc/redis/redis.conf

其他 Linux 发行版

Arch Linux:

sudo pacman -S redis
sudo systemctl start redis.service
sudo systemctl enable redis.service

CentOS/RHEL/Fedora:

sudo yum install epel-release # 或 sudo dnf install epel-release
sudo yum install redis # 或 sudo dnf install redis
sudo systemctl start redis
sudo systemctl enable redis

3. macOS 系统安装 (使用 Homebrew)

macOS 上推荐使用 Homebrew 安装 Redis。

1. 安装 Homebrew (如果尚未安装):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 使用 Homebrew 安装 Redis:

brew update
brew install redis

3. 启动与管理服务:
   • 安装完成后，可以使用以下命令启动 Redis，并设置为开机自启：

brew services start redis

• 检查服务状态：

brew services list

• 或者，手动启动（前台运行）：

redis-server /usr/local/etc/redis.conf

4. 验证安装:

redis-cli --version
redis-server --version
redis-cli 127.0.0.1:6379> ping
PONG

4. 基本配置 (所有系统)

无论哪种安装方式，通常都需要了解并可能修改配置文件以满足需求。配置文件通常名为 redis.conf。

1. 找到配置文件:
   • Windows: 安装目录下 (如 C:\Program Files\Redis\redis.conf)。
   • Linux (包管理安装): /etc/redis/redis.conf。
   • Linux (源码安装): 编译目录下的 redis.conf，或复制到 /etc/redis/。
   • macOS (Homebrew): /usr/local/etc/redis.conf。
2. 常用配置项:
   • daemonize yes/no: 是否以守护进程（后台）方式运行。
   • port 6379: Redis 监听的端口号。
   • bind 127.0.0.1: 绑定的主机地址。0.0.0.0 表示允许所有网络接口连接（注意安全风险）。
   • requirepass yourpassword: 设置连接密码（强烈建议在生产环境设置）。
   • databases 16: 默认数据库数量。
   • dir ./: RDB 持久化文件存储目录。建议设置为明确的路径（如 /var/lib/redis）。
   • dbfilename dump.rdb: RDB 持久化文件名。
   • appendonly yes/no: 是否启用 AOF (Append Only File) 持久化。
   • appendfilename "appendonly.aof": AOF 文件名。
3. 修改配置后重启服务:
   • Windows: 在服务管理器中重启 Redis 服务。
   • macOS (Homebrew): brew services restart redis
   • Linux (systemd): sudo systemctl restart redis-server
4. 设置密码连接:
   • 在 redis.conf 中设置 requirepass your_strong_password。
   • 重启 Redis。
   • 连接客户端时需要认证：

redis-cli 127.0.0.1:6379> auth your_strong_password
OK

• 或者：

redis-cli -a your_strong_password # 注意：密码会出现在命令历史中，不安全

5. 基础操作与验证

• 启动服务：根据上述系统说明启动 Redis 服务 (redis-server 或服务管理命令)。
• 连接客户端：redis-cli。
• 测试连接：在 redis-cli 中执行 ping，应返回 PONG。
• 退出客户端：quit 或 exit。
• 停止服务：
  • 在 redis-cli 中执行 shutdown (需要权限)。
  • 或者使用系统服务管理命令停止 (如 sudo systemctl stop redis-server)。
• 设置/获取键值：

set mykey "Hello Redis"
get mykey

6. 防火墙配置 (如果需要远程访问)

如果需要在其他机器上访问 Redis 服务器，需要确保服务器的防火墙允许 Redis 端口 (默认 6379/tcp) 的入站连接。

• Windows: 在 Windows Defender 防火墙中添加入站规则，允许 TCP 端口 6379。
• macOS: 在 系统偏好设置 -> 安全性与隐私 -> 防火墙 -> 防火墙选项 中添加端口 6379。
• Linux (firewalld):

sudo firewall-cmd --permanent --add-port=6379/tcp
sudo firewall-cmd --reload

• Linux (ufw):

sudo ufw allow 6379/tcp
sudo ufw reload

注意：开放端口后，务必在 redis.conf 中设置强密码 (requirepass) 并考虑限制可访问的 IP (bind 或使用防火墙规则)，以保障安全。

7. 常见问题

• 端口 6379 被占用：检查是否有其他程序占用了该端口，或修改 redis.conf 中的 port 配置。
• 权限问题：确保 Redis 进程有权限读写配置中指定的目录（如持久化目录 dir）。
• 连接失败：检查 Redis 服务是否正在运行 (ps aux | grep redis-server)，检查防火墙设置，检查 bind 配置是否正确。
• 配置文件错误：修改配置文件后重启服务失败，可能是配置语法错误。仔细检查修改的部分。