使用 Docker 部署 Redis 的完整指南

更新说明：本文基于 Redis 8.0.2 稳定版本，通过 Docker 容器技术实现快速部署，重点讲解配置文件优化与安全加固方案，适用于生产环境部署参考。

一、环境准备

1.1 系统要求

• Linux 系统（CentOS 7+/Ubuntu 20.04+）
• Docker 20.10.0+
• Docker Compose 1.29.0+

1.2 软件版本

• Redis: 8.0.2
• 持久化存储：AOF + RDB 混合模式
• 安全策略：密码认证 + 防火墙限制

二、部署流程

2.1 拉取官方镜像

# 拉取指定版本镜像
docker pull redis:8.0.2
# 验证镜像
docker images -a

2.2 创建配置体系

目录结构规划

mkdir -p /data/dockerData/redis/{conf,data,logs}
touch /data/dockerData/redis/conf/redis.config

配置文件详解（redis.config）

# Redis 服务器配置
# 绑定 IP 地址
#bind 127.0.0.1
# 服务器端口号
port 6379
# 配置密码
requirepass your_password
# 服务器运行模式，Redis 以守护进程方式运行
daemonize no
# 持久化配置
appendonly yes
appendfsync everysec
# 客户端闲置超时
timeout 60
# 最大连接数
maxclients 10000
tcp-keepalive 300
# 持久化规则
save 900 1
save 300 10
save 60 10000
# 线程数
tcp-backlog 511
# 数据库数量
databases 16
# AOF 配置
auto-aof-rewrite-percentage 100
auto-aof-rewrite-min-size 64mb
# 慢查询阈值
slowlog-log-slower-than 10000
slowlog-max-len 128
# 日志级别
loglevel notice
logfile stdout
# 内存调优参数
hash-max-ziplist-entries 512
list-max-ziplist-entries 512
set-max-intset-entries 512
zset-max-ziplist-entries 128

2.3 启动容器服务

完整部署命令

docker run \
  -p 6379:6379 \
  --name redis \
  -v /data/dockerData/redis/conf/redis.config:/etc/redis/redis.conf \
  -v /data/dockerData/redis/data:/data \
  -v /data/dockerData/redis/logs:/logs \
  -d \
  redis:8.0.2 \
  redis-server /etc/redis/redis.conf

参数解析：

参数	作用
-d	后台运行
-p	端口映射
-v	卷挂载（配置/数据/日志）

三、验证与调试

3.1 容器状态检查

docker ps -a

3.2 客户端连接测试

# 进入容器
docker exec -it redis bash
# 启动客户端
redis-cli
# 认证操作
AUTH your_password
# 测试写入
SET test_key "Hello Redis"
# 验证读取
GET test_key

四、安全加固

4.1 防火墙配置

firewall-cmd --zone=public --add-port=6379/tcp --permanent
firewall-cmd --reload
firewall-cmd --list-all | grep ports

4.2 访问控制

• 网络层：云平台控制台限制 IP 白名单
• 应用层：通过 bind 指令限制监听地址
• 认证层：强制密码验证 + 命令重命名

五、常见问题排查

5.1 启动失败解决方案

# 查看容器日志
docker logs redis --tail 50
# 常见错误及处理：
# 1. 配置文件路径错误 → 检查-v 参数映射
# 2. 端口冲突 → 修改-p 参数端口号
# 3. 权限不足 → 添加--privileged 参数

5.2 内存溢出处理

• 监控 used_memory 指标
• 优化 maxmemory-policy 策略
• 使用 Redis Cluster 分片集群

六、性能优化建议

优化维度	推荐方案
内存管理	启用 maxmemory+ 合适的淘汰策略
持久化	AOF+RDB 混合模式
连接池	客户端设置合理超时时间
网络	使用 Pipeline 批量操作
监控	集成 Prometheus+Grafana

七、扩展部署方案

7.1 主从复制架构

slaveof <master-ip> 6379
masterauth your_password

7.2 高可用集群

使用 Docker Compose 部署 3 节点集群：

version: '3'
services:
  redis-node-1:
    image: redis:8.0.2
    ports:
      - "6380:6379"
    command: redis-server --cluster-enabled yes --cluster-config-file nodes.conf --cluster-node-timeout 5000

扩展阅读：Redis 官方文档