Docker 完整安装 Redis

Docker 完整安装 Redis，包含镜像拉取、基础启动、带持久化 / 密码 / 指定端口（6379）的生产环境启动，以及验证、常用操作等内容，兼顾快速测试和生产使用。

一、前置条件

确保你的服务器 / 本地环境已安装 Docker（若未安装，可参考以下快速安装命令，以 CentOS 为例，Ubuntu/Mac/Windows 可对应调整）：

bash 复制代码

# CentOS Docker 快速安装
yum install -y yum-utils
yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
yum install -y docker-ce docker-ce-cli containerd.io

# 启动Docker并设置开机自启
systemctl start docker
systemctl enable docker

# 验证Docker是否安装成功
docker --version

二、步骤 1：拉取 Redis Docker 镜像

首先从 Docker Hub 拉取官方 Redis 镜像（可指定版本，如7.0，或使用latest获取最新版）：

bash 复制代码

# 拉取最新版Redis镜像
docker pull redis:latest

#可选：拉取指定版本（推荐生产环境使用固定版本，更稳定）
docker pull redis:7.0
# 查看已拉取的Redis镜像
docker images | grep redis

三、步骤 2：两种启动方式（按需选择）

方式 1：快速启动（测试 / 临时使用，无持久化，无密码）

适合快速测试 Redis 功能，容器删除后数据丢失，命令简单：

bash 复制代码

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

参数说明：

-d：后台运行容器

--name redis-test：自定义容器名称（方便后续操作）

-p 6379:6379：端口映射（本地 6379 ↔ 容器 6379）

方式 2：生产环境启动（带持久化 + 密码 + 6379 端口 + 开机自启）

这是推荐方式，数据持久化到本地目录，带访问密码，容器异常自动重启，整合之前的所有配置：

bash 复制代码

# 第一步：创建本地目录（存放配置和持久化数据）
# 创建配置目录和数据目录，避免容器删除后数据丢失
mkdir -p /usr/local/redis/conf /usr/local/redis/data
第二步：创建 / 配置 Redis 配置文件
bash
运行
# 快速创建并编辑redis.conf配置文件
vi /usr/local/redis/conf/redis.conf
将以下配置复制到文件中（包含持久化、密码、端口、允许外部访问等核心配置）：
ini
# 核心配置
port 6379  # 容器内Redis监听6379端口（默认，可自定义）
requirepass your_redis_password  # 替换为你的自定义密码（如123456@Redis）
protected-mode no  # 关闭保护模式（配合bind 0.0.0.0允许外部访问）
daemonize no  # 关闭后台运行（Docker容器内必须关闭，否则容器会立即退出）
bind 0.0.0.0  # 允许所有IP访问Redis
dir /data  # 持久化文件存放目录（与容器挂载目录对应）

# RDB持久化配置（默认开启，优化参数）
save 900 1
save 300 10
save 60 10000
stop-writes-on-bgsave-error yes
rdbcompression yes
dbfilename dump.rdb

# AOF持久化配置（开启，更高数据安全性）
appendonly yes
appendfilename "appendonly.aof"
appendfsync everysec
auto-aof-rewrite-percentage 100
auto-aof-rewrite-min-size 64mb

第三步：Docker 启动 Redis（完整参数）

bash 复制代码

docker run -d 
  --name redis-prod 
  --restart always 
  -p 6379:6379 
  -v /usr/local/redis/conf/redis.conf:/etc/redis/redis.conf 
  -v /usr/local/redis/data:/data 
  redis:latest 
  redis-server /etc/redis/redis.conf

参数详解：

--restart always：容器开机自启，异常退出时自动重启（生产环境必备）

第一个-v：本地配置文件挂载到容器内，确保配置永久生效

第二个-v：本地数据目录挂载到容器/data，持久化文件（dump.rdb/appendonly.aof）保存在本地

redis-server /etc/redis/redis.conf：指定使用挂载的配置文件启动 Redis

四、步骤 3：验证 Redis 是否安装启动成功

1. 查看容器运行状态

bash 复制代码

# 查看Redis容器是否在运行
docker ps | grep redis

# 若未运行，查看日志排查问题
# docker logs redis-prod（替换为你的容器名）

2. 连接 Redis 并验证功能

bash 复制代码

# 方式1：进入容器内连接Redis
docker exec -it redis-prod redis-cli  # 替换为你的容器名（如redis-test/redis-prod）

# 方式2：本地直接连接（已端口映射6379）
redis-cli -h 127.0.0.1 -p 6379
验证密码（仅生产环境启动方式需验证）
bash
运行
# 连接后执行命令，未认证会报错
set test_key "docker_redis"
# 提示：(error) NOAUTH Authentication required.

# 输入密码认证
auth your_redis_password  # 替换为你设置的密码，返回OK即认证成功

# 验证数据写入
set test_key "docker_redis"
get test_key  # 返回"docker_redis"，说明正常可用
3. 验证持久化（仅生产环境启动方式需验证）
bash
运行
# 1. 写入测试数据后，停止并删除Redis容器
docker stop redis-prod
docker rm redis-prod

# 2. 用相同命令重新启动容器
docker run -d 
  --name redis-prod 
  --restart always 
  -p 6379:6379 
  -v /usr/local/redis/conf/redis.conf:/etc/redis/redis.conf 
  -v /usr/local/redis/data:/data 
  redis:latest 
  redis-server /etc/redis/redis.conf

# 3. 重新连接并查看数据
docker exec -it redis-prod redis-cli
auth your_redis_password
get test_key  # 返回"docker_redis"，说明持久化生效
五、Redis 常用 Docker 操作
bash
运行
# 启动Redis容器
docker start redis-prod

# 停止Redis容器
docker stop redis-prod

# 重启Redis容器
docker restart redis-prod

# 查看Redis容器日志
docker logs -f redis-prod  # -f 实时查看日志

# 删除Redis容器（删除前需先停止）
docker stop redis-prod
docker rm redis-prod

# 进入Redis容器内部（非客户端）
docker exec -it redis-prod /bin/bash

总结

核心流程：安装Docker → 拉取Redis镜像 → 选择启动方式（测试/生产） → 验证功能

快速测试：使用无持久化命令，一键启动，适合临时使用；

生产环境：必须挂载配置 / 数据目录（-v参数）、设置密码、开启自启（--restart always），确保数据不丢失、服务稳定；

关键验证：容器运行状态 → 密码认证 → 数据写入与持久化恢复，确保所有功能正常。