前阵子帮同事在一台 Windows10 的测试机上把 redis 跑起来本来以为是十分钟的事结果从下载安装包到能稳定连上中间踩了四五个坑。Redis 这个数据库天生是给 Linux 环境设计的官方从 3.0 之后就再没出过 Windows 原生支持所以Windows10安装redis这件事的本质不是双击一个安装包就完事而是一次方案选择——你是用别人编译好的 Windows 移植版还是干脆用 WSL2 或者容器把官方版本跑起来。路线选错后面写代码、做缓存治理的时候会一直别扭。这篇东西写给两类人一类是刚入门、想在自己 Windows10 电脑上装一个 redis 学命令、跑跑 demo 的同学另一类是需要在本机做联调、或者临时搭个缓存服务给本地项目用的开发者。我会把几条路线的优缺点摊开讲清楚然后手把手走一遍最省事的安装流程再把配置文件里那些真正影响稳定性的参数一个个拆开说。看完你应该能做到四件事装好、连上、开机自启、知道哪些坑要提前绕开。1. 先选路线Windows10 上跑 Redis 的几种方案1.1 Windows 版 Redis 到底是个什么东西先把这个背景说清楚不然你搜到一堆教程会越看越乱。早期微软的一个开放技术团队确实维护过 Redis 的 Windows 移植版最后一个官方性质的分支停在 3.2.100。这个项目归档之后社区里有人在它的基础上打补丁做出了 5.0.14.1 这个版本目前网上流传的绝大多数Windows 版 Redis 压缩包源头都在这里。再往上的 6.x、7.x没有原生 Windows 版本。这意味着一个很现实的问题你跟着 7.x 的教程敲命令可能会发现某些命令在本地报错。比如 6.0 引入的多线程 IO、7.0 引入的 Function、7.x 的 ACL 体系Windows 移植版统统没有。5.0.14.1 已经支持 Stream 类型、支持 LFU 淘汰策略日常学习和绝大多数业务场景够用但你要冲着新特性去就得走 WSL2 或者容器。还有一个容易被忽略的点Windows 移植版对内存的管理方式和 Linux 版不一样。Linux 版靠 fork 做持久化Windows 没有 fork移植版是用线程模拟的AOF 重写和大 key 删除时的阻塞感会明显一些。这不是配置能解决的是底层实现差异知道有这回事就行。1.2 四种落地路径横向对比我把实际用过的几种方案整理成表格你对着自己的需求挑方案最高版本安装难度性能表现适合场景Windows 移植版5.0.14.1最低解压即用单线程日常够用学命令、本地 demo、临时联调WSL2 内跑官方版7.x中等需要开虚拟化接近原生 Linux要贴近生产、要新特性Docker Desktop7.x中等需要装 Docker良好有少量网络开销多版本切换、快速起停商业兼容版7.x低有安装向导原生服务稳定内网长期挂着的小服务WSL2 这条路的门槛主要在系统层面需要在启用或关闭 Windows 功能里勾选虚拟机平台和 Linux 子系统重启一次然后装发行版。装好之后apt install redis-server就行还能配上 systemd 做自启。缺点是内存占用比移植版高WSL2 会预留一部分内存给虚拟机8G 内存的机器上同时开 IDE 可能会有点挤。Docker 这条路我个人最推荐给需要多版本的人。拉一个redis:7-alpine镜像几百 MB起停一条命令配置用挂载卷的方式传进去删掉容器数据还在。想换版本就换 tag想跑主从就起两个容器配一下非常干净。唯一要留意的是容器里的网络和宿主机不完全一样127.0.0.1的理解方式需要适应一下。1.3 我的建议按用途选别按哪个高级选如果你只是要学 redis 的数据类型和基本命令老老实实用移植版五分钟能跑起来不用折腾虚拟化。如果你是在给一个将来要上生产 Linux 的项目做本地开发那我强烈建议直接上 WSL2 或 Docker把版本对齐省得本地能跑线上报错。如果你是给公司内网的一台 Windows 机器搭个缓存服务长期用商业版或者 WSL2 配 systemd 都比移植版靠谱移植版没有经过正式的生产验证。下面第 2 到第 6 章我以移植版为主线走完整流程因为这是提问最多、踩坑最密集的一条路。走完之后我会顺带说 WSL2 和 Docker 的关键差异在哪。2. 安装前的环境确认与目录规划2.1 系统版本、位数与权限的三项检查动手之前先确认三件事能省掉后面一半的麻烦。第一按Win R输入winver看清楚系统版本号。Windows10 1809 之后的版本都没问题如果你还在 1803 甚至更早建议先更新老版本在服务注册和防火墙规则上有一些奇怪行为。第二确认系统是 64 位。右键此电脑→属性看系统类型那一行。32 位系统跑不了 64 位的 Redis 服务端别下载错了包。第三准备一个管理员权限的命令行。后面注册服务、改防火墙都要用到普通权限的 cmd 会在--service-install那一步直接报拒绝访问而且报错信息很含糊容易让人以为是配置文件的问题。另外提一句杀毒软件。有些安全软件会对来路不明的 exe 做行为拦截redis-server.exe启动时申请大块内存偶尔会被判定成可疑行为。如果出现启动几秒后进程自己消失的情况先看看安全软件的隔离区里有没有它。2.2 目录怎么放路径里千万别有中文和空格这一条我吃过亏必须单独说。把 Redis 解压到一个短路径下比如D:\Redis或者C:\Redis。不要放在桌面、我的文档、下载这些目录里因为它们的完整路径里带着中文用户名。原因是 Windows 移植版在解析配置文件的dir、logfile、dbfilename这些路径参数时对中文和空格的处理不够健壮。更致命的是服务注册那一步命令行参数是按空格切分的如果路径里带空格--service-install D:\My Redis\redis.windows-service.conf会被解析成两个参数服务装上了但找不到配置文件启动直接 1067。如果你确实只能用带空格的路径那就用 8.3 短路径名在 cmd 里dir /x能看到或者干脆用引号把整个路径包起来但这个在服务安装里不一定生效稳妥起见还是换个干净目录。2.3 端口、防火墙与运行库端口方面Redis 默认监听 6379。装之前先查一下有没有被占netstat -ano | findstr :6379如果这条命令有输出说明 6379 已经有进程在用了记下最后一列的 PID用tasklist | findstr PID看是哪个程序。有可能是你之前装过的 Redis 服务没卸干净也有可能是别的开发工具占了。防火墙这块分两种情况。如果你只在本机用本机的 Java/Python 程序连本机 Redis那什么都不用改走127.0.0.1回环地址不经过防火墙。如果你要让同一局域网的另一台机器连过来那就要在Windows Defender 防火墙→高级设置→入站规则里加一条允许 TCP 6379 的规则同时强烈建议限制来源 IP 段别开成任何 IP。运行库方面Windows 版 Redis 是 C 语言编译的大部分情况下不需要额外装什么但如果启动时报缺少MSVCP140.dll或VCRUNTIME140.dll装一下微软官方的 VC 运行库合集即可。这个报错和 Redis 本身无关是编译环境问题。3. 一步一步装从解压到敲出第一个 PONG3.1 下载与解压每个文件都要认识下载渠道优先选 GitHub 上开源仓库的 Release 页面搜关键词 redis windows 一般能定位到选 5.0.14.1 的 zip 包。下载完解压到D:\Redis你会看到这么一堆文件文件名作用要不要动redis-server.exe服务端主程序不动redis-cli.exe命令行客户端不动redis-benchmark.exe性能压测工具不动redis-check-aof.exeAOF 文件修复工具备用redis-check-rdb.exeRDB 文件修复工具备用redis.windows.conf前台启动用配置要改redis.windows-service.conf服务启动用配置要改dump.rdb持久化数据文件自动生成这里有个新手最容易懵的点为什么有两个 conf 文件。答案是服务模式下的日志行为不一样——作为服务运行时没有控制台可以输出所以redis.windows-service.conf里通常会把logfile指向一个具体文件。如果你发现前台测试一切正常装成服务后行为完全不同八成就是这两个文件里的配置不一致改的时候记得两个一起改。3.2 前台启动先看清启动日志再谈别的千万不要双击redis-server.exe。双击会用一个内置的默认配置启动一闪就关什么都看不到。正确姿势是打开 cmd切到目录显式带上配置文件cd /d D:\Redis redis-server.exe redis.windows.conf正常情况下你会看到一段 ASCII 图形然后是几行关键日志* Ready to accept connections看到这行说明服务端起来了这个 cmd 窗口必须一直开着关掉就等于停服务。这时候别急着关先确认日志里没有 WARNING。常见的几类提示The Windows version of Redis allocates a memory mapped heap...这类是提示 maxheap 相关后面配置章节细说Increased maximum number of open files to 10032是正常的信息Warning: no config file specified说明你没带配置文件那是双击了如果窗口开了几秒自己就没了别急着反复试往后翻到第 6 章我在那里列了完整的排查链路。3.3 注册成 Windows 服务做到开机自启前台启动的窗口一关服务就没了显然不适合长期用。做成 Windows 服务是标准做法。用管理员身份打开 cmd切到目录执行redis-server --service-install redis.windows-service.conf --loglevel verbose redis-server --service-start第一条命令把 Redis 注册成一个名为 Redis 的系统服务第二条启动它。之后你可以在服务管理器里看到它右键设为自动开机就会自己起来。配套的几条管理命令记一下早晚要用redis-server --service-stop # 停止服务 redis-server --service-restart # 重启服务 redis-server --service-uninstall # 卸载服务有一个坑我必须提前说--service-install后面跟的那个配置文件会被烧进服务定义里。之后你改了别的 conf 文件服务用的是原来那个。所以要改配置改的是redis.windows-service.conf改完执行--service-restart才生效。很多人改了半天redis.windows.conf发现服务行为没变就是栽在这。3.4 用 redis-cli 连上去跑一遍基础命令服务起来之后另开一个 cmd还是切到目录redis-cli.exe -h 127.0.0.1 -p 6379回车之后提示符会变成127.0.0.1:6379说明连上了。敲一个ping返回PONG这一步通了基本就成功了。如果你想偷懒不切目录也可以把D:\Redis加到系统环境变量 Path 里之后在任何地方都能直接敲redis-cli。接着把几种数据类型都过一遍这几个命令建议你亲手敲一遍比看十遍文档管用类型写入命令读取命令字符串SET user:1 tomGET user:1列表LPUSH msgs a bLRANGE msgs 0 -1哈希HSET u:1 name tom age 20HGETALL u:1集合SADD tags redis javaSMEMBERS tags有序集合ZADD rank 90 tom 80 jerryZREVRANGE rank 0 -1 WITHSCORES顺手敲一个EXPIRE user:1 60再加TTL user:1你会看到过期时间在倒数这就是缓存最常用的姿势。如果给服务设了密码连接时用redis-cli -a 你的密码5.0 版本会提示一句密码写在命令行不安全可以忽略但在生产环境里这个提示是有道理的。4. 配置文件调优真正该动的几个参数4.1 maxheap 和 maxmemory这两个别搞混这是 Windows 版 Redis 最容易出问题的地方也是和 Linux 版差别最大的地方。maxheap是 Windows 移植版特有的参数控制服务端进程能申请的堆内存总量超出就分配失败。maxmemory是 Redis 自己的逻辑上限到了这个值就开始按策略淘汰键。两个都要设而且 maxheap 要比 maxmemory 大。参数怎么算我给你一个例子。假设开发机 16GB 内存同时开着 IDEA、浏览器和几个服务留给 Redis 的空间大概 2GB 到 3GB 比较安全。那么maxheap 2048mb maxmemory 1536mbmaxmemory 比 maxheap 留了 512MB 的余量这 512MB 用来干什么AOF 重写时新旧文件同时存在、复制缓冲区、客户端输出缓冲、各种内部结构开销。如果你把两个值设成一样大一旦触发持久化重写进程很可能直接因为分配失败退出日志里只留一行 heap allocation failed非常难查。淘汰策略用一个表格说清楚策略行为适用场景noeviction不淘汰写入直接报错当数据库用不能丢数据allkeys-lru从所有键里挑最久未用的淘汰纯缓存最常用volatile-lru只从设了过期时间的键里淘汰部分键要长期保留allkeys-lfu按访问频率淘汰热点数据明显的场景volatile-ttl优先淘汰快过期的时效性强的数据本地开发我一般直接maxmemory-policy allkeys-lru简单粗暴。但要注意如果你的项目把 Redis 当主存储用数据不能丢那就得用 noeviction并且把 maxmemory 设得足够大。4.2 持久化RDB 和 AOF 怎么取舍本地开发机上我通常的做法是把 RDB 的自动保存关掉只留手动触发save 这样进程不会被突如其来的 fork 打断写入也快。代价是重启数据没了但开发环境的数据本来就无所谓重新灌一遍就行。如果你确实需要数据保留那就打开save 900 1 save 300 10 save 60 10000这三行的意思是900 秒内至少 1 个键变化、300 秒内至少 10 个、60 秒内至少 10000 个满足任一条件就落盘一次。这个策略是 Redis 官方给的默认值在性能和最多丢多少数据之间做了个折中。AOF 是另一种思路把每条写命令追加到文件里重启时重放。可靠性高但文件会越来越大还涉及重写。相关参数appendonly yes appendfsync everysec auto-aof-rewrite-percentage 100 auto-aof-rewrite-min-size 64mbappendfsync everysec意味着最多丢 1 秒的数据这是绝大多数场景的平衡点。设成 always 每条都 fsync慢得没法用设成 no 交给操作系统决定丢数据可能丢几十秒。这里要提醒一句 Windows 特有的问题AOF 重写需要复制当前数据集Linux 上是 fork 加写时复制开销很小Windows 移植版用线程模拟重写期间主线程会被明显阻塞。如果你的数据集有几百 MB重写时可能会出现秒级的卡顿。所以本地开发我个人更倾向只开 RDB甚至两个都关。4.3 绑定地址、密码和危险命令别让 6379 裸奔默认配置里bind 127.0.0.1只监听本机这是最安全的。如果你要让局域网别的机器访问改成bind 0.0.0.0 protected-mode yes requirepass 一个足够长的密码三个一起改缺一不可。只改 bind 不加密码等于把数据库敞开在局域网上任何人redis-cli -h 你的IP就能进去FLUSHALL。protected-mode yes是一道兜底当没有密码且没有显式 bind 时它会拒绝外部连接但在你显式写了bind 0.0.0.0之后这道保护就失效了所以密码必须设。再进阶一步把危险命令重命名或者禁用rename-command FLUSHALL rename-command FLUSHDB rename-command KEYS rename-command CONFIG KEYS *在生产环境是禁止使用的它会阻塞整个单线程服务键多了能把服务卡死几秒。禁用之后想扫键就用SCAN游标遍历代替虽然写法麻烦点但不会阻塞。FLUSHALL更是手滑一下就清库本地开发也建议禁掉改成rename-command FLUSHALL FLUSHALL_XXX这种重命名方式需要的时候敲长命令。5. 可视化工具与日常运维姿势5.1 图形客户端怎么选命令行用久了会想看图形界面尤其是要看有哪些 key、每个 key 占多大内存的时候。三个主流工具对比工具是否免费特点我的评价RedisInsight免费官方出品功能最全有内存分析首选值得装Another Redis Desktop Manager开源免费轻量启动快中文界面日常查键够用RESP.app基础版免费前身是 Redis Desktop Manager老牌界面略旧RedisInsight 是官方出的直接下载安装包一路下一步就行。它的内存分析功能很好用能按 key 前缀统计内存占用找大 key 特别方便。Another Redis Desktop Manager 我更常用来做快速查看因为它启动比 RedisInsight 快很多界面也简洁。连接的时候注意如果服务设了密码工具里要填密码如果连的是 WSL2 里的 Redis地址用127.0.0.1是可以的WSL2 做了端口转发如果连的是 Docker 里的 Redis记得起容器时要-p 6379:6379把端口映射出来。5.2 日志、慢查询与内存分析日志这块服务模式下务必在redis.windows-service.conf里指定logfilelogfile D:/Redis/logs/redis.log loglevel notice注意路径用正斜杠或者双反斜杠单反斜杠在配置文件里会被当转义符。目录要先手工建好Redis 不会自动创建日志目录目录不存在的话服务直接启动失败。慢查询日志是个被严重低估的功能本地开发也建议开着slowlog-log-slower-than 10000 slowlog-max-len 12810000 的单位是微秒也就是 10 毫秒。执行超过 10ms 的命令会被记录下来用SLOWLOG GET 10查看最近 10 条。开发阶段经常能靠它发现一些写得很烂的命令比如循环里一个个GET而不是用MGET。内存诊断几个常用命令建议背下来redis-cli --bigkeys # 扫描各类型最大的 key redis-cli --memkeys # 按内存排序找大 key redis-cli info memory # 内存使用总览 redis-cli memory usage key名 # 单个 key 的内存占用--bigkeys在键特别多的时候会扫很久而且会占用 CPU开发机上无所谓生产环境要谨慎。INFO memory里的used_memory_human和maxmemory_human对比着看接近了就说明该扩容或者该调淘汰策略了。5.3 备份、迁移、升级、卸载的干净做法备份最稳的方式是手动触发一次落盘然后复制文件redis-cli bgsave等日志里出现Background saving terminated with success再把dump.rdb复制走。不要直接复制正在被写入的 dump.rdb那可能是个写了一半的文件恢复时会报格式错误。如果你关了 RDB 持久化那就直接SAVE也行数据量小的时候差别不大。迁移到 WSL2 或 Docker 的时候思路是把 dump.rdb 放进新实例的dir目录启动时自动加载。要注意版本兼容性低版本生成的 RDB 文件可以往高版本迁反过来不行。从 5.0 迁到 7.x 是没问题的。升级 Windows 移植版比较土就是停服务、把新的 exe 和 conf 覆盖过去、再启动。覆盖前先把dump.rdb备份一份防止新版本不兼容。卸载要干净按顺序来redis-server --service-stop redis-server --service-uninstall先停再卸顺序反了服务会残留。卸载完去服务管理器里确认一下 Redis 那条没了再把目录删掉。如果之前加过防火墙规则和 Path 环境变量一并清理。6. 踩坑实录这些报错我都遇到过6.1 双击 exe 黑框一闪就没这是最高频的问题。原因基本逃不出四个没带配置文件启动、6379 端口被占、maxheap 没设导致内存分配失败、杀毒软件拦截。排查顺序我建议这样走——第一步别双击用 cmd 运行redis-server.exe redis.windows.conf把报错信息看清楚90% 的问题在这一步就有答案了。第二步如果是启动几秒后退出并且日志里有heap allocation相关字样去配置文件里加maxheap 1024mb试试。第三步查端口占用netstat -ano | findstr :6379有输出就说明冲突换个端口或者杀掉占用进程。第四步看安全软件隔离区。6.2 服务启动失败报错误 1067错误 1067 的意思是进程意外终止具体原因要看日志。最常见的是配置文件里logfile或dir指向了一个不存在的目录。Redis 不会帮你创建目录路径写错就直接崩。第二常见的是服务注册时用的是相对路径服务的工作目录和你的预期不一样所以配置文件里的路径一律写绝对路径写成D:/Redis/dump.rdb这种。还有一个隐蔽的情况你用普通权限的 cmd 执行了--service-install命令看起来成功了因为 Windows 会做个假动作但服务其实没注册完整。所以记住注册服务必须管理员权限。6.3 redis-cli 连不上各种拒绝连接类的报错按这个顺序排查现象可能原因处理方式Connection refused服务没起来查服务状态看日志Connection refused地址或端口写错确认-h-p参数连上了但报 NOAUTH服务设了密码-a 密码或者AUTH 密码本机能连别的机器连不上只 bind 了 127.0.0.1改配置并加密码本机能连别的机器连不上防火墙拦了加入站规则时好时坏客户端连接池耗尽查INFO clients的 connected_clientsINFO clients里的connected_clients如果一直往上涨不回落多半是客户端没正确释放连接这种问题在开发阶段就要发现不要带到生产。6.4 关于分布式锁和缓存的几句提醒本地装 Redis 最常见的用途就是练分布式锁和做缓存。分布式锁用一条命令就能实现SET lock:order:123 uuid NX PX 30000NX保证只有第一个请求能设置成功PX 30000是 30 秒自动过期防止死锁value 用一个唯一值方便释放时校验。但我要说的是本地 Windows 版只适合做功能验证它的时钟精度、阻塞行为和 Linux 版有差异压测出来的加锁成功率数据不能直接信。真要做锁的压力测试还是挪到 WSL2 或容器里去跑。缓存方面本地开发最容易犯的错是拿KEYS去清理缓存。养成习惯用SCAN加DEL的方式批量删或者按业务前缀设计好键名用工具按前缀删。键名设计上业务:对象:ID这种冒号分隔的写法是社区惯例别自己发明一套团队成员看着别扭。我个人在这台开发机上的最终配置是这样Windows 移植版 5.0.14.1注册成服务开机自启maxheap 2048mb、maxmemory 1536mb、allkeys-lru、关了 AOF 只留 RDB、设了密码但只bind 127.0.0.1日志写在D:\Redis\logs下按天不管反正也不大。这套配置跑了快一年除了偶尔忘了关大写锁定敲错密码没出过别的问题。最后再分享一个小技巧如果你同时在 WSL2 里也装了一个 Redis两边都用 6379 端口是没问题的WSL2 的端口转发只在自己启动的时候抢占Windows 本机的服务也不会被顶掉但如果你发现redis-cli连上去之后数据对不上先敲一个INFO server看一眼os字段确认你连的到底是哪一个这个坑我踩过排查了半小时才发现是连错了实例。