Windows 下 Redis 使用完整教程
Redis 官方不再维护 Windows 版本,目前主流使用微软开源团队维护的 Windows 版 Redis(基于 Redis 3.2 稳定版),以下是从下载、配置、启动到使用的全流程教程。
一、准备工作:下载与解压
1. 下载 Redis
Redis-x64-5.0.14.zip:
https://url90.ctfile.com/f/51188890-8535160543-24d8f8?p=3489 (访问密码: 3489)
2. 解压
将下载的压缩包解压到自定义目录(建议路径无中文/空格),例如 D:\Redis。解压后核心文件:
-
redis-server.exe:Redis 服务端程序
-
redis-cli.exe:Redis 客户端程序
-
redis.windows.conf:核心配置文件
二、核心配置(可选,推荐优化)
编辑 redis.windows.conf(建议先备份),修改以下常用配置:
|-------------------------------------|-----------------------------------------|
| 配置项 | 说明 |
| port 6379 | 默认端口,可修改(如 6380)避免冲突 |
| requirepass 123456 | 取消注释,设置连接密码(增强安全,替换为自己的密码) |
| appendonly yes | 开启 AOF 持久化(默认 no,数据更安全,RDB 为默认持久化方式) |
| maxmemory 1024mb | 限制 Redis 最大占用内存(避免耗尽系统内存) |
| bind 127.0.0.1 | 默认仅本地访问,如需远程连接改为 bind 0.0.0.0(需配合防火墙放行) |
| logfile "D:\Redis\log\redis.log" | 配置日志文件路径(默认控制台输出) |
| dir D:\Redis\data | 持久化文件(RDB/AOF)存储路径(需手动创建 data 目录) |
三、Redis 启动方式
方式 1:临时启动(测试用,关闭 CMD 即停止)
-
打开 CMD(无需管理员),切换到 Redis 目录:
cd /d D:\Redis -
执行启动命令(指定配置文件):
redis-server.exe redis.windows.conf -
看到
Redis is now ready to accept connections on port 6379说明启动成功。
方式 2:注册为 Windows 服务(开机自启,推荐)
步骤 1:安装服务
以管理员身份打开 CMD,切换到 Redis 目录:
cd /d D:\Redis # 安装服务(指定配置文件,日志级别为详细) redis-server --service-install redis.windows.conf --loglevel verbose
步骤 2:启动服务
redis-server --service-start
其他服务命令
|------------|--------------------------------------------------------------------------|
| 功能 | 命令 |
| 停止服务 | redis-server --service-stop |
| 卸载服务 | redis-server --service-uninstall |
| 重命名服务(多实例) | redis-server --service-name Redis6380 --service-install redis6380.conf |
验证服务
右键「此电脑」→「管理」→「服务和应用程序」→「服务」,找到「Redis」服务,状态为「正在运行」即成功。
四、客户端连接与基本操作
1. 本地连接
无密码连接
cd /d D:\Redis redis-cli.exe
出现 127.0.0.1:6379> 提示符,说明连接成功。
带密码连接
方法 1:连接后认证
redis-cli.exe 127.0.0.1:6379> auth 123456 # 替换为你的密码,返回 OK 即认证成功
方法 2:连接时直接指定密码
redis-cli.exe -a 123456
2. 远程连接
前提:Redis 配置 bind 0.0.0.0 + 防火墙放行 6379 端口
redis-cli.exe -h 远程IP -p 6379 -a 密码 # 示例:redis-cli.exe -h 192.168.1.100 -p 6379 -a 123456
3. 基本操作示例
# 设置键值(字符串类型) 127.0.0.1:6379> set name "张三" OK # 获取值 127.0.0.1:6379> get name "张三" # 查看所有键 127.0.0.1:6379> keys * 1) "name" # 删除键 127.0.0.1:6379> del name (integer) 1 # 查看键类型 127.0.0.1:6379> type name (nil) # 退出客户端 127.0.0.1:6379> exit
五、常见问题与解决
问题 1:端口 6379 被占用
# 1. 查看占用端口的进程 PID netstat -ano | findstr 6379 # 2. 任务管理器 → 详细信息 → 结束对应 PID 的进程 # 3. 或修改 redis.windows.conf 中的 port 为 6380 等
问题 2:注册服务失败(权限不足)
解决:右键 CMD → 「以管理员身份运行」,重新执行安装命令。
问题 3:中文乱码
# 启动客户端时指定编码 redis-cli.exe --raw # 或修改 CMD 编码为 UTF-8 chcp 65001
问题 4:Redis 服务启动后立即停止
-
检查配置文件路径是否正确(安装服务时指定的
redis.windows.conf必须存在); -
删除 Redis 目录下的
dump.rdb和appendonly.aof持久化文件后重试; -
查看日志文件(配置的
logfile路径),根据错误提示修复。
问题 5:远程连接不上
-
确认 Redis 配置
bind 0.0.0.0(取消仅本地绑定); -
Windows 防火墙添加 6379 端口入站规则;
-
确认 Redis 服务已启动,密码正确。
六、进阶小贴士
-
多实例部署 :复制
redis.windows.conf为redis6380.conf,修改port 6380,然后注册不同名称的服务:redis-server --service-name Redis6380 --service-install redis6380.conf redis-server --service-start --service-name Redis6380 -
持久化说明:RDB 是快照式持久化(性能高),AOF 是追加式持久化(数据更安全),可根据业务选择;
-
性能优化:生产环境建议关闭 Windows 虚拟内存,避免 Redis 性能下降。