Redis 超详细安装教程（Linux/Windows/Docker 全覆盖，新手零基础）

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后，紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}

📝 摘要

本文提供 Redis 最全安装方案，包含 Linux 源码安装、Linux yum/apt 快速安装、Windows 安装、Docker 一键安装四种方式。全程图文式步骤、可直接复制命令、解决远程连接、开机自启、端口不通等常见问题，适合开发、测试、生产环境部署，新手零门槛上手。

适用环境：CentOS7/8、RockyLinux、Ubuntu、Windows10/11、Docker

Redis 版本：7.x 最新稳定版

🔎 目录

1. Redis 简介与环境说明 2. Linux 源码编译安装（生产推荐） 3. Linux 包管理器快速安装（新手推荐） 4. Windows 安装（仅本地测试） 5. Docker 一键安装（极速体验） 6. Redis 常用基础命令 7. 生产环境安全配置 8. 常见报错与踩坑解决

一、Redis 简介

Redis 是一款开源的、高性能的内存键值数据库，支持多种数据结构，常用于缓存、分布式锁、限流、消息队列、会话存储等场景。

✅ 生产环境建议：Linux 源码安装 ✅ 本地开发测试：Windows / Docker 安装 ❌ 生产禁止使用 Windows 版本 Redis

二、Linux 源码编译安装（生产首选）

源码安装支持自定义版本、自定义配置，稳定性最强，是企业生产环境主流部署方式。

1. 安装编译依赖

编译 Redis 需要 gcc 编译环境与 make 工具

# CentOS / Rocky / AlmaLinux
yum install gcc make -y

# Ubuntu / Debian
sudo apt install gcc make -y

2. 下载并解压源码包

# 进入系统软件安装目录
cd /usr/local

# 下载 Redis 7.2.4 稳定版（可替换最新版本）
wget https://download.redis.io/releases/redis-7.2.4.tar.gz

# 解压文件
tar -zxvf redis-7.2.4.tar.gz
cd redis-7.2.4

3. 编译与安装

# 进入系统软件安装目录
cd /usr/local

# 下载 Redis 7.2.4 稳定版（可替换最新版本）
wget https://download.redis.io/releases/redis-7.2.4.tar.gz

# 解压文件
tar -zxvf redis-7.2.4.tar.gz
cd redis-7.2.4

4. 自定义配置文件（核心步骤）

统一管理配置文件，方便后续维护

# 创建配置文件目录
mkdir -p /etc/redis

# 复制默认配置文件
cp redis.conf /etc/redis/6379.conf

# 编辑配置文件
vi /etc/redis/6379.conf

修改以下关键配置（必改）：

• 后台运行：daemonize no 改为 daemonize yes

• 密码认证：取消 requirepass 你的密码 注释，设置自定义密码（生产必须配置）

• 访问绑定：默认 bind 127.0.0.1，仅本地访问；需要远程访问可按需调整，禁止直接全开

5. 启动 Redis 并测试连通性

# 指定配置文件启动
redis-server /etc/redis/6379.conf

# 连接客户端
redis-cli

# 带密码连接
redis-cli -a 你的密码

# 测试是否启动成功
127.0.0.1:6379> ping
# 返回 PONG 即为成功

6. 配置开机自启（Systemd）

创建系统服务文件，实现开机自启、快捷启停

vi /etc/systemd/system/redis.service

写入以下配置：

[Unit]
Description=Redis Server Service
After=network.target

[Service]
Type=forking
ExecStart=/usr/local/bin/redis-server /etc/redis/6379.conf
ExecStop=/usr/local/bin/redis-cli shutdown
PrivateTmp=true

[Install]
WantedBy=multi-user.target

生效服务并设置开机自启：

systemctl daemon-reload
systemctl start redis
systemctl enable redis
systemctl status redis

三、Linux 快速安装（yum/apt，新手推荐）

1. CentOS / Rocky 系统

yum install epel-release -y
yum install redis -y

# 启停、自启命令
systemctl start redis
systemctl stop redis
systemctl restart redis
systemctl enable redis

# 验证
redis-cli ping

2. Ubuntu / Debian 系统

sudo apt update
sudo apt install redis-server -y

# 启停、自启命令
sudo systemctl start redis-server
sudo systemctl enable redis-server

# 验证
redis-cli ping

四、Windows 安装（仅本地开发测试）

官方无 Windows 原生新版本，仅微软归档旧版本，禁止用于生产环境。推荐优先使用 WSL2 模拟 Linux 环境。

方案1：WSL2 安装（推荐）

管理员 PowerShell 执行，一键安装 Linux 子系统

wsl –install

安装 Ubuntu 后，直接参照上文 Ubuntu Redis 安装教程 部署新版本 Redis。

方案2：Windows 压缩包安装

下载地址：https://github.com/microsoftarchive/redis/releases 下载 Redis-x64-3.0.504.zip，解压到纯英文无空格路径

# 启动服务端
redis-server.exe redis.windows.conf

# 启动客户端（新窗口执行）
redis-cli.exe

Windows 服务开机自启（管理员CMD）

# 注册服务
redis-server –service-install redis.windows.conf

# 启动服务
redis-server –service-start

# 停止服务
redis-server –service-stop

# 卸载服务
redis-server –service-uninstall

五、Docker 一键安装（极速体验）

无需配置环境，一条命令部署可直接使用，适合快速测试

# 拉取最新 Redis 镜像
docker pull redis

# 启动容器（设置密码、端口映射）
docker run -d –name redis -p 6379:6379 redis redis-server –requirepass "123456"

# 进入 Redis 客户端
docker exec -it redis redis-cli -a 123456

六、Redis 常用核心命令

# 本地无密码连接
redis-cli

# 远程带密码连接
redis-cli -h 服务器IP -p 6379 -a 密码

# 优雅关闭服务
redis-cli shutdown

# 查看服务状态
systemctl status redis

七、生产环境安全配置（必看）

生产环境禁止裸奔部署！！！

• 设置 requirepass 密码，禁止无密码访问

• 合理配置 bind 绑定 IP，不直接开放 0.0.0.0

• 防火墙、云服务器安全组仅放行指定 IP 端口

• 关闭危险命令（flushall、flushdb 等）

• 禁止使用 Windows 版本 Redis 上线生产

八、常见报错与踩坑总结

1. make 报错：gcc: 未找到命令

解决方案：执行 yum install gcc make -y 安装编译依赖

2. 远程无法连接 Redis

排查步骤： 1. 配置文件 bind 未限制本地回环 2. 服务器防火墙放行 6379 端口 3. 云服务器安全组开放端口 4. 已正确配置访问密码

3. 关闭终端 Redis 即停止

解决方案：开启守护进程，daemonize yes

4. Docker Redis 外部无法连接

解决方案：启动命令必须加 -p 6379:6379 端口映射