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

相关推荐
z123456789869 小时前
2026最新两款AI编程工具深度对比实测
java·数据库·ai编程
程序猿DD9 小时前
一个 API Key,统一调用大模型、生图和联网搜索
数据库·网关
王维同学9 小时前
[原创][Windows C++]LSA 认证、安全与通知包的注册表枚举
c++·windows·安全
YCOSA202510 小时前
雨晨 Windows 11 IOT 企业版 LTSC 24H2 轻装 2合1 26100.8968
windows·物联网
TlSfoward10 小时前
抓包代理链路下的 TLS 指纹变化分析 TLSFOWARD抓包工具
数据库·爬虫·网络协议·搜索引擎·php
汤姆yu10 小时前
CodeGeeX 4完整安装与实操使用全指南
人工智能·windows·ai·智能体·视频模型
数智化管理手记10 小时前
账龄分析手工统计易遗漏?自动账龄分析工具怎么搭建
大数据·网络·数据库·人工智能·数据挖掘
LabVIEW开发10 小时前
NI Package Manager安装LabVIEW时InternalServerError错误
网络·数据库·labview·labview知识·labview功能·labview程序
SelectDB11 小时前
PostgreSQL 实时同步到 Apache Doris:一站式 CDC 解决方案
数据库
Database_Cool_11 小时前
AI Agent 长期记忆怎么存?阿里云 PolarDB-X 对接 Mem0 记忆框架实践
数据库·阿里云