开头Windows 上部署 Redis 这件事我实在是太有发言权了。早几年业务规模还没那么大公司测试环境都是 Windows 服务器每次服务器重启之后开发同事就默契地在群里喊一声“Redis 挂了谁去开一下”。一开始我也觉得这是小事双击 redis-server.exe 就完事直到一次坑了我很惨的经历——预发环境的 Redis 被机房重启带走依赖 Redis 的服务全链路报错一大早就被连环电话叫醒。我后来花了一整天把 Windows 下 Redis 的安装、配置、服务注册、开机自启动这条链路彻底摸了一遍从那以后不管换几台 Windows 服务器我都有标准的操作模板可以直接套。这篇博文就专门讲这套流程从下载合适的 Redis Windows 版本、调整配置文件参数到用redis-server注册成 Windows 服务再到用sc config把服务改成自动启动最后附上我每次部署都会踩一遍的坑和排查思路。不是泛泛的介绍是我实际操作过、在好几台服务器上验证过的步骤按照这个顺序来基本可以做到“装完就安心重启”。1. 为什么 Windows 上跑 Redis麻烦总在“自启动”这一步1.1 Windows 没有官方安装包这件事Redis 官方一直没做 Windows 原生的安装包官方文档里推荐的是 Linux 环境。Windows 上用的版本基本都是某团队维护的移植版大多以 ZIP 压缩包形式分发。这意味着你没有办法像装其他软件那样双击下一步下一步所有文件就是解压到一个目录里手动运行 EXE。很多人第一次接触 Redis on Windows都是从双击目录里的redis-server.exe开始的窗口会直接在前台输出一堆日志Redis 就这么跑起来了。如果你只是本地开发调试这种做法完全够用。但一旦你想把它变成一台服务器上的基础服务问题就来了这个前台窗口依赖用户登录窗口一关 Redis 就没了系统重启之后窗口不会自己弹出来你也不可能要求运维同事每次重启之后都要远程桌面登录然后双击一次。所以 Windows 上部署 Redis 的第一要务不是“怎么让它跑起来”而是“怎么让它不依赖人为操作就自己跑起来”。这就要靠 Windows 服务机制和自启动配置来解决。1.2 “手动能跑”和“开机自动跑”是两码事我见过不少人觉得“反正我能跑起来就行”结果每次服务器重启后 Redis 就是不在线。原因很简单你手动双击启动的 Redis是跑在你自己登录会话里的普通进程它不会因为你注销登录就继续存在更不会在机器开机后自动被拉起。Windows 上想让一个程序在开机后自动运行常规思路有这么几种把快捷方式丢进启动文件夹、用任务计划程序创建开机任务、注册成 Windows 服务。这三条路我实测下来最稳的就是注册成 Windows 服务。启动文件夹方式依赖登录用户服务器一般不会自动登录任务计划程序设置得当也能用但权限、触发器、延迟启动这些细节比服务方式更容易出幺蛾子Windows 服务完美契合服务器场景开机时由服务控制管理器统一拉起不依赖用户是否登录还可以设置“如果服务失败自动重启”。Redis 的 Windows 移植版本身就内置了服务注册机制redis-server.exe这个文件自己就能注册、启动、停止服务不需要额外装工具这也是我优先推这种方式的原因。1.3 注册服务前必须调整的认知这里要先打个预防针把 Redis 注册成服务之后它就不再是你双击启动的那个前台进程了。日志不会直接刷在窗口里配置文件路径、工作目录、参数传递都会有些差别。我刚开始折腾的时候就因为在服务模式下传错了参数导致 Redis 服务一直在“启动-失败-回滚”的状态里来回跳查了好久才明白问题出在哪。后面我会在实操部分专门把这些参数讲清楚。2. 动手之前的准备工作版本选型与文件确认2.1 版本怎么选才不会踩坑Windows 版 Redis 的版本节奏一直比 Linux 落后一点所以没必要追求“最新”。版本太老缺少一些比较现代的特性比如部分命令的语义都不太一样版本太新又可能因为 Windows 移植不稳定反而把自己坑进去。我的建议是基于 5.x 或 6.x 系列这两个系列功能稳定网上能搜到的踩坑案例也最全出了问题容易找到解决方案。下载的时候注意选 ZIP 压缩包别选带 MSI 字样的东西。我印象里某些 MSI 安装包有捆绑行为安装完还要改启动项非常不推荐。2.2 解压之后目录里哪些文件有用下载完是一个 ZIP 压缩包解压后你会看到一堆文件甭管文件多杂真正有关系的就是下面这几个文件作用redis-server.exe服务端主程序也是后面注册服务的入口redis-cli.exe命令行客户端用来验证服务是否正常redis.windows.conf标准配置文件手动跑通常加载它redis.windows-service.conf服务模式专用配置文件注册服务时要用它redis-benchmark.exe性能测试工具日常用不上这里有个关键细节服务模式下不要用redis.windows.conf要用redis.windows-service.conf。这两个文件默认内容基本一致但服务模式的版本对后台运行更友好。我第一次图省事直接改了通用的配置文件结果注册服务时参数解析出了幺蛾子。稳妥做法就是把redis.windows-service.conf当作唯一配置文件来维护。另外解压目录的路径最好保证是英文、没有空格。如果你的目录是C:\Program Files\Redis\这种带空格的路径注册服务的时候命令行解析会出现一些你想不到的坑。我的习惯是直接放在C:\tools\Redis这种纯英文路径下面能避免后面很多麻烦。2.3 配置文件里最重要的三处调整不管用哪个配置文件安装前至少要把下面三个参数改好这三处是生产环境能不能稳定跑起来的关键。第一bind参数。默认配置里 bind 是127.0.0.1意味着只有本机能连。如果是给本机应用提供服务这个反而是安全配置我就这么留着如果需要局域网内其他机器访问得改成0.0.0.0。但改之前要想清楚暴露到网络上就意味着必须配合密码保护否则别人也能连你的 Redis。第二requirepass参数。这个就是 Redis 密码默认是注释掉的等于没有密码。本地开发无所谓但服务器上一旦绑定了非本机地址密码几乎必须设置。设密码时注意密码不要有特殊字符比如$、这些字符在某些命令行解析场景下会出问题。第三dir参数。这个表示 Redis 持久化文件写到哪个目录默认值通常是解压目录。Windows 下如果解压目录在系统盘且权限控制严格RDB 快照保存时可能没有写权限直接导致持久化失败。我一般会单独建一个数据目录比如C:\data\redis把 dir 指向它权限干净备份也方便。3. 完整实操从安装到开机自启动一气呵成3.1 以管理员身份打开命令提示符这一步真的不能省。注册 Windows 服务涉及系统服务控制管理器普通权限的命令行根本没有权限操作。你右键点击“命令提示符”或“PowerShell”选择“以管理员身份运行”。拿到管理员窗口后先确认目录切到 Redis 解压所在的位置比如cd /d C:\tools\Redis如果路径里带空格记得用引号包住整个路径。这一步成功后窗口里输入命令后续操作才顺畅。3.2 用 redis-server 注册为 Windows 服务关键命令就是这一条后面所有的自启动基础都建立在这条命令上redis-server --service-install redis.windows-service.conf --service-name Redis --service-alias Redis --loglevel verbose简单拆解一下参数的含义--service-install是让 redis-server 把自己注册成一个 Windows 服务redis.windows-service.conf指定服务启动时加载的配置文件--service-name Redis服务显示名称建议就叫 Redis简单直观--service-alias Redis服务别名一般和名称保持一致就行--loglevel verbose启动日志级别部署初期建议开详细一点排查问题方便运行完后如果显示类似服务已成功安装的信息就说明注册成功了。这时候打开“服务管理器”或运行services.msc就能在服务列表里看到 Redis 这个服务。这里有个很容易被忽略的点服务安装成功后默认状态是停止的而且启动类型默认是“手动”。也就是说你现在还没完成“自动启动”的关键配置需要接着往下做。3.3 设置服务为自动启动注意 sc 命令的隐藏规则注册完服务后我的习惯是用sc命令设置启动类型为自动命令如下sc config Redis start auto这里要敲黑板提醒start后面必须有一个空格再写auto。这是 Windowssc命令的一个历史遗留怪癖如果你写成startauto命令执行会直接报参数错误。我第一次用的时候在这个地方卡了好久一直以为是自己命令拼错了后来才搞明白是空格问题。执行完可以再用sc qc Redis查看配置确认START_TYPE那一栏是AUTO_START这样就确保服务在操作系统启动的阶段就会自动拉起不依赖任何人登录机器。3.4 启动服务并验证 Redis 是否正常工作设置完自动启动后先手动启动服务一次确认配置没问题redis-server --service-start --service-name Redis启动成功后用客户端工具验证一下 Redis 能不能正常响应redis-cli -h 127.0.0.1 -p 6379 ping如果返回PONG说明 Redis 服务已经在运行并且客户端能连上。如果你在配置文件里设置了requirepass那客户端连接时需要带上密码redis-cli -h 127.0.0.1 -p 6379 -a yourpassword ping有人会问为什么要做这步验证而不是直接等着重启机器看效果。我的经验是先确认服务在当前状态下能正常启动、能正常响应再考虑自启动问题。如果服务本身起不来你自启动配得再对也没用到时候重启完再排查反而要手忙脚乱。3.5 修改配置文件后如何平滑重启服务部署之后改配置是少不了的这里提供一个我常用的重启套路。假设你改了redis.windows-service.conf中的参数想让配置生效需要重启服务redis-server --service-stop --service-name Redis redis-server --service-start --service-name Redis这个写法和直接进服务管理器里点“重启”效果一样但好处是可以在命令行里一键执行。如果想在重启前后检查配置是否被正确加载可以在停服务之前先redis-cli config get maxmemory看一下当前生效值然后再停、改配置、启动、再看生效值这样可以很直观地确认配置载入情况。需要注意用刚才那个服务方式注册后服务就归属于 Windows 服务控制管理器管理了不要再用 redis-cli 的shutdown命令去关服务否则服务控制管理器识别的状态可能会混乱。4. 常见问题排查与避坑笔记4.1 6379 端口被占用Redis 服务一直起不来我遇到最多的状况不是服务安装失败而是服务能注册但根本启动不了一看日志还是端口问题。因为 Redis 默认监听 6379如果机器上已经有别的进程占用这个端口或者之前有一个手动双击启动的 Redis 进程还在跑服务就起不来。处理方式分两步。先找出什么占用了端口netstat -ano | findstr 6379看到 PID 之后再到任务管理器里根据 PID 找到具体进程。如果那个进程是之前手动启动的 Redis直接在命令行里结束掉它然后再次启动服务。如果占用的不是 Redis而是另一个业务程序那你需要考虑换一个端口或者在配置里把 Redis 的端口改掉。我的习惯是部署前就先执行一遍netstat -ano | findstr 6379确认端口空闲再注册服务。这个习惯帮我省了非常多事后救火的精力。4.2 服务明明“正在运行”但客户端连接总是失败还有一种情况非常隐蔽服务状态显示正在运行但redis-cli ping怎么都连不上。这种情况首先要检查bind配置。如果你把 bind 设成了127.0.0.1然后用redis-cli -h 192.168.x.x这种方式访问自然会失败因为 Redis 只监听了本机回环地址。其次是防火墙。Windows 服务器上默认防火墙策略可能挡住 Redis 监听端口即使 Redis 本身没问题外部也访问不了。要么在防火墙入站规则里放行 6379 端口要么限制访问来源 IP看你的安全要求。还有一个更隐蔽的原因是 Redis 配置文件里设置了maxclients一个偏小的值连接数满了之后新连接会被拒绝。这个在测试环境很少遇到但生产环境并发一多就很容易触发。排查时可以先redis-cli -h 127.0.0.1 -p 6379 info clients看当前连接数再对比配置中的maxclients。4.3 配置了 requirepass 之后服务启动报错如果你在命令行启动服务时既在配置文件里写了requirepass又在命令行参数里也带了一个密码两者不一致时可能出现验证混乱。Windows 服务模式下redis-server 读取服务注册时的参数如果注册命令没带密码那密码就完全来自配置文件这个其实是最干净的方式。我建议密码只放配置文件注册服务时不要通过命令行传密码。这样将来想改密码只动配置文件再重启服务就行。命令行传密码还要重新注册服务多一层麻烦而且密码会暴露在进程样本里安全上也不划算。4.4 重启后 Redis 没自动起来先检查这两项确认服务已经设置了自启动但系统重启后 Redis 仍然没起来这个问题我排查过好几回绝大多数原因出在这两个地方。第一服务登录账号问题。默认情况下服务是以本地系统账号运行的这个账号权限比较宽一般不会影响启动。但如果你手动改过服务的登录身份为某个普通用户而这个用户没有对应权限服务就可能启动失败。需要到服务管理器中确认 Redis 服务的登录属性是“本地系统账户”。第二服务启动失败后的恢复动作。Windows 服务有一种“失败后自动重启”的配置在服务属性的“恢复”标签页里可以设置。三次失败后可以配置为“重新启动服务”。这个对 Redis 这种无状态异常恢复场景很实用。我还会在“恢复”页面把失败计数器重置周期调短一点避免重启次数过多触发跳闸逻辑。如果还是没起来那就看 Windows 事件查看器在“Windows 日志-系统”里筛选来源为 Redis 的报错记录通常能给出具体失败原因。4.5 常见问题速查表现象可能原因解决思路服务安装成功但不能启动端口被占用netstat -ano查占用进程释放端口服务在运行但客户端连不上bind 或防火墙检查 bind 地址放行防火墙设置了密码后启动失败命令行参数与配置文件密码不一致密码只写在配置文件中重启后 Redis 没起来启动类型未设置自动sc config Redis start auto日志级别为空服务路径带空格解压目录改纯英文无空格路径RDB 持久化失败dir 目录无写权限单独建数据目录并授权5. 更进一步多实例、迁移与监控5.1 一台机器开多个 Redis 实例有些场景一台 Windows 服务器上要跑多个 Redis 实例比如不同业务隔离。思路是复制一份 Redis 目录或者共用一份程序文件用不同的配置文件和端口来区分。每个实例都要单独注册一个服务服务名称不能重名。命令大致这样redis-server --service-install redis-master.conf --service-name Redis6380 --service-alias Redis6380注意每个实例的配置文件里port、dir、logfile都要改成独立的值避免互相覆盖。我实际操作中还会把实例的启动类型也设置成 auto不然一旦重启实例状态就乱了。这里有个细节多个实例注册时建议每个实例的--service-name和--service-alias都带端口后缀比如Redis6380这样在服务管理器里一目了然排查问题的时候不用猜。5.2 把程序目录和数据目录分开这个属于进阶好习惯。程序文件就放在C:\tools\Redis数据文件和日志放在C:\data\redis。配置文件里dir指向数据目录RDB、AOF 这些持久化文件都写到数据目录。好处是系统崩溃重装只需要保留数据目录重新注册服务就行数据不丢恢复也快。另外可以顺手把数据目录加入文件索引排除列表或杀毒软件白名单。我遇到过杀毒软件把 Redis 的 RDB 快照文件当成可疑文件锁定的情况当时排查到崩溃最后才发现是安全软件在捣乱。5.3 健康检查小脚本的思路服务部署完之后我建议再配一个最小化的健康检查计划任务用 redis-cli 检查服务是否存活否则自动重启。思路大致是写一条命令或者一个脚本文件内容就是redis-cli -h 127.0.0.1 -p 6379 ping如果返回的不是PONG就执行redis-server --service-start --service-name Redis。然后把这个脚本挂到 Windows 任务计划程序里每 5 分钟执行一次。这个完全依赖服务本身的自动重启功能也可以但我偏好多做这一步因为服务和进程“活着”不代表 Redis 能正常读写。有一次内存满了Redis 进入保护模式直接拒绝写入服务本身还显示在运行如果只看服务存活是完全蒙在鼓里的。有健康检查就能在第一时间发现问题并重启服务。我个人实际部署中的体会有两条一是注册服务前一定把配置文件和目录规划好别急着双击跑起来注册后调整比注册前麻烦得多二是每改一次配置文件都用redis-cli config get验证一下实际生效的值别只看配置文件里的内容就以为改好了。Windows 下 Redis 自启动这条路踩过一次坑之后后面每次部署其实都是按部就班的事情。希望这篇记录能让你少走一点弯路至少在服务器重启的清晨不用再被连环电话喊醒。