持久化 on Liangweidong's blog

Redis Docker 实战：6.x/8.x、持久化、bitnami 镜像与生产配置

Wed, 15 Dec 2021 00:00:00 +0800

Redis 6.0 引入了多线程 I/O、ACL 权限、SSL 加密；8.x（2024）改进了 RDB 加载速度、模块化。生产环境的 Redis 在 Docker 里跑有几个常见问题：持久化怎么配、密码怎么改、主从怎么搭、要不要关 RDB。这篇文章把 Redis 6.0 到 8.6 的官方镜像和 bitnami 镜像的部署、配置、调优一次性收齐。

阅读对象：日常用 Redis 做缓存/分布式锁/排行榜/限流，要在容器里跑单实例或主从，关注内存、持久化、ACL 的同学。 覆盖范围：官方 redis:6.0/8.6 镜像启动；bitnami/redis 镜像（推荐生产用）；redis.conf 关键配置；RDB / AOF / 混合持久化关闭；主从复制（docker run + 配置文件）；客户端连接与排错。

一、Redis 在 Docker 里的几个关键决策

决策	选项	适用
镜像	官方 `redis` / `bitnami/redis`	官方更轻，bitnami 多 healthcheck + 非 root
持久化	RDB（默认）/ AOF / 混合 / 全关	缓存场景：关；持久场景：开
网络模式	host / bridge	性能优先 host，安全优先 bridge
部署形态	单机 / 主从 / Sentinel / Cluster	单机演示，主从高可用，Cluster 大数据量
内存淘汰	noeviction / allkeys-lru 等	写多：noeviction；缓存：allkeys-lru

二、官方 redis 镜像

2.1 拉取与启动

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 拉镜像
docker pull redis:6.0.3-alpine3.11
docker pull redis:8.6.3-alpine3.23

# 启动（host 网络，性能好）
docker run -d --name redis \
 --net=host \
 --restart=always \
 redis:8.6.3-alpine3.23 \
 redis-server /usr/local/etc/redis/redis.conf

alpine 镜像比 debian 镜像小 100MB+，但 musl libc 的 redis-benchmark 等工具有兼容性问题，生产一般用 debian 镜像。

2.2 创建宿主机目录

1
2


mkdir /home/docker/redis/{conf,data,logs} -p
cd /home/docker/redis

2.3 准备 redis.conf

1
2
3
4
5
6
7
8
9


# 下载官方模板
wget https://raw.githubusercontent.com/redis/redis/8.6/redis.conf \
 -O /home/docker/redis/conf/redis.conf

# 改几个关键参数
sed -i 's/logfile ""/logfile "access.log"/' /home/docker/redis/conf/redis.conf
sed -i 's/# requirepass foobared/requirepass {{REDACTED}}/' /home/docker/redis/conf/redis.conf
sed -i 's/appendonly no/appendonly yes/' /home/docker/redis/conf/redis.conf
sed -i 's/bind 127.0.0.1/bind 0.0.0.0/' /home/docker/redis/conf/redis.conf

2.4 启动（挂载配置 + 数据）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


docker run \
 -p 6379:6379 \
 -v /home/docker/redis/data:/data \
 -v /home/docker/redis/conf/redis.conf:/etc/redis/redis.conf \
 --net mynetwork --ip 172.18.0.5 \
 --privileged=true \
 --name redis \
 --restart=always \
 -d redis:6.0.3-alpine3.11 \
 redis-server /etc/redis/redis.conf

2.5 客户端连接

1
2
3
4
5
6


# 容器内
docker exec -it redis /bin/sh
redis-cli -h 127.0.0.1 -p 6379 -a {{REDACTED}}

# 宿主机直接连
docker run -it --link redis:redis --rm redis redis-cli -h redis -p 6379

2.6 docker-compose 模板

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


version: "3"
services:
 redis:
 container_name: redis
 image: <your-public-ip>:13001/base/redis:6.0.3-alpine3.11
 network_mode: "host"
 command: redis-server /etc/redis/redis.conf
 restart: always
 volumes:
 - /home/docker/redis/data:/data:rw
 - /home/docker/redis/conf/redis.conf:/etc/redis/redis.conf
 - /home/docker/redis/logs:/logs
 privileged: true
 environment:
 - TZ=Asia/Shanghai
 - LANG=en_US.UTF-8

三、bitnami/redis 镜像（生产推荐）

bitnami/redis 的优势：非 root 进程、Tini init、healthcheck、Redis 风格环境变量（REDIS_PASSWORD 等都大写）、自带 Sentinel 模板。

3.1 启动

1
2
3
4
5
6
7


docker pull bitnami/redis:6.2.14-debian-12-r21

docker run -d \
 --name redis \
 -p 6379:6379 \
 -e REDIS_PASSWORD={{REDACTED}} \
 bitnami/redis:6.2.14-debian-12-r21

环境变量 REDIS_PASSWORD：自动生成 requirepass。比直接改 conf 文件方便。

四、持久化策略

4.1 三种持久化机制

机制	默认	特点	适用
RDB（快照）	开启	周期性 dump，体积小，恢复快	接受分钟级数据丢失
AOF（追加日志）	关闭	每条写命令追加日志，最多丢 1 秒数据	不能丢数据
混合持久化	7.0+ 默认	RDB + AOF 结合	大多数生产场景

4.2 关闭持久化（纯缓存场景）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# redis.conf
# 1. 关闭 RDB 自动快照
save ""

# 2. 关闭 AOF 增量持久化
appendonly no

# 3. 关闭混合持久化（7.0+）
rdb-aof-use-rdb-preamble no

# 4. 主从同步后立刻删除 RDB 临时文件
rdb-del-sync-files yes

重启服务后生效。这种配置相当于"纯缓存"，重启 = 数据全清，只用于缓存场景。

4.3 推荐生产配置

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 1. 开启 AOF（默认关）
appendonly yes
appendfsync everysec # 每秒刷盘，最多丢 1 秒

# 2. RDB 兜底
save 3600 1 # 1 小时至少 1 个 key 变化
save 300 100 # 5 分钟至少 100 个 key 变化
save 60 10000 # 1 分钟至少 10000 个 key 变化

# 3. 7.0+ 混合持久化
rdb-aof-use-rdb-preamble yes

五、主从复制

5.1 启动 master

1
2
3
4
5
6
7


docker run -d --name redis-master \
 -p 6379:6379 \
 -v /home/docker/redis/data:/data \
 -v /home/docker/redis/conf/redis.conf:/etc/redis/redis.conf \
 --restart=always \
 redis:6.0.3-alpine3.11 \
 redis-server /etc/redis/redis.conf

5.2 启动 slave

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


# 1. 查 master 内部 IP
docker inspect redis-master | grep IPAddress
# "IPAddress": "172.18.0.X"

# 2. 准备 slave 配置文件（追加）
cat << 'EOF' >> /home/docker/redis-slave/conf/redis.conf
replicaof 172.18.0.X 6379
masterauth {{REDACTED}}
replica-read-only yes
EOF

# 3. 启动 slave
docker run -d --name redis-slave \
 -p 6380:6379 \
 -v /home/docker/redis-slave/data:/data \
 -v /home/docker/redis-slave/conf/redis.conf:/etc/redis/redis.conf \
 --restart=always \
 redis:6.0.3-alpine3.11 \
 redis-server /etc/redis/redis.conf

从 Redis 5.0 开始，slaveof 改名为 replicaof，但旧名仍然兼容。

5.3 验证复制

1
2
3
4
5
6


# master 写入
docker exec -it redis-master redis-cli -a {{REDACTED}} set test_key hello

# slave 读取
docker exec -it redis-slave redis-cli -a {{REDACTED}} get test_key
# "hello"

六、常见排错

6.1 连接被拒

1
2
3
4
5
6
7
8


# 1. 看容器是否在跑
docker ps | grep redis

# 2. 看日志
docker logs redis

# 3. 看网络
docker network inspect bridge | grep redis

6.2 密码忘了

1
2
3
4
5
6
7


# 1. 进容器，关掉 requirepass
docker exec -it redis bash
redis-cli
CONFIG SET requirepass ""

# 2. 改 conf 文件持久化
echo "requirepass <new_password>" >> /home/docker/redis/conf/redis.conf

6.3 内存满

1
2
3
4
5


# 看使用情况
redis-cli info memory | grep used_memory_human

# 触发淘汰
CONFIG SET maxmemory-policy allkeys-lru

七、Redis 6.x/7.x/8.x 关键差异

版本	关键特性	适合
6.0	ACL、多线程 I/O、SSL	主流稳定
6.2	细粒度命令权限	多租户
7.0	混合持久化、Redis Functions、sharded pub/sub	新功能
7.2	改进 listpack、SCAN 性能	性能敏感
8.0	异步 I/O、模块化	新项目首选
8.6	进一步优化 RDB 加载	大 key 场景

八、扩展阅读

Redis 官方镜像：hub.docker.com/_/redis
bitnami/redis：hub.docker.com/r/bitnami/redis
Redis 配置文件详解：redis.io/docs/manual/config
Redis 持久化文档：redis.io/docs/management/persistence
Redis Sentinel 文档：redis.io/docs/management/sentinel

Docker Volume 深度实践：命名卷、bind mount 与跨主机挂载

Tue, 15 Dec 2015 00:00:00 +0800

容器的文件系统是临时的——docker rm 时容器层全部销毁。任何需要持久化的数据，都必须挂载到 Volume 或 bind mount。这一篇把 Volume 的生命周期、Copy-on-Write 机制、跨主机挂载、共享卷在容器间传文件、清理策略一次性收齐。

阅读对象：需要把数据库 / 上传文件 / 配置中心等状态放到容器里的开发者、运维同学 覆盖范围：volumes vs bind mounts vs tmpfs + 命名卷操作 + Copy-on-Write + docker-compose 卷写法 + NFS / SSHFS / vieux 跨主机 + 共享卷传文件 + 清理策略

一、为什么需要 Volume

容器分层结构：

镜像层（Image Layer）：只读、共享，多个容器可共用
容器层（Container Layer）：读写、临时，容器销毁就消失

如果数据写在容器层，docker rm 那一刻数据就没了。Volume 就是把数据"挂"到宿主机文件系统上，绕开容器层，让数据活过容器生命周期。

二、三种挂载方式

Docker 1.9+（2015-11 GA）正式引入了 named volume（命名卷），与 bind mount、tmpfs 并列为三种挂载类型：

类型	路径	持久化	性能	适用
Volume	Docker 管理（默认 `/var/lib/docker/volumes/`）	是	优	数据库、上传文件、共享数据
bind mount	任意宿主机路径	是	优	配置文件、特殊路径、debug
tmpfs	宿主机内存	否（重启丢）	极优	敏感数据、临时缓存

When to use：

Volume（推荐）：数据库、长期存储——Docker 帮你管理路径、迁移、备份

bind mount：配置文件、日志、需要直接编辑宿主机文件的场景

tmpfs：密码、token、不想落盘的临时缓存

三、Volume 操作

3.1 命名卷的生命周期

1
2
3
4
5
6
7
8


# 创建（指定名字）
docker volume create data_volume

# 列出
docker volume ls

# 看详情
docker volume inspect data_volume

inspect 输出：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


[
 {
 "CreatedAt": "2022-07-28T11:02:14+08:00",
 "Driver": "local",
 "Labels": null,
 "Mountpoint": "/var/lib/docker/volumes/data_volume/_data",
 "Name": "data_volume",
 "Scope": "local"
 }
]

关键字段：

Driver: local：默认驱动，只能用于当前 Docker 主机上的容器

Scope: local：本地范围（要跨主机挂载需要用其他 driver）

Mountpoint：数据在宿主机上的实际位置

3.2 隐式创建（run 时指定卷名）

如果不显式 docker volume create，docker run -v name:/path 会自动创建：

1

docker run -it --rm --name nginx -p 8080:80 -v demo-earthly:/usr/share/nginx/html nginx

3.3 Dockerfile 中声明

1
2
3
4


FROM nginx:latest

RUN echo "<h1>Hello from Volume</h1>" > /usr/share/nginx/html/index.html
VOLUME /usr/share/nginx/html

构建并运行：

1
2
3
4


docker build -t demo-earthly .
docker run -p 8080:80 demo-earthly
docker volume ls
# 输出随机卷名：20879e3f0bfaf0eed63cb7f37c4b9545084a703f888a230b8aedc2082c836281

每次启动新容器都会创建新卷（匿名卷），内容是 /usr/share/nginx/html。

3.4 删除

1
2
3
4
5
6
7
8


# 删指定卷
docker volume rm data_volume

# 删所有未挂载的卷
docker volume prune

# 删 dangling 镜像 + 未挂载卷（危险）
docker system prune -af --volumes

重要约束：docker volume rm 不能删正在被容器或服务使用的卷。docker volume prune 默认不会删正在使用的卷，但加 -f 也不会绕过这个保护——保护在 daemon 层。

四、Copy-on-Write 机制

docker build 时每条指令构建一层，只读。docker run 时构建一个读写容器层。

修改容器内某个文件时：

如果该文件在镜像层（只读），Docker 会从镜像层"复制"一份到容器层
容器层是读写层，修改只在容器层生效
容器销毁，容器层消失，修改也没了——这就是为什么需要 Volume

典型场景：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


# 容器内
echo "new content" > /etc/nginx/nginx.conf

# 容器外看
docker exec -it <container> cat /etc/nginx/nginx.conf
# 输出 "new content"

# 删容器
docker rm -f <container>

# 启动新容器
docker run -d nginx

# 新容器内的 /etc/nginx/nginx.conf 是默认的
# 原因：刚才的"new content"在容器层里，随容器销毁而消失

重要结论：容器层的修改不能跨容器共享。要让数据持久 + 跨容器共享，必须 Volume / bind mount。

五、bind mount vs Volume

5.1 语法对比

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# Volume（短语法）
docker run -d -v mydata:/var/lib/mysql mysql:5.7

# bind mount（短语法）
docker run -d -v /host/path:/container/path nginx

# 长语法（--mount）— 更显式
docker run -d \
 --mount type=volume,source=mydata,target=/var/lib/mysql \
 mysql:5.7

docker run -d \
 --mount type=bind,source=/host/path,target=/container/path \
 nginx

5.2 长语法参数说明

参数	含义
`type`	`volume` / `bind` / `tmpfs`
`source` / `src`	卷名 / 宿主机路径
`destination` / `dst` / `target`	容器内路径
`readonly` / `ro`	是否只读挂载
`volume-opt`	额外 mount 选项（可多次）

5.3 实战：初始化数据到 Volume

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


# 创建两个卷
docker volume create test_nginx_html
docker volume create test_nginx_conf

# 准备数据到宿主机
sudo cp -r /home/nginx/html/* /var/lib/docker/volumes/test_nginx_html/_data
sudo cp /home/nginx/conf/my_custom.conf /var/lib/docker/volumes/test_nginx_conf/_data

# 启动容器，volume 自动挂载
docker run -d \
 --restart=always \
 -p 8080:8080 \
 --name test_nginx \
 --mount src=test_nginx_html,dst=/app \
 --mount src=test_nginx_conf,dst=/opt/bitnami/nginx/conf/server_blocks \
 bitnami/nginx:latest

Why 直接 cp 到 _data：volume 在宿主机上的真实路径是 /var/lib/docker/volumes/<name>/_data，容器启动前预先填数据是常见模式。也可以用 docker cp 复制到运行中的容器目录，但已挂载的 volume 路径会变。

六、docker-compose 里的卷

6.1 bind mount 写法

1
2
3
4
5
6
7
8


version: "3.2"
services:
 web:
 image: nginx:latest
 ports:
 - "8080:80"
 volumes:
 - ./target:/usr/share/nginx/html

6.2 命名卷 + 多容器共享

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


version: "3.2"
services:
 web:
 image: nginx:latest
 ports:
 - "8080:80"
 volumes:
 - html_files:/usr/share/nginx/html
 web1:
 image: nginx:latest
 ports:
 - "8081:80"
 volumes:
 - html_files:/usr/share/nginx/html

volumes:
 html_files:

docker compose up 时自动创建 <project_name>_html_files 命名卷，html_files 在 web 和 web1 之间共享。

6.3 引用已存在的卷

1
2
3


volumes:
 html_files:
 external: true

要先用 docker volume create html_files 创建，compose 才不会报错说找不到。

七、跨主机挂载：NFS

默认的 local driver 只能在当前主机用。Docker 1.9+ 内置支持 NFS 挂载（用 local driver 即可），不需要装额外插件：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 安装 NFS 客户端
apt install nfs-common # Debian/Ubuntu
yum install -y nfs-utils # CentOS/RHEL

# 创建 NFS 卷
docker volume create --driver local \
 --opt type=nfs \
 --opt o=addr=10.0.0.10,rw \
 --opt device=:/path/to/dir \
 nfs_volume

挂载到容器：

1
2
3
4


docker run -d -it \
 --name myapp \
 --mount source=nfs_volume,target=/data \
 myapp:latest

docker-compose 写法：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


version: "3.2"
services:
 myapp:
 image: myapp:latest
 ports:
 - "8080:8080"
 volumes:
 - type: volume
 source: nfs_volume
 target: /data
 volume:
 nocopy: true

volumes:
 nfs_volume:
 driver_opts:
 type: "nfs"
 o: "addr=10.0.0.10,nolock,soft,rw"
 device: ":/path/to/dir"

Why 推荐 nolock,soft：网络抖动时 hard 会卡住进程、nolock 减少锁竞争、soft 失败会返回错误而不是 hang。

八、用 volume driver 把数据存到其他主机

Docker Volume Plugins 生态丰富：vieux/sshfs（已停更）、Azure File Storage、AWS EFS、S3 driver、GlusterFS、Ceph、IPFS…

重要：vieux/sshfs plugin 已经停更，生产不要用——新的容器场景推荐自建 NFS 或云厂商文件存储。

历史 demo（演示用）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 安装 sshfs 插件
docker plugin install --grant-all-permissions vieux/sshfs

# 用 sshfs 创建卷
docker volume create --driver vieux/sshfs \
 -o sshcmd=user@10.32.2.134:/home/user/sshvolume \
 -o password=yourpassword \
 mysshvolume

# 挂载到容器
docker run -id \
 --name testcon \
 --mount type=volume,volume-driver=vieux/sshfs,source=mysshvolume,target=/world \
 ubuntu /bin/bash

九、共享卷在容器间复制文件

Volume 的天然优势：多容器可同时挂载。可以用这个特性在容器间传文件。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


# 1. 创建共享卷
docker volume create shared_data

# 2. 容器 A 写文件到卷
docker run -it --name=writer \
 --mount source=shared_data,destination=/data \
 ubuntu bash
# 在容器内
root@ded392c589ea:/# touch /data/demo.txt

# 3. 容器 B 读同一卷
docker run -it --name=reader \
 --mount source=shared_data,destination=/data \
 ubuntu bash
# 在容器内
root@feef37293ea5:/# ls /data
# 输出：demo.txt

典型场景：CI 流水线里"build 容器产出 artifacts → 测试容器拿同一份 artifacts 跑测试"，共享卷是干净的解法。

十、清理无用的卷

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 只删 dangling 卷
docker volume ls -f "dangling=true" -q | xargs --no-run-if-empty docker volume rm

# 一键清（删所有未挂载的卷 + dangling 镜像 + 停止的容器）
docker system prune -af --volumes

# 找出最大的卷 / 目录，定位"占空间元凶"
du -sh * | sort -hr | head

# 清理 2 天前的文件
find ./ -mtime +1 | xargs rm -rf

十一、要点回顾

Volume / bind mount / tmpfs 三选一，数据库用 Volume、配置用 bind mount、敏感数据用 tmpfs
容器层是临时的——任何持久化数据必须挂到卷或宿主机目录
Copy-on-Write决定了"修改容器内文件 ≠ 改镜像"——重启后默认文件
docker volume rm 不能删正在使用的卷——保护在 daemon 层
NFS 跨主机用内置 local driver 即可，不需要装额外插件
共享卷传文件是多容器协作的"原始"模式
vieux/sshfs 已停更——生产场景用云厂商文件存储或自建 NFS

十二、小结

Volume 是 Docker 持久化的"地基"。理解了：

三种挂载类型——volume / bind mount / tmpfs 的取舍
Copy-on-Write——容器层为什么不能持久化
NFS 跨主机——单机 → 多机的进阶
共享卷传文件——容器间协作的底层模式

剩下的就是"挑对的存储后端"：本地 SSD 给数据库、NFS / EFS / Ceph 给共享文件、S3 兼容给对象存储。

下一步：理解了单机 Volume，下一步是 Kubernetes 的 PV / PVC / StorageClass——把"申请存储"变成声明式 API，配合 CSI 驱动对接各种后端（NFS / Ceph / 云盘）。K8s 的存储抽象在 1.21+ 进入 GA，是云原生存储的事实标准。