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 标签的版本,适合测试新功能
  • 架构:根据系统架构选择 x86x64 版本,推荐 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:\RedisC:\Redis2
  2. 修改每个实例的配置文件,使用不同的端口(如 6379 和 6380)
  3. 修改每个实例的数据目录和日志文件路径
  4. 注册为不同名称的 Windows 服务,如 RedisRedis2
  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. 验证数据完整性和服务可用性