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 性能下降。

相关推荐
小陈工1 小时前
Python Web开发入门(十七):Vue.js与Python后端集成——让前后端真正“握手言和“
开发语言·前端·javascript·数据库·vue.js·人工智能·python
科技小花5 小时前
数据治理平台架构演进观察:AI原生设计如何重构企业数据管理范式
数据库·重构·架构·数据治理·ai-native·ai原生
航Hang*5 小时前
Windows Server 配置与管理——第3章:文件系统管理
运维·服务器·windows·vmware
一江寒逸5 小时前
零基础从入门到精通MySQL(中篇):进阶篇——吃透多表查询、事务核心与高级特性,搞定复杂业务SQL
数据库·sql·mysql
D4c-lovetrain5 小时前
linux个人心得22 (mysql)
数据库·mysql
阿里小阿希6 小时前
CentOS7 PostgreSQL 9.2 升级到 15 完整教程
数据库·postgresql
荒川之神6 小时前
Oracle 数据仓库雪花模型设计(完整实战方案)
数据库·数据仓库·oracle
做个文艺程序员6 小时前
MySQL安全加固十大硬核操作
数据库·mysql·安全
不吃香菜学java6 小时前
Redis简单应用
数据库·spring boot·tomcat·maven
一个天蝎座 白勺 程序猿6 小时前
Apache IoTDB(15):IoTDB查询写回(INTO子句)深度解析——从语法到实战的ETL全链路指南
数据库·apache·etl·iotdb