先说点实际的。Redis 官方其实一直不提供 Windows 原生安装包所以“redis7 for windows的安装教程”这个需求十个人里有九个会先卡在“去哪下载”“下了哪个版本”“怎么配置才能跑起来”这三件事上。这篇文章我不打算只丢给你一个压缩包链接就完事我先把 Windows 上能跑 Redis 7 的几条路线全捋一遍再手把手演示最常用的 ZIP 解压版、WSL 版和 Docker 版三种安装方式最后把调试和排坑过程也一起写上。无论你是只想要个本地缓存环境还是要用 Redis 7 的新特性做开发联调这篇文章都够用了。我最早在 Windows 上装 Redis 还是 3.x 时代那时候就两个选择要么用微软改的社区版要么自己在 Linux 虚拟机里折腾。到了 Redis 7.0 之后可选择的方案一下多了不少但也带来新的困惑——版本太多反而不知道哪个靠谱。下面先从背景讲起再逐个上实操。1. 先说清楚为什么 Windows 上装 Redis 7 总是这么折腾1.1 官方没有原生包Windows 生态全靠社区接力Redis 官方从立项开始就主要面向 POSIX 系统代码里大量用到了fork()、epoll这类 Linux 专属机制。Windows 上没有完全对等的东西官方也没有动力去维护一份 Windows 编译分支。所以你在 redis.io 官网下载页是找不到redis-7.x.msi这类安装包的官方文档里对 Windows 的态度一直是“可以用 WSL 跑”。那 Windows 上的 Redis 是怎么来的主要是三个来源微软开源技术组早年维护的microsoftarchive/redis分支但停在 Redis 5.0.14 就不再往前走了。第三方开发者把 Redis 7.0 交叉编译成 Windows 可执行文件最常见的是tporadowski在 GitHub 上发布的 ZIP 包。通过 WSL2 或 Docker Desktop 等虚拟化方案在 Windows 里跑真正原生的 Linux 版 Redis。很多人一搜“redis windows 下载”会误以为自己下载的是官方版本结果拿到的要么是老掉牙的 5.x要么是来路不明的第三方编译包。这里建议你先确定自己的目标只是本地学一学、当缓存用用那选择第三方的 Windows 原生版完全没问题如果是作为团队协作环境或者接近生产场景我会建议 WSL 或 Docker因为版本更新、行为也和线上 Linux 一致。1.2 四条路线的优缺点对比我在不同项目里试过所有主流方案简单做个对比方便你按场景选方案优点缺点适合场景ZIP 解压版tporadowski 等第三方编译下载快、双击即用、占用小版本落后官方停留在 7.0.x不够“原生”本地快速体验、临时工具WSL2 apt 安装官方推荐、生态一致、升级方便需要启用虚拟化平台内存占用偏高日常开发、学习、需要贴近 Linux 行为Docker Desktop 容器环境隔离、部署方式接近生产、可随意切换版本依赖 Docker启动较慢多版本切换、微服务联调Memurai兼容 Redis API、原生 Windows 服务商业授权问题免费版有限制需要 Windows 原生服务且对稳定性要求高的团队我个人的原则很简单自己玩用 ZIP 解压版 WSL 双保险工作项目尽量容器化。下面分别讲具体装法。2. 方案一ZIP 解压版最省事的民间编译版2.1 下载与解压redis-server.exe 直接双击之前先看一眼这个是绝大多数新手最容易上手的路径。去 GitHub 搜tporadowski/redis在 Releases 页面找到最新版本下载 ZIP 包。解压后你会看到一堆文件核心是这几个redis-server.exe——服务端程序redis-cli.exe——命令行客户端redis.windows.conf——Windows 用的配置文件redis.windows-service.conf——注册 Windows 服务用的推荐配置解压路径建议放在纯英文目录下比如D:\redis7。我之前见过有人把 Redis 放到C:\Program Files\...带空格和中文的路径里注册服务时各种报错后来换目录就好了。启动之前先做一件事打开redis.windows.conf确认port 6379这行没有被注释。Redis 默认监听 6379 端口第一次启动没必要改端口除非你本地已有服务占用。确认后直接在解压目录开一个 CMD 或 PowerShell执行.\redis-server.exe .\redis.windows.conf看到输出里有下面这几行就算启动成功了* Ready to accept connections tcp注意这个过程是前台运行的也就是说你把这个终端关掉Redis 就停了。要想让它一直待在后台不想每次手动开终端……下个小节我会讲服务注册。还有一件事易忽略redis-server.exe不指定配置文件也能启动此时相当于默认配置而且它会在当前目录尝试找dump.rdb做持久化。所以一定要显式指定配置文件否则你改了redis.windows.conf里的密码、端口、持久化策略全部不会生效。2.2 用 redis-cli 验证一次完整联调服务启动后另开一个终端进入 Redis 目录执行.\redis-cli.exe -p 6379 ping如果返回PONG说明服务端和客户端已经通了。接下来可以顺手验证一下 Redis 7 的标志性功能比如 ACL 用户体系。先用默认用户尝试一条命令.\redis-cli.exe 127.0.0.1:6379 set hello world OK 127.0.0.1:6379 get hello world到这里ZIP 版安装就完成了整个流程不到五分钟。但如果你后续重启了电脑会发现 Redis 没自动跑起来。这就引出了服务注册。2.3 把 Redis 注册成 Windows 服务开机自启以管理员身份打开 CMD 或 PowerShell进入 Redis 目录执行.\redis-server.exe --service-install .\redis.windows-service.conf --service-name Redis7 --loglevel verbose这里--service-name是给服务起个名字默认是 Redis我建议改成 Redis7 方便和旧版本区分。注册成功后打开服务管理器services.msc能看到 Redis7 这个服务把启动类型改成“自动”然后手动点“启动”。之后如果修改了配置文件想让它生效可以这样重启服务net stop Redis7 net start Redis7踩坑提醒--service-install必须以管理员权限运行否则报“拒绝访问”。还有如果注册时指定的配置文件路径写的是相对路径服务启动时可能因为当前工作目录不对而找不到配置干脆用绝对路径.\redis-server.exe --service-install D:\redis7\redis.windows-service.conf --service-name Redis7卸服务时对应的是.\redis-server.exe --service-uninstall --service-name Redis73. 方案二WSL 里的官方正版体验3.1 启用 WSL 并安装发行版如果你电脑是 Win10 2004 或 Win11装 WSL2 是几分钟的事。管理员 PowerShell 里执行wsl --install默认会装 Ubuntu并启用 WSL2 虚拟机平台。装完重启按提示设置 Linux 用户名密码。这里有个小坑WSL 默认网络是 NAT 模式但 Windows 会自动做 localhost 转发也就是说你从 Windows 侧访问 WSL 里的 Redis直接用127.0.0.1:6379就行不用专门记 WSL 的 IP。3.2 apt 安装 Redis 并处理 systemd 问题Ubuntu 的 apt 源里有 Redis但版本可能不是最新的。如果想装 Redis 7.x推荐用官方提供的 PPAsudo apt update sudo apt install -y redis-server装完后检查版本redis-server --versionUbuntu 22.04 官方源里配的已经是 Redis 7.0 了如果你需要更新的小版本比如 7.2、7.4可以加ppa:redislabs/redissudo add-apt-repository ppa:redislabs/redis sudo apt update sudo apt install redis-server启动方式上有个 WSL 特有的坑WSL2 默认不跑 systemd除非你在/etc/wsl.conf里手动开启所以systemctl start redis-server大概率会报错。正确姿势是用 service 命令sudo service redis-server start然后看状态redis-cli ping同样返回PONG就完成任务了。如果用的 Ubuntu 22.04 以上版本且开启了 systemd也可以用systemctl enable --now redis-server但service方法最不会出错。3.3 从 Windows 侧访问 WSL 里的 Redis前面提到 localhost 转发正常情况下你在 Windows 的 PowerShell 里执行redis-cli -p 6379 ping会得到PONG。前提是你 Windows 上也装了 redis-cli或者直接用wsl redis-cliwsl redis-cli如果在 Windows 侧的开发工具比如 Java、Go、Python 程序里连localhost:6379同样能通。这个方案适合日常开发因为 WSL2 里跑的是官方 Linux 版和你服务器上的行为完全一致调试缓存失效、Lua 脚本、ACL 这些问题不会出现“本地好好的上服务器就怪怪的”情况。特别提醒WSL2 的 localhost 转发对宿主机访问没什么问题但局域网内其他机器访问 WSL 里的 Redis 需要额外端口转发配置这个比较复杂建议需要局域网访问时用 Docker 或 Windows 原生方案。4. 方案三Docker Desktop 拉镜像跑容器4.1 Docker 部署 Redis 的完整命令如果你的开发环境本来就装了 Docker Desktop那 Running Redis 是三个方案里最干净的一个。因为 Docker 镜像里的 Redis 就是官方原版版本想换就换想停就停对 Windows 主机没有依赖。安装 Docker Desktop 后直接执行docker run -d --name redis7 -p 6379:6379 redis:7如果本地没有redis:7镜像Docker 会自动从镜像仓库拉取。执行完这条命令Windows 侧就能通过localhost:6379访问容器里的 Redis。验证一下docker exec -it redis7 redis-cli ping返回PONG即成功。要限制内存可以在 run 的时候加参数docker run -d --name redis7 -p 6379:6379 --memory512m redis:7 --maxmemory 256mb注意命令格式--memory是容器内存限制--maxmemory是 Redis 自身能用的最大内存。这里的redis:7镜像默认配置不会开启持久化如果你要留着数据得用下面的方式挂载持久化目录和配置文件。4.2 挂载配置文件与数据目录要注意的问题我建议把配置和数据都落到宿主机这样容器删了也不慌。假设在D:\docker-data\redis7下建两个子目录conf和datamkdir D:\docker-data\redis7\conf mkdir D:\docker-data\redis7\data然后准备一个redis.conf放到conf目录下内容至少包含appendonly yes appendfilename appendonly.aof dir /data启动命令改成docker run -d --name redis7 \ -p 6379:6379 \ -v D:/docker-data/redis7/conf/redis.conf:/etc/redis/redis.conf:ro \ -v D:/docker-data/redis7/data:/data \ redis:7 redis-server /etc/redis/redis.conf这里容易出两个问题一是 Windows 路径需要写成D:/而不是D:\Docker 对反斜杠的处理不够友好二是dir /data必须和容器内挂载路径严格对应否则 RDB 或 AOF 文件会写到一个容器重启就丢的临时目录里。Docker 方案对我来讲最大的价值在于版本切换成本极低。今天用redis:7.2明天用redis:7.4只要改一下标签重新 run 就行Windows 上没有任何残留。5. 方案四Memurai——面向生产环境的商业备选5.1 Memurai 适合谁如果公司强制要求在纯 Windows 服务器上提供 Redis 兼容服务且不想引入 WSL 或 Docker 这两层虚拟化Memurai 可能是最接近“官方体验”的选项。它是一个完全跑在 Windows 上的 Redis 兼容服务支持 Redis 7 的主要 API并且能注册为 Windows 原生服务、通过 SC 命令管理。安装过程就是下载一个 MSI 安装包一路 Next 就行。启动服务、连接方式都和 Redis 一致memurai-cli ping不过要提醒一句Memurai 的商业授权是需要费用的免费版有容量或功能限制。我个人只在给客户做纯 Windows 环境交付时用过它日常开发完全没必要上这个ZIP 版或 Docker 就够了。6. 别急着跑先把这个配置文件调明白6.1 必改的几个参数bind、protected-mode、requirepass不管是哪个方案Redis 7 有一组参数你一定绕不开它们在默认情况下可能埋雷。第一个是protected-mode。Redis 7 默认是protected-mode yes如果没设置密码同时监听地址是0.0.0.0那局域网内所有机器都能裸连一旦被扫描到你的 Redis 就会被脚本入侵写挖矿程序。这个我在踩坑记录里见过太多回了。第二个是bind。默认只绑127.0.0.1这意味着本机以外的机器都无法连接。如果你只是本地开发保持默认就行如果是开发服务器或测试机需要明确绑定内网 IP 并开启密码。我建议默认情况下什么都别动按需打开。第三个是requirepass。Redis 7 里更强的是 ACL但新手阶段直接设一个密码最省事。编辑配置文件加一行requirepass your-strong-password设置后redis-cli连接时需要先认证redis-cli -a your-strong-password或者连接后执行AUTH your-strong-password安全建议说得直接一点只要 Redis 监听地址不是 127.0.0.1就必须开启密码否则和裸奔没有区别。6.2 持久化与内存上限别忽略Redis 本质是内存数据库进程一退内存里的数据就没了。Redis 7 提供两种持久化机制RDB按时间点做全量快照默认开启适合缓存场景。AOF按操作日志追加记录可配置每次都同步或每秒同步数据丢失窗口更小。开发环境默认 RDB 就够了但如果你在上面存了会话状态、临时验证码这类不希望丢的数据建议打开 AOFappendonly yes appendfsync everysec内存上限也是容易被忽略的一项。默认 Redis 不限制内存会一直把系统的内存吃满直到触发 swap 或者进程被系统杀。开发机上随手设置一个上限更安全maxmemory 256mb maxmemory-policy allkeys-lruallkeys-lru表示内存满时按 LRU 淘汰最近最少使用的 key这是最常见的缓存策略。6.3 多实例部署与 ACL 基础Redis 7 的多实例习惯其实很常见一个端口 6379 做缓存一个端口 6380 做队列两个实例可以共用一份配置风格。在 Windows 上用 ZIP 版时复制整个目录改一下配置文件里的port和dir分别注册成不同服务名就行。ACL 是 Redis 6 开始引入、7.0 里非常完善的一套用户权限体系它可以替代传统的requirepass。举个最简单的例子创建一个只能读写指定前缀 key 的用户ACL SETUSER appuser on app-password ~cache:* read write这样即使密码泄露用户也不能执行FLUSHALL、KEYS *这类破坏性命令也不能访问cache:前缀以外的数据。真正做多应用共享 Redis 时强烈建议用 ACL 代替通用密码。关于 ACL 和requirepass的关系默认的default用户密码就是requirepass设置的值。如果你配置了 ACL 用户旧的requirepass仍然只作用于default用户两者不冲突但管理起来建议统一走 ACL。7. 常见问题与排查实录7.1 端口 6379 被占用启动redis-server.exe时如果报了bind: Address already in use或者服务启动后怎么都连不上先看端口谁在占用。Windows 下用netstat -ano | findstr 6379查到一个 PID 后到任务管理器确认进程如果不是重要任务直接taskkill /PID 12345 /F再把 Redis 启动起来。还有一种情况是你以前安装过老版 Redis 并注册成了 Windows 服务开机自动占用了 6379那就先用redis-server --service-uninstall把旧服务清掉。7.2 客户端连不上三个最常见的死法第一种是Windows 防火墙拦了。如果你从局域网另一台机器连 Windows 上的 Redis连不上基本就是防火墙挡了 6379。临时放行netsh advfirewall firewall add rule nameRedis6379 dirin actionallow protocolTCP localport6379第二种是Redis 配置了只监听 127.0.0.1。这个从客户端角度很不好分辨因为本机连是通的远程连就不通。排查时先看配置文件里的bind再考虑是否要改成内网 IP。不要改成0.0.0.0还开了保护模式否则必须配合密码使用。第三种是redis-cli 连接时没有带密码。表现是NOAUTH Authentication required。这时执行AUTH 密码再操作即可。如果是程序连接检查连接字符串里有没有配密码。还有一个 Win11 上容易遇到的坑Hyper-V 防火墙规则。如果你开了 WSL2 或 Docker它们的虚拟交换机可能影响端口转发表现是 Docker 端口映射明明写了6379:6379Windows 本机却访问不到。先把 Docker Desktop 的“Use the WSL 2 based engine”关掉再重启试试或者直接把端口映射改成127.0.0.1:6379:6379来规避。7.3 服务注册失败与开机不启动ZIP 版本用--service-install注册服务时最容易遇到以下报错报错信息原因处理方式Failed to install service没有管理员权限用管理员身份重开终端Access is denied同上或杀毒软件拦截关闭杀软后重试Service Redis7 (Redis7) failed to start配置文件路径不对或配置有语法错误用redis-server D:\redis7\redis.windows.conf前台启动看报错服务启动了但连不上配置里绑定的是别的端口检查配置port和实际连接的端口还有一种常见情况是你手动注册了一个名为 Redis 的服务后来卸载、更新版本时旧服务没删干净导致新版本怎么都起不来。这时候用sc query和sc delete把旧服务清理干净再重新注册sc query Redis7 sc delete Redis77.4 图形化客户端和连接测试的小工具命令行用redis-cli够用但可视化查看 key、分析内存占用时图形客户端效率高很多。我日常用两款RedisInsightRedis 官方出品的跨平台客户端支持 Redis 7 的 ACL、慢日志、命令监控强烈推荐。Another Redis Desktop Manager老牌开源轻量连接管理方便。本地连通性测试其实不需要装额外工具。Windows 上可以直接用 PowerShell 的Test-NetConnectionTest-NetConnection -ComputerName 127.0.0.1 -Port 6379返回TcpTestSucceeded : True说明端口通否则就是服务没起来或防火墙在拦。排查顺序建议是先redis-cli ping看服务状态再看端口监听最后看防火墙。最后说一点我个人实践下来的经验玩 Windows 上的 Redis 这么多年我的体会是别在“哪个版本更纯正”上纠结太长时间先保证跑起来、数据不丢、端口不乱开后面慢慢优化就来得及。如果你只是自己开发调试ZIP 解压版是性价比最高的选择用 Docker 做版本切换作为补充如果你的项目上了服务器直接记牢 WSL2 里service redis-server start这个命令就够了。最后再分享一个小技巧不管是哪种方式装的 Redis拿到手第一件事先执行CONFIG REWRITE把当前运行参数同步回配置文件这样下次启动时的实际行为和你预期完全一致很多“玄学报错”都是配置文件和运行参数不一致引起的。