在步入具体的部署步骤前,我们必须先厘清一个关键事实:Redis 官方自 3.2 版本后便停止了对 Windows 原生版本的直接维护 。官方推荐的部署操作系统始终是 Linux(如 Ubuntu、CentOS),因为在 Linux 下 Redis 能充分利用 epoll等多路复用 I/O 模型,性能表现最佳,且能完整支持如 fork进程相关的后台保存(RDB/AOF)机制。
然而,在现实开发场景中,许多.NET 开发者、Java 后端初学者或需要在本地进行快速调试的工程师,仍然有在 Windows(Win 10/11 或 Server)上运行 Redis 的需求。针对这一需求,目前社区主要有以下几种解决方案:
-
Windows 社区移植版 (如
tporadowski/redis):目前最主流的选择,基于 MS Open Tech 的代码继续维护,更新相对及时(目前已支持 Redis 7.x+)。 -
WSL2 (Windows Subsystem for Linux):在 Win 10/11 中安装一个完整的 Linux 子系统来运行原生 Redis,体验几乎等同于 Linux 生产环境,推荐给有一定基础的开发者。
-
Docker Desktop:通过容器化部署,环境隔离性好,适合熟悉 Docker 的开发者。
-
第三方商业/免费替代版(如 Memurai):完全兼容 Redis 协议的 Windows 服务,适合企业开发环境。
本文将以目前最通用的"社区移植版(Zip 免安装方式)"为核心主线,详细展开从下载、配置、注册服务到安全加固、远程连接的全流程,同时穿插 MSI 安装版、WSL2 等替代方案的要点,确保你不仅能"跑起来",还能"跑得稳"。
二、 部署方式选型与准备
1. 版本与资源选择
推荐前往 GitHub 上的社区维护仓库下载:https://github.com/tporadow**ski**/redis/releases。
-
文件格式选择:
-
.zip(如Redis-x64-7.2.x.zip):免安装绿色版。推荐选择!解压即可用,目录干净,便于配置修改和版本切换,也方便注册为系统服务。 -
.msi:Windows 安装包。会引导你设置端口、添加环境变量、甚至自动注册服务,适合不想敲命令的新手,但卸载和定制化不如 Zip 灵活 。
-
-
版本建议:选择最新的稳定版(如 7.2.x 或 6.2.x),避免下载到古老的 3.0/3.2 版本,以免缺失新特性或存在已知 Bug 。
2. 环境准备
-
路径规范 :准备一个无中文、无空格、无特殊字符 的目录,例如
D:\Develop\Redis或C:\Redis。这一点极其重要,错误的路径常导致配置文件加载失败或服务注册异常 。 -
权限准备:涉及服务安装和端口监听时,建议后续在"以管理员身份运行"的 CMD 或 PowerShell 中操作。
三、 核心部署实战(基于 Zip 免安装版)
第一步:解压与目录结构认知
将下载的 Zip 包解压到你准备好的目录(如 D:\Develop\Redis)。解压后的核心文件包括:
-
redis-server.exe:Redis 服务端启动程序(核心)。 -
redis-cli.exe:Redis 命令行客户端(用于执行命令测试)。 -
redis.windows.conf:Redis 核心配置文件(针对 Windows 控制台启动模式)。 -
redis.windows-service.conf:Redis 配置文件(针对 Windows 服务模式,部分版本合并共用)。 -
redis-benchmark.exe:性能基准测试工具。 -
redis-check-aof/rdb.exe:持久化文件修复工具 。
第二步:临时启动与验证(控制台模式)
在解压目录下按住 Shift + 右键,选择"在此处打开命令窗口"或 PowerShell,执行:
redis-server.exe redis.windows.conf
若一切正常,你会看到一个 ASCII 艺术风格的 Redis logo,并出现提示:Redis is now ready to accept connections on port 6379。
注意:此时这个窗口不能关闭,关闭即服务停止。这是临时调试模式。
验证连通性:
重新打开一个新 CMD 窗口,进入目录输入:
redis-cli.exe
127.0.0.1:6379> ping
PONG
127.0.0.1:6379> set test "hello windows"
OK
127.0.0.1:6379> get test
"hello windows"
看到 PONG和 OK即代表单机运行正常 。
第三步:注册为 Windows 系统服务(开机自启)
为了避免每次开机都要手动敲命令,我们需要将 Redis 注册为 Windows 后台服务。
- 以管理员身份打开 CMD,切换到 Redis 目录:
cd D:\Develop\Redis
-
执行服务安装命令(指定配置文件):
redis-server.exe --service-install redis.windows.conf --loglevel verbose
出现 Redis successfully installed as a service.即成功 。
-
启动服务:
redis-server.exe --service-start
或者按 Win + R输入 services.msc,找到 Redis 服务,右键启动,并将其启动类型设为"自动(延迟启动)"或"自动" 。
常用服务命令备忘:
-
停止服务:
redis-server.exe --service-stop -
卸载服务:
redis-server.exe --service-ununinstall
四、 核心配置文件详解(redis.windows.conf)
部署不仅仅是启动,合理的配置才能保证安全与稳定。用记事本或 VS Code 打开 redis.windows.conf:
1. 网络与连接配置
-
port 6379:默认端口。若本地有其他 Redis 或冲突,可改为 6380 等 。 -
bind 127.0.0.1:绑定 IP。默认只允许本机访问 。若需要局域网内其他机器(如同事的电脑或虚拟机里的应用)连接,需将其注释掉(加#)或改为bind 0.0.0.0(表示监听所有网卡)。 -
protected-mode yes:保护模式。若关闭了bind 127.0.0.1且没有设置密码,必须将此项改为no,否则 Redis 会拒绝外部连接。
2. 安全认证(密码)
requirepass foobared:默认被注释。取消注释,改为强密码,如requirepass Redis@2026!。生产环境必须开启,否则裸奔的 Redis 极易被攻击或植入挖矿脚本 。
3. 持久化配置(防止重启丢数据)
-
save 900 1/save 300 10/save 60 10000:RDB 快照策略。意思是 900 秒内 1 次改动则存盘,60 秒内 1 万次改动则存盘。 -
appendonly no:AOF 持久化开关。建议改为yes,尤其在 Windows 下,每次操作追加日志,宕机恢复数据更完整(但会稍影响性能)。 -
dir ./:数据存储目录。建议改为绝对路径,如dir D:/Develop/Redis/Data,并确保该文件夹存在,否则 RDB/AOF 文件可能不知道存哪儿或无权写入。
4. 日志配置
logfile "":日志文件路径。Windows 下可设为logfile "Logs/redis_log.txt",但务必提前在 redis 目录下手动创建Logs文件夹,否则服务可能因无法写日志而启动失败 。
修改配置后,必须重启 Redis 服务才能生效 (在服务管理器重启或执行 --service-stop然后 --service-start)。
五、 远程连接与防火墙设置
当配置好 bind 0.0.0.0和 requirepass后,从另一台电脑连接,可能仍不通,需检查 Windows 防火墙:
-
控制面板 -> 系统和安全 -> Windows Defender 防火墙 -> 高级设置。
-
入站规则 -> 新建规则 -> 端口 -> TCP -> 特定本地端口(填 6379)-> 允许连接 -> 完成,命名如 "Redis Port"。
-
若是云服务器(如阿里云/腾讯云 Windows 版),还需在云平台的安全组放行 6379 端口。
连接测试命令(在其他机器的 redis-cli 或工具中):
redis-cli -h 192.168.1.100 -p 6379 -a your_password
六、 可视化客户端与管理工具推荐
部署好后,命令行操作虽高效但不够直观,推荐几款优秀的 GUI 工具:
-
Another Redis Desktop Manager(强烈推荐):开源、免费、速度快、支持 SSH 隧道。下载地址:https://gitee.com/qishibo/AnotherRedisDesktopManager/releases。
-
RedisInsight:Redis 官方推出的可视化管理工具,功能极其强大(支持内存分析、慢日志、集群管理),但相对臃肿。
-
Redis Studio / QuickRedis:轻量级替代方案。
连接时填入 Host(IP)、Port(6379)、Password 即可浏览 Key 和内存占用。
七、 替代部署方案简述
1. 使用 WSL2 安装原生 Redis(推荐给进阶开发者)
Win 10/11 启用 WSL2 后,安装 Ubuntu,直接执行:
sudo apt update
sudo apt install redis-server
sudo service redis-server start
这种方式运行的 Redis 是纯正 Linux 版本,性能更好,配置文为 /etc/redis/redis.conf,更接近生产环境,且不会影响 Windows 本身的整洁 。
2. 使用 Docker
若安装了 Docker Desktop:
docker run --name my-redis -p 6379:6379 -d redis:alpine
一行命令即可运行,适合微服务调试 。
3. MSI 安装包方式
双击 Redis-x64-*.msi,一路 Next,勾选"Add to PATH"和"Install as service",安装完就能在 services.msc 看到运行中的 Redis,适合追求极速上手的用户 。
八、 常见问题与排错(Troubleshooting)
-
点击 redis-server.exe 闪退:
通常是因为未指定配置文件,或配置文件路径有误。建议在 CMD 中带配置路径启动看报错:
redis-server redis.windows.conf。 -
服务启动后立刻停止,报错误 1067:
大概率是
logfile或dir配置的路径不存在,或者redis.windows.conf编码非 ANSI/UTF-8 无 BOM 导致解析出错。检查路径文件夹是否存在。 -
外部连接不上,报 DENIED Redis is running in protected mode:
忘了关
protected-mode或没设密码就开放了bind 0.0.0.0。按第四章设置即可。 -
Redis 占用 CPU 高:
检查是否有死循环命令,或
save频率过高,亦或是 Windows 版在频繁刷盘,可适当调整持久化策略。
九、 结语
在 Windows 上部署 Redis 虽然并非官方首推路径,但通过社区移植版(tporadowski)依然能获得不错的开发和测试体验。本文详细梳理了从资源获取、免安装部署、系统服务注册、核心配置调优(网络/安全/持久化)、防火墙放行到可视化连接的全链路步骤。
对于个人学习、小型项目或本地开发调试,本文的主线方案(Zip + 服务注册)完全足够;若你追求极致的 Linux 生产一致性,WSL2 或 Docker 则是更优解。希望这篇指南能帮助你少踩坑,高效搭建起 Redis 环境。