Windows 安装 Redis：最简单可落地的完整教程

关键词

Windows 安装 Redis

Redis 是一个高性能的内存数据库，很多做开发、测试、学习的人都会在本地装一套。虽然 Redis 官方更推荐跑在 Linux 上，但在 Windows 里照样能用，尤其适合本地开发环境、调试缓存、消息队列、会话存储等场景。

下面这篇文章会按“问题分析 → 解决方案 → 注意事项”的思路，手把手讲清楚 Windows 安装 Redis 的几种实用方式，新手也能照着做。

---

一、先说清楚：Windows 上为什么还要装 Redis

很多人第一次接触 Redis，会发现教程大多写的是 Linux 环境，心里会有疑问：
Windows 还能不能装？装了稳不稳？

答案是：

• 能装
• 能用
• 但不建议把 Windows 当作正式生产环境来跑 Redis

原因很简单：

1. Redis 官方长期不把 Windows 当主力平台 Windows 版本更多是社区方案或兼容方案。
2. 开发测试够用，正式服务器更建议 Linux 生产环境里，Linux 的稳定性、兼容性、运维工具都更成熟。
3. 本地开发最方便 如果你只是想在电脑上做项目、跑程序、学习 Redis 命令，Windows 完全够用。

---

二、Windows 安装 Redis 的三种主流方案

方案 1：用 WSL 安装 Redis（推荐）

适合：

• Windows 10 / Windows 11
• 想要更接近 Linux 原生环境
• 学习、开发、测试使用

优点：

• 稳定性比老旧 Windows 版 Redis 更好
• 跟 Linux 命令一致
• 后期迁移到服务器更方便

缺点：

• 需要开启 WSL
• 对新手来说步骤稍多

---

方案 2：直接安装 Windows 版 Redis

适合：

• 想快速在本机跑起来
• 只做本地学习、测试
• 不想折腾 Linux 环境

优点：

• 安装简单
• 上手快

缺点：

• 版本和维护情况不如 Linux 原生方式
• 适合测试，不适合长期生产使用

---

方案 3：用 Docker 跑 Redis

适合：

• 已经会用 Docker
• 想要环境干净、切换方便
• 开发多个项目

优点：

• 不污染系统
• 卸载方便
• 配置灵活

缺点：

• 对小白来说理解成本更高
• 需要先装 Docker Desktop

---

三、最推荐的安装方式：WSL 安装 Redis

如果你是普通开发者，或者希望以后少踩坑，建议直接用 WSL。

---

第一步：开启 WSL 功能

方法一：用 PowerShell 一键开启

右键开始菜单，选择 Windows PowerShell（管理员） 或 终端（管理员），输入：

wsl --install

如果你的系统支持，这条命令会自动完成：

• 开启 WSL
• 安装虚拟化组件
• 安装默认 Linux 发行版

安装完成后，按提示重启电脑。

---

第二步：确认 WSL 是否安装成功

重启后，继续在 PowerShell 输入：

wsl --list --verbose

如果能看到 Linux 发行版列表，说明 WSL 已经可用。

---

第三步：安装 Linux 发行版

如果系统没有自动装发行版，可以手动装一个 Ubuntu。

常见做法：

1. 打开 Microsoft Store
2. 搜索 Ubuntu
3. 安装最新稳定版
4. 首次启动时设置 Linux 用户名和密码

---

第四步：在 Ubuntu 中安装 Redis

打开 Ubuntu 终端，输入：

sudo apt update
sudo apt install redis-server -y

安装完成后，查看 Redis 版本：

redis-server --version

如果输出版本号，说明安装成功。

---

第五步：启动 Redis 服务

在 Ubuntu 中输入：

sudo service redis-server start

查看状态：

sudo service redis-server status

如果显示 active（运行中），说明 Redis 已经启动。

---

第六步：测试 Redis 是否正常工作

输入：

redis-cli

进入 Redis 命令行后，执行：

set name hello
get name

如果返回：

"hello"

说明 Redis 正常工作。

退出 Redis 控制台：

exit

---

四、Windows 版 Redis 的安装方法

如果你只想快速在 Windows 上跑起来，可以装 Windows 兼容版 Redis。

第一步：下载 Windows 版 Redis

Windows 上常见的做法是下载可用的 Redis 兼容版本，通常是社区维护包或移植版。
下载后一般会得到一个压缩包或安装包。

建议优先选：

• 可信来源
• 版本更新较新
• 有清晰说明文档的版本

不要随便下载来路不明的“绿色版”，避免捆绑软件或安全问题。

---

第二步：解压到合适目录

建议放到类似下面这种路径：

D:\Redis\

尽量不要放在中文路径、空格过多的路径里，避免后续启动出错。

---

第三步：启动 Redis

进入 Redis 目录，找到 redis-server.exe，双击或在命令行启动。

命令行方式：

redis-server.exe

如果带配置文件：

redis-server.exe redis.windows.conf

启动成功后，会看到 Redis 服务监听信息。

---

第四步：连接测试

再打开一个命令行窗口，输入：

redis-cli.exe

然后测试：

set test 123
get test

如果返回 123，说明 Redis 正常可用。

---

五、用 Docker 安装 Redis 的方法

如果你电脑已经装了 Docker，这是很省心的方案。

第一步：拉取 Redis 镜像

在命令行输入：

docker pull redis

---

第二步：启动容器

docker run -d --name redis-test -p 6379:6379 redis

参数含义很简单：

• -d：后台运行
• --name redis-test：容器名
• -p 6379:6379：把本机 6379 端口映射到容器 6379 端口

---

第三步：进入 Redis 测试

docker exec -it redis-test redis-cli

测试命令：

set a 1
get a

---

六、安装后最常见的几个问题

1. Redis 启动失败

常见原因：

• 端口 6379 被占用
• 配置文件写错
• 防火墙拦截
• 路径有中文或特殊字符

解决办法：

先查端口占用：

netstat -ano | findstr 6379

如果有进程占用，记下 PID，再结束：

taskkill /PID 进程号 /F

---

2. 连接不上 Redis

常见原因：

• Redis 没启动
• 客户端连错地址
• 防火墙没放行
• Docker 端口没映射正确

本机连接一般用：

127.0.0.1:6379

---

3. 中文路径导致报错

Redis 相关工具、配置文件、数据目录最好放在纯英文路径下，比如：

D:\Redis\
C:\Tools\Redis\

不要放：

D:\软件\Redis安装包\

很多环境对中文路径兼容不稳定。

---

4. 密码设置后连不上

如果你配置了密码，连接时要先认证：

auth 你的密码

或者在客户端工具里填写密码字段。

---

七、Redis 常用配置建议

如果是本地开发环境，建议做这几个基础设置。

1. 设置端口

默认是 6379，一般不用改。
如果冲突，可以改成：

port 6380

---

2. 设置持久化

Redis 默认是内存数据库，但也支持数据落盘。

常见方式：

• RDB：定时快照
• AOF：记录写命令

如果你想更安全一点，可以开启 AOF：

appendonly yes

---

3. 设置密码

如果是多人共用电脑，或者需要远程访问，建议设置密码。

配置：

requirepass yourpassword

---

4. 限制访问

本地开发用的话，建议只允许本机访问：

bind 127.0.0.1

这样更安全。

---

八、Windows 安装 Redis 的推荐选择

如果你不知道选哪种方式，直接看这个结论：

小白用户

优先选：

• WSL 安装 Redis

原因：

• 更稳定
• 更接近生产环境
• 学完后更容易迁移到 Linux 服务器

---

只想快速验证项目

优先选：

• Docker 安装 Redis

原因：

• 启动快
• 卸载干净
• 不影响系统环境

---

只想临时学习

优先选：

• Windows 版 Redis

原因：

• 简单直接
• 上手最快

---

九、Windows 安装 Redis 的避坑技巧

1. 不要把 Redis 当成正式服务器长期跑

Windows 环境更适合开发测试。
如果你的项目要上线，建议最终迁移到 Linux 服务器。

2. 不要乱下第三方绿色包

很多“免安装版”可能带来：

• 版本过旧
• 不兼容
• 安全风险
• 额外捆绑软件

3. 配置文件改之前先备份

比如改 redis.conf 前，先复制一份：

redis.conf.bak

这样出问题能快速恢复。

4. 远程开放端口要谨慎

如果要让局域网别的电脑访问 Redis，一定要：

• 设置密码
• 限制 IP
• 开防火墙规则
• 不要直接裸奔暴露到公网

Redis 如果暴露到公网，风险很高。

---

十、Windows 安装 Redis 后怎么验证是否成功

你可以按下面这套最简单的验证流程来检查。

验证 1：看版本

redis-server --version

验证 2：看端口

netstat -ano | findstr 6379

验证 3：执行写入读取

set foo bar
get foo

验证 4：重启后还能不能用

如果开启了持久化，可以重启服务后再查一次数据。

---

十一、给新手的最省事方案

如果你现在只是想“赶紧把 Redis 装起来能用”，我建议按这个顺序：

方案 A：最稳

1. 开启 WSL
2. 安装 Ubuntu
3. sudo apt install redis-server -y
4. 启动 Redis
5. 用 redis-cli 测试

方案 B：最快

1. 安装 Docker Desktop
2. docker pull redis
3. docker run -d --name redis-test -p 6379:6379 redis
4. docker exec -it redis-test redis-cli

方案 C：最直观

1. 下载 Windows 版 Redis
2. 解压
3. 双击启动
4. 用 redis-cli 测试

---

十二、总结

Windows 安装 Redis 并不难，关键是先选对方式。

• 新手学习：推荐 WSL
• 快速测试：推荐 Docker
• 临时本机使用：可以用 Windows 版 Redis

如果只是开发和学习，Windows 完全够用；如果是正式上线，还是建议迁移到 Linux 环境。

按照上面的步骤操作，基本都能顺利把 Redis 在 Windows 上跑起来。