Windows系统下Redis的完整安装、配置与使用指南
·
Windows系统下Redis的完整安装、配置与使用指南
Redis 是一款高性能的开源内存数据库,常用于缓存、消息队列、会话存储等场景。本文将详细讲解在 Windows 系统中从下载、安装、配置到日常使用的全流程,包括密码设置、服务启停等核心操作,适合零基础的Windows用户快速上手。
一、前置准备
1. 环境说明
- 操作系统:Windows 10/11(32/64位均可,推荐64位)
- Redis版本:推荐使用微软维护的Windows版Redis(Redis官方已停止Windows原生支持)
- 无需提前安装依赖(绿色版直接运行)
二、Redis下载
- 打开浏览器,访问微软维护的Redis Windows版下载地址:
https://github.com/microsoftarchive/redis/releases - 选择稳定版本(推荐
Redis-x64-3.2.100.zip,兼容性最好),点击下载对应zip包:- 32位系统选择
Redis-x86-xxx.zip - 64位系统选择
Redis-x64-xxx.zip
- 32位系统选择
- 下载完成后,将压缩包解压到自定义目录(建议路径简洁,避免中文/空格),例如:
D:\redis
三、Redis安装(绿色版,无需安装程序)
- 解压后,进入Redis目录(如
D:\redis),可看到核心文件:redis-server.exe:Redis服务端程序(启动Redis)redis-cli.exe:Redis客户端程序(连接Redis)redis.windows.conf:Redis核心配置文件
- 验证解压成功:双击
redis-server.exe,若弹出黑窗口并显示Redis is ready to accept connections,说明程序可正常运行(此时不要关闭该窗口,关闭则Redis停止)。
四、Redis基础配置(核心)
1. 修改配置文件(关键)
Redis的所有核心配置都在redis.windows.conf文件中,建议先备份原文件,再用记事本/VS Code打开编辑:
(1)设置密码(必做,提升安全性)
找到配置文件中# requirepass foobared这一行:
- 注释掉原有行(加
#),新增一行:requirepass 你的密码(例如requirepass 123456) - 示例:
# requirepass foobared # 注释原有默认配置 requirepass 123456 # 设置Redis连接密码为123456
(2)设置端口(可选,默认6379)
找到port 6379,如需修改端口(如避免冲突),直接修改数值:
port 6379 # Redis默认端口,可改为其他数值(如6380)
(3)设置持久化(可选,默认开启)
Redis默认开启RDB持久化,无需修改,核心配置:
save 900 1 # 900秒内至少1个键被修改,触发持久化
save 300 10 # 300秒内至少10个键被修改,触发持久化
save 60 10000 # 60秒内至少10000个键被修改,触发持久化
2. 保存配置文件
修改完成后,保存redis.windows.conf,确保编码为UTF-8(避免乱码)。
五、Redis启动与停止
1. 临时启动(手动,关闭窗口即停止)
(1)无配置启动(不推荐,使用默认配置)
- 打开
cmd命令提示符(管理员/普通用户均可); - 切换到Redis目录:
cd /d D:\redis(/d表示切换盘符+目录); - 执行启动命令:
redis-server.exe # 启动Redis,使用默认配置(未设置密码)
(2)指定配置启动(推荐,使用自定义配置)
cd /d D:\redis
redis-server.exe redis.windows.conf # 加载自定义配置文件启动(含密码)
- 启动成功标志:窗口显示
Ready to accept connections on port 6379。
2. 安装为Windows服务(开机自启,推荐)
(1)安装服务
打开管理员权限的cmd,执行:
cd /d D:\redis
# 安装Redis服务,指定配置文件,服务名默认Redis
redis-server.exe --service-install redis.windows.conf --loglevel verbose
- 成功提示:
Redis service successfully installed。
(2)服务相关命令(管理员权限)
# 启动Redis服务
redis-server.exe --service-start
# 停止Redis服务
redis-server.exe --service-stop
# 卸载Redis服务(如需删除)
redis-server.exe --service-uninstall
# 重命名Redis服务(如需多实例)
redis-server.exe --service-name Redis6380 --service-install redis.windows.conf
3. 验证启动成功
打开任务管理器→服务,找到Redis服务,状态为“正在运行”即成功。
六、Redis客户端连接与使用
1. 连接Redis(redis-cli)
(1)本地连接(默认端口)
打开新的cmd窗口(无需管理员),切换到Redis目录:
cd /d D:\redis
# 未设置密码时直接连接
redis-cli.exe
# 设置密码后连接(两种方式)
# 方式1:连接后验证密码
redis-cli.exe
127.0.0.1:6379> auth 123456 # 验证密码,正确则返回OK
# 方式2:连接时直接指定密码(推荐)
redis-cli.exe -a 123456
- 连接成功标志:命令行显示
127.0.0.1:6379>。
(2)指定端口/IP连接(可选)
# 连接本地6380端口的Redis,密码123456
redis-cli.exe -p 6380 -a 123456
# 连接远程Redis(如IP为192.168.1.100,端口6379)
redis-cli.exe -h 192.168.1.100 -p 6379 -a 123456
2. 核心命令示例(带注释)
连接成功后,可执行以下常用命令:
# 1. 验证密码(如未在连接时指定)
127.0.0.1:6379> auth 123456 # 输入配置的密码,返回OK则验证通过
OK
# 2. 字符串操作(最常用)
127.0.0.1:6379> set name "zhangsan" # 设置键name,值为zhangsan
OK
127.0.0.1:6379> get name # 获取键name的值
"zhangsan"
127.0.0.1:6379> del name # 删除键name,返回1表示删除成功
(integer) 1
# 3. 查看所有键
127.0.0.1:6379> keys * # 列出所有键(*为通配符)
(empty list or set) # 无键时返回空
# 4. 查看Redis信息
127.0.0.1:6379> info # 查看Redis版本、内存、连接等详细信息
# Server
redis_version:3.2.100
redis_git_sha1:00000000
...
# 5. 退出客户端
127.0.0.1:6379> exit # 或按Ctrl+C退出
3. 修改Redis密码(运行时临时修改+配置文件永久修改)
(1)运行时临时修改(重启后失效)
127.0.0.1:6379> config set requirepass 888888 # 临时将密码改为888888
OK
127.0.0.1:6379> auth 888888 # 需重新验证新密码
OK
(2)永久修改(需改配置文件+重启服务)
- 编辑
redis.windows.conf,修改requirepass为新密码; - 重启Redis服务:
redis-server.exe --service-stop redis-server.exe --service-start
七、常见问题解决
- 启动时提示“端口被占用”:
- 执行
netstat -ano | findstr 6379查看占用进程PID; - 在任务管理器结束对应进程,或修改Redis端口。
- 执行
- 连接时提示“NOAUTH Authentication required”:
- 未输入密码,执行
auth 你的密码即可。
- 未输入密码,执行
- 安装服务失败:
- 确保以管理员权限运行cmd;
- 检查Redis目录路径是否含中文/空格。
总结
- Windows下Redis为绿色版,解压后通过
redis-server.exe启动,推荐安装为系统服务实现开机自启; - 核心配置需修改
redis.windows.conf,重点设置requirepass密码提升安全性,启动时需指定配置文件; - 客户端通过
redis-cli.exe连接,连接带密码的Redis需用auth 密码验证,常用命令支持字符串、键管理等基础操作。
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐



所有评论(0)