Windows系统下Redis的完整安装、配置与使用指南

Redis 是一款高性能的开源内存数据库,常用于缓存、消息队列、会话存储等场景。本文将详细讲解在 Windows 系统中从下载、安装、配置到日常使用的全流程,包括密码设置、服务启停等核心操作,适合零基础的Windows用户快速上手。

一、前置准备

1. 环境说明

  • 操作系统:Windows 10/11(32/64位均可,推荐64位)
  • Redis版本:推荐使用微软维护的Windows版Redis(Redis官方已停止Windows原生支持)
  • 无需提前安装依赖(绿色版直接运行)

二、Redis下载

  1. 打开浏览器,访问微软维护的Redis Windows版下载地址:
    https://github.com/microsoftarchive/redis/releases
  2. 选择稳定版本(推荐Redis-x64-3.2.100.zip,兼容性最好),点击下载对应zip包:
    • 32位系统选择Redis-x86-xxx.zip
    • 64位系统选择Redis-x64-xxx.zip
  3. 下载完成后,将压缩包解压到自定义目录(建议路径简洁,避免中文/空格),例如:D:\redis

三、Redis安装(绿色版,无需安装程序)

  1. 解压后,进入Redis目录(如D:\redis),可看到核心文件:
    • redis-server.exe:Redis服务端程序(启动Redis)
    • redis-cli.exe:Redis客户端程序(连接Redis)
    • redis.windows.conf:Redis核心配置文件
  2. 验证解压成功:双击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)永久修改(需改配置文件+重启服务)
  1. 编辑redis.windows.conf,修改requirepass为新密码;
  2. 重启Redis服务:
    redis-server.exe --service-stop
    redis-server.exe --service-start
    

七、常见问题解决

  1. 启动时提示“端口被占用”
    • 执行netstat -ano | findstr 6379查看占用进程PID;
    • 在任务管理器结束对应进程,或修改Redis端口。
  2. 连接时提示“NOAUTH Authentication required”
    • 未输入密码,执行auth 你的密码即可。
  3. 安装服务失败
    • 确保以管理员权限运行cmd;
    • 检查Redis目录路径是否含中文/空格。

总结

  1. Windows下Redis为绿色版,解压后通过redis-server.exe启动,推荐安装为系统服务实现开机自启;
  2. 核心配置需修改redis.windows.conf,重点设置requirepass密码提升安全性,启动时需指定配置文件;
  3. 客户端通过redis-cli.exe连接,连接带密码的Redis需用auth 密码验证,常用命令支持字符串、键管理等基础操作。
Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐