Skip to content

Redis Windows 安装 ​

系统要求 ​

1. 操作系统版本 ​

  • 支持的Windows版本:

    • Windows Server 2019 及以上
    • Windows 10 及以上
    • Windows Server 2016(有限支持)
    • Windows 8.1(有限支持)
  • 注意事项:

    • Redis 6.0+ 对Windows的支持更加完善
    • 建议使用64位Windows系统
    • 确保系统已安装最新的Windows更新

2. 硬件要求 ​

  • CPU:至少 2 核
  • 内存:至少 2GB RAM
  • 磁盘空间:至少 500MB 可用空间

安装方法 ​

1. 下载 Redis 安装包 ​

1.1 官方下载渠道 ​

1.2 选择合适的版本 ​

  • 稳定版:选择带有 stable 标签的版本,如 Redis-x64-5.0.14.msi
  • 预览版:带有 preview 标签的版本,适合测试新功能
  • 架构:根据系统架构选择 x86 或 x64 版本,推荐 x64

2. 使用 MSI 安装包安装 ​

2.1 运行安装程序 ​

  1. 双击下载的 .msi 安装包,启动安装向导
  2. 点击 "Next" 进入许可协议页面
  3. 勾选 "I accept the terms in the License Agreement",点击 "Next"

2.2 选择安装类型 ​

  • Typical(推荐):安装默认组件和配置
  • Custom:自定义安装路径和组件
  • Complete:安装所有组件

2.3 选择安装路径 ​

  • 默认安装路径:C:\Program Files\Redis
  • 可以点击 "Change" 自定义安装路径
  • 点击 "Next" 继续

2.4 配置选项 ​

  • Port:Redis 服务监听端口,默认 6379
  • Max Memory:Redis 最大内存限制,默认 100MB
  • Install as a service:勾选此项,将 Redis 安装为 Windows 服务
  • Add Redis to Path:勾选此项,将 Redis 添加到系统环境变量
  • 点击 "Next" 继续

2.5 完成安装 ​

  1. 点击 "Install" 开始安装
  2. 等待安装完成
  3. 点击 "Finish" 退出安装向导

3. 使用 ZIP 压缩包安装 ​

3.1 解压压缩包 ​

  1. 右键点击下载的 .zip 压缩包,选择 "Extract All..."
  2. 选择解压路径,如 C:\Redis
  3. 点击 "Extract" 完成解压

3.2 配置环境变量 ​

  1. 右键点击 "此电脑",选择 "属性"
  2. 点击 "高级系统设置"
  3. 点击 "环境变量"
  4. 在 "系统变量" 中找到 "Path",点击 "编辑"
  5. 点击 "新建",添加 Redis 解压目录的路径,如 C:\Redis
  6. 点击 "确定" 保存更改

配置 Redis ​

1. 配置文件位置 ​

  • MSI 安装:配置文件位于 C:\Program Files\Redis\redis.windows-service.conf(服务模式)和 redis.windows.conf(命令行模式)
  • ZIP 安装:配置文件位于解压目录,如 C:\Redis\redis.windows.conf

2. 常用配置选项 ​

2.1 基本配置 ​

txt
# 监听端口
port 6379

# 绑定IP地址,0.0.0.0表示允许所有IP访问
bind 0.0.0.0

# 最大连接数
maxclients 10000

# 最大内存限制
maxmemory 512mb

# 内存淘汰策略
maxmemory-policy volatile-lru

2.2 持久化配置 ​

txt
# 启用AOF持久化
appendonly yes

# AOF文件名称
appendfilename "appendonly.aof"

# AOF同步策略:everysec(每秒同步)、always(每次写入同步)、no(由操作系统决定)
appendfsync everysec

# RDB持久化配置
save 900 1
save 300 10
save 60 10000

2.3 日志配置 ​

txt
# 日志级别:debug、verbose、notice、warning
loglevel notice

# 日志文件路径,空表示输出到控制台
logfile "redis.log"

3. 修改配置文件 ​

  1. 使用文本编辑器(如 Notepad++、VS Code)打开配置文件
  2. 根据需要修改配置选项
  3. 保存文件
  4. 重启 Redis 服务或进程使配置生效

启动 Redis ​

1. 作为 Windows 服务启动 ​

1.1 安装为服务 ​

如果在 MSI 安装时未勾选 "Install as a service",可以手动注册服务:

bash
# 打开命令提示符(管理员权限)
# 切换到 Redis 安装目录
cd "C:\Program Files\Redis"

# 注册 Redis 服务
redis-server --service-install redis.windows-service.conf --loglevel notice

1.2 启动服务 ​

  • 使用服务管理器:

    1. 按下 Win + R,输入 services.msc,点击 "确定"
    2. 在服务列表中找到 "Redis"
    3. 右键点击 "Redis",选择 "启动"
  • 使用命令行:

    bash
    # 启动 Redis 服务
    net start redis
    
    # 停止 Redis 服务
    net stop redis

2. 命令行模式启动 ​

2.1 前台启动 ​

bash
# 打开命令提示符
# 切换到 Redis 安装目录
cd "C:\Program Files\Redis"

# 启动 Redis 服务器(前台模式)
redis-server redis.windows.conf

2.2 后台启动 ​

bash
# 打开命令提示符(管理员权限)
# 切换到 Redis 安装目录
cd "C:\Program Files\Redis"

# 注册为临时服务
redis-server --service-start

# 停止临时服务
redis-server --service-stop

验证安装 ​

1. 测试 Redis 连接 ​

bash
# 打开命令提示符
# 连接到 Redis 服务器
redis-cli

# 发送 PING 命令,返回 PONG 表示连接成功
ping

# 设置键值对
set test-key "Hello Redis"

# 获取键值对
get test-key

# 退出 Redis CLI
exit

2. 检查 Redis 服务状态 ​

bash
# 查看 Redis 服务状态
sc query redis

# 或使用 PowerShell
Get-Service -Name redis

3. 查看 Redis 日志 ​

  • 日志文件位置:根据配置文件中的 logfile 选项确定
  • 使用文本编辑器打开日志文件,查看启动信息和运行状态

Redis 服务管理 ​

1. 注册服务 ​

bash
# 注册 Redis 服务
redis-server --service-install redis.windows-service.conf --loglevel notice

2. 启动服务 ​

bash
redis-server --service-start

3. 停止服务 ​

bash
redis-server --service-stop

4. 卸载服务 ​

bash
redis-server --service-uninstall

5. 重命名服务 ​

bash
redis-server --service-install --service-name Redis2 --port 6380

常见问题 ​

1. 端口被占用 ​

  • 症状:启动 Redis 服务时提示 "错误 1067:进程意外终止"
  • 解决方案:
    1. 检查端口 6379 是否被其他进程占用
    2. 使用命令 netstat -ano | findstr :6379 查看占用端口的进程 ID
    3. 结束占用端口的进程,或修改 Redis 配置文件中的端口

2. 内存不足 ​

  • 症状:Redis 服务启动后自动停止,日志中出现 "Out of memory" 错误
  • 解决方案:
    1. 增加系统内存
    2. 修改 Redis 配置文件中的 maxmemory 选项,调整最大内存限制
    3. 优化 Redis 内存使用,如使用合适的数据结构、定期清理过期键

3. 服务无法启动 ​

  • 症状:使用 net start redis 启动服务时失败
  • 解决方案:
    1. 检查 Redis 日志文件,查看具体错误信息
    2. 确保配置文件路径正确
    3. 确保 Redis 安装目录有读写权限
    4. 尝试重新注册服务

4. 远程连接失败 ​

  • 症状:无法从远程机器连接到 Redis 服务器
  • 解决方案:
    1. 确保 Redis 配置文件中的 bind 选项设置为 0.0.0.0
    2. 检查 Windows 防火墙是否允许 Redis 端口(默认 6379)
    3. 如果启用了密码认证,确保客户端提供了正确的密码

5. 数据持久化失败 ​

  • 症状:Redis 重启后数据丢失
  • 解决方案:
    1. 检查 Redis 配置文件中的持久化选项是否正确配置
    2. 确保 Redis 有写入持久化文件的权限
    3. 检查磁盘空间是否充足

卸载 Redis ​

1. 从控制面板卸载 ​

  1. 按下 Win + R,输入 appwiz.cpl,点击 "确定"
  2. 在程序列表中找到 "Redis"
  3. 右键点击 "Redis",选择 "卸载"
  4. 按照卸载向导的提示完成卸载

2. 手动卸载 ​

2.1 停止并卸载 Redis 服务 ​

bash
# 打开命令提示符(管理员权限)
# 停止 Redis 服务
net stop redis

# 卸载 Redis 服务
redis-server --service-uninstall

2.2 删除安装文件 ​

  1. 删除 Redis 安装目录,如 C:\Program Files\Redis
  2. 删除 Redis 数据目录,如 C:\ProgramData\Redis(如果存在)

2.3 删除环境变量 ​

  1. 右键点击 "此电脑",选择 "属性"
  2. 点击 "高级系统设置"
  3. 点击 "环境变量"
  4. 在 "系统变量" 中找到 "Path",点击 "编辑"
  5. 删除 Redis 相关的环境变量路径
  6. 点击 "确定" 保存更改

最佳实践 ​

1. 安全配置 ​

  • 设置密码认证:在配置文件中添加 requirepass your-strong-password
  • 限制访问IP:修改 bind 选项,只允许特定IP访问
  • 启用 TLS/SSL:配置 Redis 使用加密连接
  • 定期更新 Redis 版本:保持 Redis 版本最新,修复安全漏洞

2. 性能优化 ​

  • 合理设置最大内存:根据系统内存大小调整 maxmemory 选项
  • 选择合适的内存淘汰策略:根据业务场景选择 maxmemory-policy
  • 优化持久化配置:根据数据重要性和性能需求调整持久化策略
  • 使用合适的数据结构:选择最适合业务场景的数据结构

3. 监控与维护 ​

  • 定期备份数据:定期备份 RDB 和 AOF 文件
  • 监控 Redis 性能:使用 Redis CLI 的 INFO 命令或第三方监控工具
  • 定期清理过期键:使用 EXPIRE 命令设置键的过期时间,定期清理
  • 记录日志:配置合适的日志级别,定期检查日志文件

4. 高可用配置 ​

  • 主从复制:配置 Redis 主从复制,提高可用性
  • Redis Sentinel:部署 Redis Sentinel 实现自动故障转移
  • Redis Cluster:部署 Redis Cluster 实现分布式架构

常用命令 ​

1. Redis 服务器命令 ​

bash
# 查看 Redis 版本
redis-server --version

# 查看 Redis 帮助
redis-server --help

# 检查配置文件语法
redis-check-aof --fix appendonly.aof

2. Redis CLI 命令 ​

bash
# 连接到 Redis 服务器
redis-cli -h 127.0.0.1 -p 6379 -a your-password

# 查看 Redis 信息
info

# 查看内存使用情况
info memory

# 查看客户端连接信息
info clients

# 查看键的数量
dbsize

# 查看所有键
keys *

常见问题(FAQ) ​

Q1: Windows 上的 Redis 与 Linux 上的 Redis 有什么区别? ​

A1: Windows 上的 Redis 是由 Microsoft Open Tech Group 维护的分支版本,与 Linux 上的官方 Redis 相比,主要区别在于:

  1. Windows 版本的 Redis 性能略低于 Linux 版本
  2. 某些高级功能可能不被支持或实现方式不同
  3. Windows 版本的更新频率可能低于官方 Linux 版本
  4. Windows 版本使用 Windows 服务管理,而 Linux 版本使用 systemd 或 init.d

Q2: 如何在 Windows 上运行多个 Redis 实例? ​

A2: 可以通过以下步骤运行多个 Redis 实例:

  1. 复制 Redis 安装目录,如 C:\Redis 和 C:\Redis2
  2. 修改每个实例的配置文件,使用不同的端口(如 6379 和 6380)
  3. 修改每个实例的数据目录和日志文件路径
  4. 注册为不同名称的 Windows 服务,如 Redis 和 Redis2
  5. 分别启动每个服务

Q3: 如何迁移 Redis 数据? ​

A3: 可以使用以下方法迁移 Redis 数据:

  1. RDB 迁移:将源 Redis 的 RDB 文件复制到目标 Redis 的数据目录,重启目标 Redis
  2. AOF 迁移:将源 Redis 的 AOF 文件复制到目标 Redis 的数据目录,重启目标 Redis
  3. redis-cli 迁移:使用 redis-cli --pipe 命令进行数据迁移
  4. 第三方工具:使用 Redis-Shake、Redis-Migrate-Tool 等工具进行迁移

Q4: 如何备份 Redis 数据? ​

A4: 可以使用以下方法备份 Redis 数据:

  1. 手动备份:复制 Redis 的 RDB 和 AOF 文件到备份目录
  2. 自动备份:编写脚本定期备份 Redis 数据文件
  3. 云备份:将备份文件上传到云存储服务,如 AWS S3、Azure Blob Storage
  4. Redis 命令备份:使用 BGSAVE 命令创建 RDB 备份,使用 BGREWRITEAOF 命令重写 AOF 文件

Q5: 如何升级 Redis 版本? ​

A5: 可以按照以下步骤升级 Redis 版本:

  1. 备份当前 Redis 的数据文件和配置文件
  2. 下载新版本的 Redis 安装包
  3. 停止当前 Redis 服务
  4. 安装新版本的 Redis
  5. 恢复备份的数据文件
  6. 更新配置文件,合并新版本的配置选项
  7. 启动新版本的 Redis 服务
  8. 验证数据完整性和服务可用性