一、前言:为什么需要本地安装 Redis?
Redis 作为高性能内存数据库,广泛应用于缓存、会话管理、排行榜等场景。
无论是学习、调试还是开发测试,在本地快速部署一个 Redis 实例都是必备技能。
本文将手把手教你通过 三种主流方式 安装 Redis:
✅ Linux(Ubuntu/CentOS)原生安装 ------ 生产环境首选
✅ Windows(WSL2 或官方兼容版) ------ 开发者友好
✅ Docker 容器化部署 ------ 快速、隔离、跨平台
📌 提示:Redis 官方不支持原生 Windows,但可通过 WSL2 或微软维护的旧版本运行。
二、方式一:Linux 系统安装 Redis(推荐)
1. Ubuntu / Debian 系统
bash
# 更新软件源
sudo apt update
# 安装 Redis(自动包含 server 和 cli)
sudo apt install redis-server -y
# 启动 Redis 服务
sudo systemctl start redis-server
# 设置开机自启
sudo systemctl enable redis-server
# 检查状态
sudo systemctl status redis-server
2. CentOS / RHEL 系统
bash
# 安装 EPEL 源(CentOS 7/8 需要)
sudo yum install epel-release -y
# 安装 Redis
sudo yum install redis -y
# 启动并设置自启
sudo systemctl start redis
sudo systemctl enable redis
3. 验证安装
bash
# 连接 Redis
redis-cli ping
# 正常返回:
PONG
✅ 成功!你已拥有一个运行中的 Redis 实例,默认监听
127.0.0.1:6379。
三、方式二:Windows 系统安装 Redis
⚠️ 注意:Redis 官方不再支持原生 Windows。以下是两种可行方案:
方案 A:使用 WSL2(强烈推荐)
WSL2(Windows Subsystem for Linux)让你在 Windows 上运行完整 Linux 内核。
步骤:
-
启用 WSL2 (以管理员身份运行 PowerShell):
bashwsl --install系统会自动安装 Ubuntu 并重启。
-
启动 Ubuntu 终端 ,执行 Linux 安装命令(见上一节):
bashsudo apt update && sudo apt install redis-server -y sudo service redis-server start redis-cli ping # 返回 PONG 即成功 -
从 Windows 访问 :
Redis 监听127.0.0.1,你的 Windows 应用可直接连接localhost:6379。
💡 优势:性能接近原生 Linux,兼容性好,适合长期开发。
方案 B:使用 Microsoft 维护的 Redis for Windows(仅限测试)
🔒 仅用于本地开发测试,切勿用于生产环境!
- 下载地址 (GitHub):
https://github.com/microsoftarchive/redis/releases - 安装步骤 :
- 下载
Redis-x64-*.msi - 双击运行安装程序
- 勾选"Add to PATH"以便全局使用
- 下载
- 启动 Redis :
-
安装完成后自动启动服务
-
打开 CMD,输入:
bashredis-cli ping返回
PONG表示成功。
-
⚠️ 缺点:版本较旧(最高 3.2),不支持新特性(如 Streams、ACL)。
四、方式三:使用 Docker 安装 Redis(最便捷)
Docker 是目前最流行的容器化部署方式,一行命令即可启动 Redis。
1. 安装 Docker(若未安装)
- Windows / Mac:安装 Docker Desktop
- Linux:参考官方文档安装 Docker Engine
2. 启动 Redis 容器
bash
# 拉取最新版 Redis 并以后台模式运行
docker run -d \
--name my-redis \
-p 6379:6379 \
redis:latest
参数说明:
-d:后台运行--name:容器命名-p 6379:6379:映射宿主机 6379 端口到容器
3. 连接测试
bash
# 方式1:使用宿主机 redis-cli
redis-cli ping
# 方式2:进入容器内部
docker exec -it my-redis redis-cli
4. (可选)持久化数据
默认情况下,容器删除后数据丢失。如需持久化:
bash
# 创建本地目录
mkdir -p ~/redis-data
# 启动时挂载卷
docker run -d \
--name my-redis \
-p 6379:6379 \
-v ~/redis-data:/data \
redis:latest redis-server --appendonly yes
✅
--appendonly yes启用 AOF 持久化,数据将保存在~/redis-data中。
五、常见问题排查
❓ Q1:redis-cli: command not found
A:未安装客户端。Linux 请安装
redis-tools(Ubuntu)或redis(CentOS);Windows 请确认是否添加到 PATH。
❓ Q2:连接被拒绝(Connection refused)
A:检查 Redis 是否运行:
bashsudo systemctl status redis-server # Linux docker ps | grep redis # Docker若未运行,请先启动服务。
❓ Q3:远程无法连接 Redis?
A:默认 Redis 只绑定 127.0.0.1。如需远程访问(仅限内网测试):
- 编辑配置文件(Linux 路径:
/etc/redis/redis.conf)- 注释掉
bind 127.0.0.1- 设置
protected-mode no(不推荐生产使用)- 重启服务
🔒 安全提醒 :生产环境务必设置密码(requirepass yourpassword)并限制访问 IP!
六、结语
感谢您的阅读!如果你有任何疑问或想要分享的经验,请在评论区留言交流!