Redis作为一款高性能的内存键值数据库,在缓存、会话存储、消息队列等场景中应用非常广泛。虽然Redis官方主要面向Linux平台,但在Windows系统上使用它同样可行,尤其是本地开发和测试环境。本文将以最常用的ZIP压缩包方式为主线,完整演示Windows下安装、配置、启动和注册Redis系统服务的全过程。

一、下载Redis安装包
Redis官方并未直接提供Windows版本,目前Windows平台可用的版本主要来自两个渠道:一是微软维护的Redis分支(可在GitHub上找到Redis的Windows移植版仓库),二是由第三方团队维护的较新版本(如基于Redis源码重新编译的版本,支持较新的特性)。对于大多数开发场景,建议选择3.0或3.2左右的稳定版本,够用且兼容性好。
下载完成后会得到一个ZIP压缩包,例如redis-x64-3.2.100.zip。这里建议不要解压到带中文或空格的路径下,避免某些情况下命令行解析出问题。推荐解压到类似C:\Redis\这样的根目录短路径,也方便后续配置环境变量和注册服务。
解压后的目录中包含几个重要文件:redis-server.exe是服务端主程序,redis-cli.exe是命令行客户端,redis.windows.conf和redis.windows-service.conf分别是普通模式和服务模式的配置文件,这些在后面的步骤中都会用到。
二、修改配置文件
解压完成后不要急着启动,先打开C:\Redis\redis.windows.conf做几项基础配置。用记事本或Notepad++打开该文件,找到以下几个关键配置项按需修改。
# 设置访问密码,建议加上,避免裸奔 requirepass 123456 # 绑定地址,本机使用可保持127.0.0.1 bind 127.0.0.1 # 端口号,默认6379,一般不用改 port 6379 # 最大内存限制,本地开发可设小一些 maxmemory 256mb
需要特别说明的是bind这个参数。默认配置只允许本机访问,如果你希望局域网内其他机器也能连接这台Redis,需要把bind改为0.0.0.0或者追加对应的网卡IP。但这样做的风险是Redis会暴露给外部网络,一旦没有设置密码,很容易被扫描攻击甚至被植入挖矿脚本,所以requirepass务必同时设置。
另一个常见配置是maxmemory。Redis把数据放在内存中,如果不限制最大内存,长期运行可能吃光系统内存导致Windows变卡。本地开发环境设成256mb或512mb完全够用。另外maxmemory-policy可以指定内存达到上限后的淘汰策略,做缓存用一般设为allkeys-lru。
三、启动Redis并测试连接
配置完成后就可以启动了。打开命令提示符(按Win+R输入cmd回车),切换到Redis目录执行启动命令。注意启动窗口不要关闭,关掉窗口Redis进程也就结束了。
cd C:\Redis redis-server.exe redis.windows.conf
看到窗口输出Redis的LOGO图案以及一行"The server is now ready to accept connections on port 6379",说明服务已经成功启动。接下来新开一个命令行窗口,用redis-cli测试连接是否正常。
cd C:\Redis # 如果设置了密码,先用auth认证 redis-cli.exe 127.0.0.1:6379> auth 123456 OK 127.0.0.1:6379> set testkey hello OK 127.0.0.1:6379> get testkey "hello"
如果get命令能正确返回之前set进去的值,说明整个安装流程没有问题,Redis已经可以在Windows上正常读写数据了。如果连接时报错"Connection refused",优先检查服务窗口是否还在运行、端口是否被占用。可以用netstat -ano | findstr 6379命令查看端口占用情况。
四、注册为Windows系统服务实现自启
前面用命令行方式启动Redis有个明显的缺点:窗口一关服务就停了,每次开机还要手动敲命令。更优雅的做法是把Redis注册成Windows系统服务,让它随系统自动启动。
以管理员身份打开命令提示符(这点很重要,普通权限注册服务会失败),然后执行以下命令:
cd C:\Redis # 注册服务,指定服务模式的配置文件 redis-server.exe --service-install redis.windows-service.conf --service-name Redis --loglevel verbose # 启动服务 redis-server.exe --service-start --service-name Redis
执行成功后会提示"Redis successfully installed as a service"。此时打开系统的服务管理器(运行services.msc),可以在列表中找到名为Redis的服务,启动类型默认为自动,开机即可自行运行。服务的日志文件一般位于C:\Redis\Logs目录下,排查问题时可以去看看。
如果以后需要卸载服务,同样以管理员身份执行:
redis-server.exe --service-stop --service-name Redis redis-server.exe --service-uninstall --service-name Redis
注册服务后还有一个好处:即使没有任何命令行窗口开着,Redis也在后台持续运行,应用代码可以直接通过127.0.0.1:6379连接,开发体验和Linux环境下基本一致。
五、常见问题与注意事项
Windows下的Redis毕竟不是官方原生支持的平台,使用中有几个坑需要留意。首先是版本问题,Windows分支的Redis版本普遍较老(多为3.x),不支持Redis 5之后的Stream等新特性。如果你的项目依赖较新的Redis功能,更好的方案是用Docker跑官方Redis镜像,或者在本机装个Linux虚拟机。
其次是防火墙问题。当配置了bind 0.0.0.0允许外部访问时,Windows防火墙可能会拦截6379端口的入站连接。需要在防火墙高级设置中为6379端口添加入站规则,或者临时关闭防火墙测试。生产环境则建议通过安全组或防火墙限制来源IP。
最后是密码和持久化的问题。Redis默认开启RDB快照持久化,数据文件dump.rdb会生成在Redis目录下,删除时要谨慎。另外如果配置文件中设置了requirepass,用redis-cli连接后必须先执行auth命令,否则任何读写操作都会返回 authentication required 的错误提示,这是新手最常碰到的问题之一。
总的来说,Windows下安装Redis的流程并不复杂:下载解压、改配置、启动测试、注册服务四步走完就能获得一个稳定的本地缓存环境。把它注册成系统服务后基本可以做到一劳永逸,后续开发中直接连接使用即可。
Windows Redis安装Redis配置Redis启动修改时间:2026-09-07 10:52:57