Windows 下 Redis 使用完整教程

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 即停止)

  1. 打开 CMD(无需管理员),切换到 Redis 目录:

    复制代码

    cd /d D:\Redis

  2. 执行启动命令(指定配置文件):

    复制代码

    redis-server.exe redis.windows.conf

  3. 看到 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 服务启动后立即停止

  1. 检查配置文件路径是否正确(安装服务时指定的 redis.windows.conf 必须存在);

  2. 删除 Redis 目录下的 dump.rdbappendonly.aof 持久化文件后重试;

  3. 查看日志文件(配置的 logfile 路径),根据错误提示修复。

问题 5:远程连接不上

  1. 确认 Redis 配置 bind 0.0.0.0(取消仅本地绑定);

  2. Windows 防火墙添加 6379 端口入站规则;

  3. 确认 Redis 服务已启动,密码正确。

六、进阶小贴士

  1. 多实例部署 :复制 redis.windows.confredis6380.conf,修改 port 6380,然后注册不同名称的服务:

    复制代码

    redis-server --service-name Redis6380 --service-install redis6380.conf redis-server --service-start --service-name Redis6380

  2. 持久化说明:RDB 是快照式持久化(性能高),AOF 是追加式持久化(数据更安全),可根据业务选择;

  3. 性能优化:生产环境建议关闭 Windows 虚拟内存,避免 Redis 性能下降。

相关推荐
编码忘我6 小时前
mysq系列之事务
数据库
知识分享小能手6 小时前
Redis入门学习教程,从入门到精通,Redis进阶编程知识点详解(5)
数据库·redis·学习
MekoLi296 小时前
MongoDB 新手完全指南:从入门到精通的实战手册
数据库·后端
cyforkk6 小时前
Spring AOP 进阶:揭秘 @annotation 参数绑定的底层逻辑
java·数据库·spring
今夕资源网6 小时前
坚果手机直连Windows,打开软件实现键鼠操作TNT系统 视频教程+所需软件(今夕存档)
windows·智能手机·tnt·smartisan·smartisan tnt·锤子系统·坚果手机
2401_884970617 小时前
用Pygame开发你的第一个小游戏
jvm·数据库·python
麦聪聊数据7 小时前
快速将Oracle数据库发布为 API:使用 QuickAPI 实现 SQL2API
数据库·sql·低代码·oracle·restful
6+h7 小时前
【Redis】数据结构讲解
数据结构·数据库·redis
ID_180079054737 小时前
小红书笔记详情 API 接口系列 + 标准 JSON 返回参考(完整版)
数据库·笔记·json
wertyuytrewm7 小时前
用Python实现自动化的Web测试(Selenium)
jvm·数据库·python