外观
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 官方下载渠道
GitHub Releases:
- 访问 Redis Windows 官方仓库:https://github.com/tporadowski/redis/releases
- 选择最新的稳定版本,下载
.msi安装包(推荐)或.zip压缩包
Microsoft Archive:
- 访问:https://github.com/microsoftarchive/redis
- 注意:此仓库已停止维护,仅提供旧版本
1.2 选择合适的版本
- 稳定版:选择带有
stable标签的版本,如Redis-x64-5.0.14.msi - 预览版:带有
preview标签的版本,适合测试新功能 - 架构:根据系统架构选择
x86或x64版本,推荐x64
2. 使用 MSI 安装包安装
2.1 运行安装程序
- 双击下载的
.msi安装包,启动安装向导 - 点击 "Next" 进入许可协议页面
- 勾选 "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 完成安装
- 点击 "Install" 开始安装
- 等待安装完成
- 点击 "Finish" 退出安装向导
3. 使用 ZIP 压缩包安装
3.1 解压压缩包
- 右键点击下载的
.zip压缩包,选择 "Extract All..." - 选择解压路径,如
C:\Redis - 点击 "Extract" 完成解压
3.2 配置环境变量
- 右键点击 "此电脑",选择 "属性"
- 点击 "高级系统设置"
- 点击 "环境变量"
- 在 "系统变量" 中找到 "Path",点击 "编辑"
- 点击 "新建",添加 Redis 解压目录的路径,如
C:\Redis - 点击 "确定" 保存更改
配置 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-lru2.2 持久化配置
txt
# 启用AOF持久化
appendonly yes
# AOF文件名称
appendfilename "appendonly.aof"
# AOF同步策略:everysec(每秒同步)、always(每次写入同步)、no(由操作系统决定)
appendfsync everysec
# RDB持久化配置
save 900 1
save 300 10
save 60 100002.3 日志配置
txt
# 日志级别:debug、verbose、notice、warning
loglevel notice
# 日志文件路径,空表示输出到控制台
logfile "redis.log"3. 修改配置文件
- 使用文本编辑器(如 Notepad++、VS Code)打开配置文件
- 根据需要修改配置选项
- 保存文件
- 重启 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 notice1.2 启动服务
使用服务管理器:
- 按下
Win + R,输入services.msc,点击 "确定" - 在服务列表中找到 "Redis"
- 右键点击 "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.conf2.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
exit2. 检查 Redis 服务状态
bash
# 查看 Redis 服务状态
sc query redis
# 或使用 PowerShell
Get-Service -Name redis3. 查看 Redis 日志
- 日志文件位置:根据配置文件中的
logfile选项确定 - 使用文本编辑器打开日志文件,查看启动信息和运行状态
Redis 服务管理
1. 注册服务
bash
# 注册 Redis 服务
redis-server --service-install redis.windows-service.conf --loglevel notice2. 启动服务
bash
redis-server --service-start3. 停止服务
bash
redis-server --service-stop4. 卸载服务
bash
redis-server --service-uninstall5. 重命名服务
bash
redis-server --service-install --service-name Redis2 --port 6380常见问题
1. 端口被占用
- 症状:启动 Redis 服务时提示 "错误 1067:进程意外终止"
- 解决方案:
- 检查端口 6379 是否被其他进程占用
- 使用命令
netstat -ano | findstr :6379查看占用端口的进程 ID - 结束占用端口的进程,或修改 Redis 配置文件中的端口
2. 内存不足
- 症状:Redis 服务启动后自动停止,日志中出现 "Out of memory" 错误
- 解决方案:
- 增加系统内存
- 修改 Redis 配置文件中的
maxmemory选项,调整最大内存限制 - 优化 Redis 内存使用,如使用合适的数据结构、定期清理过期键
3. 服务无法启动
- 症状:使用
net start redis启动服务时失败 - 解决方案:
- 检查 Redis 日志文件,查看具体错误信息
- 确保配置文件路径正确
- 确保 Redis 安装目录有读写权限
- 尝试重新注册服务
4. 远程连接失败
- 症状:无法从远程机器连接到 Redis 服务器
- 解决方案:
- 确保 Redis 配置文件中的
bind选项设置为0.0.0.0 - 检查 Windows 防火墙是否允许 Redis 端口(默认 6379)
- 如果启用了密码认证,确保客户端提供了正确的密码
- 确保 Redis 配置文件中的
5. 数据持久化失败
- 症状:Redis 重启后数据丢失
- 解决方案:
- 检查 Redis 配置文件中的持久化选项是否正确配置
- 确保 Redis 有写入持久化文件的权限
- 检查磁盘空间是否充足
卸载 Redis
1. 从控制面板卸载
- 按下
Win + R,输入appwiz.cpl,点击 "确定" - 在程序列表中找到 "Redis"
- 右键点击 "Redis",选择 "卸载"
- 按照卸载向导的提示完成卸载
2. 手动卸载
2.1 停止并卸载 Redis 服务
bash
# 打开命令提示符(管理员权限)
# 停止 Redis 服务
net stop redis
# 卸载 Redis 服务
redis-server --service-uninstall2.2 删除安装文件
- 删除 Redis 安装目录,如
C:\Program Files\Redis - 删除 Redis 数据目录,如
C:\ProgramData\Redis(如果存在)
2.3 删除环境变量
- 右键点击 "此电脑",选择 "属性"
- 点击 "高级系统设置"
- 点击 "环境变量"
- 在 "系统变量" 中找到 "Path",点击 "编辑"
- 删除 Redis 相关的环境变量路径
- 点击 "确定" 保存更改
最佳实践
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.aof2. 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 相比,主要区别在于:
- Windows 版本的 Redis 性能略低于 Linux 版本
- 某些高级功能可能不被支持或实现方式不同
- Windows 版本的更新频率可能低于官方 Linux 版本
- Windows 版本使用 Windows 服务管理,而 Linux 版本使用 systemd 或 init.d
Q2: 如何在 Windows 上运行多个 Redis 实例?
A2: 可以通过以下步骤运行多个 Redis 实例:
- 复制 Redis 安装目录,如
C:\Redis和C:\Redis2 - 修改每个实例的配置文件,使用不同的端口(如 6379 和 6380)
- 修改每个实例的数据目录和日志文件路径
- 注册为不同名称的 Windows 服务,如
Redis和Redis2 - 分别启动每个服务
Q3: 如何迁移 Redis 数据?
A3: 可以使用以下方法迁移 Redis 数据:
- RDB 迁移:将源 Redis 的 RDB 文件复制到目标 Redis 的数据目录,重启目标 Redis
- AOF 迁移:将源 Redis 的 AOF 文件复制到目标 Redis 的数据目录,重启目标 Redis
- redis-cli 迁移:使用
redis-cli --pipe命令进行数据迁移 - 第三方工具:使用 Redis-Shake、Redis-Migrate-Tool 等工具进行迁移
Q4: 如何备份 Redis 数据?
A4: 可以使用以下方法备份 Redis 数据:
- 手动备份:复制 Redis 的 RDB 和 AOF 文件到备份目录
- 自动备份:编写脚本定期备份 Redis 数据文件
- 云备份:将备份文件上传到云存储服务,如 AWS S3、Azure Blob Storage
- Redis 命令备份:使用
BGSAVE命令创建 RDB 备份,使用BGREWRITEAOF命令重写 AOF 文件
Q5: 如何升级 Redis 版本?
A5: 可以按照以下步骤升级 Redis 版本:
- 备份当前 Redis 的数据文件和配置文件
- 下载新版本的 Redis 安装包
- 停止当前 Redis 服务
- 安装新版本的 Redis
- 恢复备份的数据文件
- 更新配置文件,合并新版本的配置选项
- 启动新版本的 Redis 服务
- 验证数据完整性和服务可用性
