手把手教你用 Docker 部署 Redis

news/2025/10/6 9:25:07/文章来源:https://www.cnblogs.com/sourcecodebeat/p/19127290/docker-redis

Redis是一款开源的高性能内存数据存储系统，常用作数据库、缓存和消息代理。它支持字符串、哈希、列表等多种数据结构，凭借内存存储特性提供毫秒级响应速度，广泛应用于高并发场景下的数据快速访问。

使用Docker部署Redis具有显著优势：首先，容器化确保了环境一致性，避免因操作系统、依赖库差异导致的"在我这能跑"问题；其次，部署过程标准化，通过简单命令即可快速启动，大幅降低配置复杂度；再者，容器隔离性强，能有效避免Redis与其他应用的资源冲突；此外，便于版本管理和快速迁移，可轻松切换不同Redis版本或在不同环境间移植。

1、查看 Redis 镜像详情

你可以在轩辕镜像中找到 Redis 镜像页面：
👉 https://xuanyuan.cloud/r/library/redis

在镜像页面中，你会看到多种拉取方式，下面我们逐一说明如何部署。

2、下载 Redis 镜像

2.1 使用轩辕镜像登录验证的方式拉取

docker pull docker.xuanyuan.run/library/redis:latest

2.2 拉取后改名

docker pull docker.xuanyuan.run/library/redis:latest \&& docker tag docker.xuanyuan.run/library/redis:latest library/redis:latest \&& docker rmi docker.xuanyuan.run/library/redis:latest

说明：

docker pull：从轩辕镜像加速拉取镜像
docker tag：将镜像重命名为官方标准名称 library/redis:latest，后续运行命令更简洁
docker rmi：删除临时镜像标签，避免占用额外存储空间

2.3 使用免登录方式拉取（推荐）

基础拉取命令：

docker pull xxx.xuanyuan.run/library/redis:latest

带重命名的完整命令：

docker pull xxx.xuanyuan.run/library/redis:latest \&& docker tag xxx.xuanyuan.run/library/redis:latest library/redis:latest \&& docker rmi xxx.xuanyuan.run/library/redis:latest

说明：
免登录方式无需配置账户信息，新手可直接使用；镜像内容与 docker.xuanyuan.run 源完全一致，仅拉取地址不同。

2.4 官方直连方式

若网络可直连 Docker Hub，或已配置轩辕镜像加速器，可直接拉取官方镜像：

docker pull library/redis:latest

2.5 查看镜像是否拉取成功

docker images

若输出类似以下内容，说明镜像下载成功：

REPOSITORY     TAG       IMAGE ID       CREATED        SIZE
library/redis  latest    7614ae9453d1   3 weeks ago    120MB

3、部署 Redis

以下使用已下载的 library/redis:latest 镜像，提供三种部署方案，可根据场景选择。

3.1 快速部署（最简方式）

适合测试或临时使用，命令如下：

# 启动 Redis 容器，命名为 redis-test
# 宿主机 6379 端口映射到容器 6379 端口（Redis 默认端口）
docker run -d --name redis-test -p 6379:6379 library/redis:latest

核心参数说明：

--name redis-test：为容器指定名称，便于后续管理（如停止、重启）
-p 6379:6379：端口映射，格式为「宿主机端口:容器端口」
-d：后台运行容器

验证方式：
在宿主机执行：

docker exec -it redis-test redis-cli ping

输出 PONG 即表示 Redis 运行正常。

3.2 持久化部署（推荐方式，适合实际项目）

通过挂载宿主机目录，实现「数据持久化」「配置独立管理」，步骤如下：

第一步：创建宿主机目录

mkdir -p /data/redis/{data,conf}

第二步：准备配置文件

新建 /data/redis/conf/redis.conf，写入简单配置：

bind 0.0.0.0
protected-mode no
port 6379
appendonly yes

说明：

bind 0.0.0.0：允许外部访问（生产环境可改为内网 IP）
appendonly yes：启用 AOF 持久化，避免数据丢失

第三步：启动容器并挂载目录

docker run -d --name redis-web \-p 6379:6379 \-v /data/redis/data:/data \-v /data/redis/conf/redis.conf:/usr/local/etc/redis/redis.conf \library/redis:latest redis-server /usr/local/etc/redis/redis.conf

目录映射说明：

宿主机目录	容器内目录	用途
/data/redis/data	/data	Redis 数据持久化
/data/redis/conf/	/usr/local/etc/redis/redis.conf	Redis 配置文件

3.3 docker-compose 部署（适合企业级场景）

通过 docker-compose.yml 统一管理容器配置，支持一键启动/停止。

第一步：创建 docker-compose.yml 文件

version: '3'
services:redis:image: library/redis:latestcontainer_name: redis-serviceports:- "6379:6379"volumes:- ./data:/data- ./conf/redis.conf:/usr/local/etc/redis/redis.confcommand: ["redis-server", "/usr/local/etc/redis/redis.conf"]restart: always

第二步：启动服务

在 docker-compose.yml 所在目录执行：

docker compose up -d

补充说明：

修改配置文件后可直接 docker restart redis-service 生效
停止服务命令：docker compose down
查看状态：docker compose ps

4、结果验证

通过以下方式确认 Redis 服务正常运行：

4.1 客户端验证

redis-cli -h 服务器IP -p 6379
> ping
PONG

4.2 查看容器状态

docker ps

若 STATUS 列显示 Up，说明容器正常运行。

4.3 查看容器日志

docker logs redis-web

无报错信息即表示服务启动正常。

5、常见问题

5.1 无法远程连接？

排查方向：

防火墙：确认宿主机 6379 端口已开放

ufw allow 6379/tcp

firewall-cmd --add-port=6379/tcp --permanent && firewall-cmd --reload

配置问题：确认 redis.conf 中 bind 0.0.0.0、protected-mode no

5.2 如何设置密码？

在 redis.conf 文件中添加：
```
requirepass 你的密码
```
修改后重启容器：
```
docker restart redis-web
```
验证：
```
redis-cli -a 你的密码 ping
```

5.3 数据丢失怎么办？

AOF 持久化：启用 appendonly yes（推荐）
RDB 快照：默认开启，可在配置文件调整快照规则
外部备份：定期将 /data/redis/data 目录打包存档

5.4 容器内时区不正确？

在启动容器时，增加环境变量：

-e TZ=Asia/Shanghai

完整示例：

docker run -d -e TZ=Asia/Shanghai \--name redis-web \-p 6379:6379 \-v /data/redis/data:/data \-v /data/redis/conf/redis.conf:/usr/local/etc/redis/redis.conf \library/redis:latest redis-server /usr/local/etc/redis/redis.conf