导读:本期聚焦于张衡创作的《Windows系统下Redis安装配置完整教程:从下载到运行一步到位》,敬请观看详情。想在Windows系统上跑Redis却不知道从哪下手?这篇教程详细讲解Windows环境下安装Redis的完整流程,包括通过微软维护的安装包或ZIP压缩包两种获取方式、解压到指定目录、修改redis.windows.conf配置文件、用命令行启动服务、将Redis注册为Windows系统服务实现开机自启,以及用redis-cli测试连接和常见踩坑问题的解决办法。无论你是本地开发调试还是搭建测试环境,跟着步骤操作就能快速把Redis跑起来。

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

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

免责声明:已尽一切努力确保本网站所含信息的准确性。网站作品多为原创整理与精心创作,观点力求客观中立。本站旨在免费分享,内容仅供个人学习、研究或参考使用。若引用了第三方作品,版权归原作者所有。如内容涉及您的权益,请联系我们进行处理Email:chomcom@qq.com。
引用或转载本作品时,请注明当前出处:https://www.ipipp.com/html/20260907/52157.html,基于非商业用途的前提下,欢迎转载或二创本作品。
内容垂直聚焦
专注技术核心技术栏目,确保每篇文章深度聚焦于实用技能。从代码技巧到架构设计,为用户提供无干扰的纯技术知识沉淀,精准满足专业提升需求。
知识结构清晰
覆盖从开发到部署的全链路。AI、前端、编程、数据库、服务器、建站、系统层层递进,构建清晰学习路径,帮助用户系统化掌握开发与运维所需的核心技术。
深度技术解析
拒绝泛泛而谈,深入技术细节与实践难点。无论是数据库优化还是服务器配置,均结合真实场景与代码示例进行剖析,致力于提供可直接应用于工作的解决方案。
专业领域覆盖
精准对应开发生命周期。从前端界面到后端编程,从数据库操作到服务器运维,形成完整闭环,一站式满足全栈工程师和运维人员的技术需求。
即学即用高效
内容强调实操性,步骤清晰、代码完整。用户可根据教程直接复现和应用于自身项目,显著缩短从学习到实践的距离,快速解决开发中的具体问题。
持续更新保障
专注既定技术方向进行长期、稳定的内容输出。确保各栏目技术文章持续更新迭代,紧跟主流技术发展趋势,为用户提供经久不衰的学习价值。