Docker 安装 Redis 并实现持久化

在 Docker 中安装 Redis 并实现持久化，需通过卷挂载（Volume Mount）将容器内的数据目录映射到主机，同时需在 Redis 配置文件中启用持久化选项（AOF 或 RDB）。以下是详细步骤和配置说明：

一、核心步骤

1. 创建本地数据和配置目录
   在主机上创建目录用于存储 Redis 数据和配置文件（例如 /data/redis）：

   bash

   mkdir -p /data/redis/data # 存储持久化文件（RDB/AOF）

   mkdir -p /data/redis/conf # 存储 Redis 配置文件

2. 获取 Redis 配置文件
   从 Redis 官方仓库下载与镜像版本匹配的 redis.conf 文件，或手动创建并编辑以下关键配置：

   ini

   # 开启 AOF 持久化（推荐）

   appendonly yes

   appendfilename "appendonly.aof"

   appendfsync everysec # 每秒同步一次，平衡性能与数据安全

   # 或开启 RDB 持久化（二选一）

   save 900 1 # 900 秒内至少 1 个 key 变化则触发快照

   save 300 10 # 300 秒内至少 10 个 key 变化则触发快照

   save 60 10000 # 60 秒内至少 10000 个 key 变化则触发快照

   dbfilename dump.rdb # RDB 文件名

   # 其他必要配置

   bind 0.0.0.0 # 允许所有 IP 连接（生产环境需限制）

   protected-mode no # 关闭保护模式（需配合密码使用）

   requirepass yourpassword # 设置密码（必填）

3. 运行 Redis 容器并挂载卷
   使用 -v 参数将主机目录挂载到容器，并指定配置文件：

   bash

   docker run -d \

   --name redis-persistent \

   -p 6379:6379 \

   -v /data/redis/data:/data \

   -v /data/redis/conf/redis.conf:/usr/local/etc/redis/redis.conf \

   redis:7.0.4 \

   redis-server /usr/local/etc/redis/redis.conf

   参数说明：

   • -v /data/redis/data:/data：将容器内的 /data 目录（存储 RDB/AOF 文件）映射到主机。
   • -v /data/redis/conf/redis.conf:/usr/local/etc/redis/redis.conf：挂载自定义配置文件。
   • redis-server /usr/local/etc/redis/redis.conf：指定容器启动时使用的配置文件路径。

二、持久化方案对比

推荐配置：

• 生产环境：启用 AOF（appendonly yes）并设置 appendfsync everysec，同时定期备份 RDB 文件。
• 测试环境：可仅启用 RDB 以简化配置。

三、验证持久化

1. 写入测试数据：

   bash

   docker exec -it redis-persistent redis-cli -a yourpassword

   127.0.0.1:6379> SET test_key "Hello, Redis!"

   127.0.0.1:6379> EXIT

2. 检查持久化文件：
   在主机 /data/redis/data 目录下应生成 appendonly.aof（AOF 启用时）或 dump.rdb（RDB 启用时）。

3. 重启容器并验证数据：

   bash

   docker restart redis-persistent

   docker exec -it redis-persistent redis-cli -a yourpassword

   127.0.0.1:6379> GET test_key # 应返回 "Hello, Redis!"

四、高级优化

1. 性能调优：
   • AOF 配置 appendfsync everysec 而非 always，减少磁盘 I/O 压力。
   • 使用 SSD 存储持久化文件目录。
2. 安全加固：
   • 限制 Redis 绑定 IP（如 bind 192.168.1.100）。
   • 启用 TLS 加密（需额外配置证书）。
3. 集群部署：
   若需高可用，可结合 Redis Sentinel 或 Cluster 模式，并确保每个节点的持久化配置一致。

五、常见问题

1. 权限错误：
   若容器启动失败并提示 Permission denied，确保主机目录权限正确：

   bash

   chown -R 999:999 /data/redis/data # Redis 容器默认用户 UID/GID 为 999

2. 配置不生效：
   检查容器内是否实际加载了自定义配置文件：

   bash

   docker exec -it redis-persistent cat /usr/local/etc/redis/redis.conf

3. 数据未持久化：

   • 确认 appendonly yes 或 save 规则已正确配置。
   • 检查主机目录是否写入成功（如 ls /data/redis/data）。