Docker 启动 Redis 并实现 AOF 与 RDB 持久化（Windows 环境）

1. 环境准备本文基于 Windows 10/11 Docker Desktop目标是在 Windows 上通过 Docker 启动 Redis并借助宿主机目录挂载实现 RDB、AOF 持久化避免容器删除后数据丢失。先确认 Docker 可用。推荐使用 PowerShell 或 Windows Terminal 执行docker--version docker info确认 Docker Desktop 已启动且运行正常后拉取 Redis 7 官方镜像docker pull redis:72. Windows 下 Docker 启动 Redis2.1 最简启动为了在 Windows 的 CMD 与 PowerShell 中都能直接复制运行本教程中的命令尽量写在一行docker run-d--name redis-demo-p 6379:6379 redis:7参数说明-d后台运行容器。--name redis-demo容器名称。-p 6379:6379把容器内 6379 端口映射到 Windows 宿主机。redis:7使用 Redis 7 官方镜像。连接测试docker exec-it redis-demo redis-cliping# 输出 PONG 表示连接成功2.2 挂载 Windows 宿主机目录如果只用上面的命令启动持久化文件保存在容器内部容器删除后数据会丢失。应该把 Windows 目录挂载到容器内的/data。先在 Windows 上创建数据目录New-Item-ItemType Directory-Force-PathD:\docker-data\redis启动时把D:\docker-data\redis挂载到容器内/data。Windows 挂载推荐使用正斜杠路径避免反斜杠被转义docker run-d--name redis-demo-p 6379:6379-vD:/docker-data/redis:/dataredis:7Redis 官方镜像的默认工作目录就是/data挂载后 RDB、AOF 文件都会保存到 Windows 的D:\docker-data\redis。使用 WSL2 后端的 Docker Desktop 通常可以直接访问C:、D:等盘符。如果旧版 Docker Desktop 挂载失败请到 Settings → Resources → File Sharing 中添加对应盘符。3. 实现 RDB 持久化3.1 RDB 是什么RDB 是 Redis 的快照持久化会在某个时间点把内存数据生成一份二进制文件默认文件名为dump.rdb。优点是文件小、恢复快适合冷备缺点是两次快照之间的数据可能丢失。3.2 在 Windows 上创建 redis.conf在D:\docker-data\redis下新建redis.conf。可以用记事本新建后保存内容如下bind 0.0.0.0 protected-mode no save 900 1 save 300 10 save 60 10000 dbfilename dump.rdb dir /data也可以直接用 PowerShell 写入 bind 0.0.0.0 protected-mode no save 900 1 save 300 10 save 60 10000 dbfilename dump.rdb dir /data |Out-File-FilePathD:\docker-data\redis\redis.conf-Encoding utf8save 900 1900 秒内至少 1 个 key 变化时自动触发 RDB。save 300 10300 秒内至少 10 个 key 变化时触发。save 60 1000060 秒内至少 10000 个 key 变化时触发。dbfilename dump.rdbRDB 文件名。dir /data容器内工作目录对应当前挂载目录。编码提示PowerShell 7 推荐使用-Encoding utf8NoBOM。Windows PowerShell 5.x 的utf8会带 BOMRedis 通常也能识别如果启动报错可用记事本打开redis.conf另存为 UTF-8 编码。3.3 启动并挂载配置docker run-d--name redis-rdb-p 6379:6379-vD:/docker-data/redis:/dataredis:7 redis-server/data/redis.conf这条命令把整个D:\docker-data\redis挂载到容器内/data并让 Redis 启动时读取/data/redis.conf。3.4 写入数据并手动触发 RDB进入客户端docker exec-it redis-rdb redis-cli在客户端中执行SET username alice SET age20BGSAVEBGSAVE会在后台生成dump.rdb。退出客户端后在 Windows 上查看Get-ChildItemD:\docker-data\redis如果提示redis-cli连接被拒绝可以改用docker exec-it redis-rdb redis-cli-h 127.0.0.13.5 验证 RDB 恢复删除当前容器再重新启动一个容器观察数据是否从 RDB 恢复dockerrm-f redis-rdb docker run-d--name redis-rdb-p 6379:6379-vD:/docker-data/redis:/dataredis:7 redis-server/data/redis.conf docker exec-it redis-rdb redis-cliGET username# 输出 alice 说明 RDB 持久化和恢复成功4. 实现 AOF 持久化4.1 AOF 是什么AOF 会把 Redis 收到的每一条写命令追加到文件中默认文件名为appendonly.aof。它的数据安全性更高通常最多丢失 1 秒数据缺点是文件更大、恢复速度较慢。4.2 开启 AOF 的配置在redis.conf中追加或修改以下内容appendonly yes appendfilename appendonly.aof appendfsync everysec auto-aof-rewrite-percentage 100 auto-aof-rewrite-min-size 64mb aof-use-rdb-preamble yesappendonly yes开启 AOF。appendfsync everysec每秒刷盘一次兼顾性能与数据安全推荐使用。auto-aof-rewrite-percentage 100AOF 文件超过上次重写后大小的 100% 时自动重写。auto-aof-rewrite-min-size 64mbAOF 文件最小达到 64MB 才允许重写。aof-use-rdb-preamble yesRedis 4.0 混合持久化。4.3 Windows 下启动如果 6379 端口仍被之前的容器占用先清理旧容器或改用 6380 端口dockerrm-f redis-demo docker run-d--name redis-aof-p 6379:6379-vD:/docker-data/redis:/dataredis:7 redis-server/data/redis.confRDB 和 AOF 使用同一个数据目录因此挂载命令不变。4.4 写入数据并观察 AOF 文件进入客户端写入数据docker exec-it redis-aof redis-cli执行SET page homepage INCR visit_count INCR visit_count退出客户端后在 Windows 上查看 AOF 文件Get-ChildItemD:\docker-data\redis\appendonly.aof也可以在容器内查看文件内容docker exec-it redis-aof sh-chead /data/appendonly.aofWindows 下还可以直接用记事本或 VS Code 打开D:\docker-data\redis\appendonly.aof查看其中的写命令。4.5 验证 AOF 恢复删除容器后重新启动观察数据是否从 AOF 恢复dockerrm-f redis-aof docker run-d--name redis-aof-p 6379:6379-vD:/docker-data/redis:/dataredis:7 redis-server/data/redis.conf docker exec-it redis-aof redis-cliGET page# 输出 homepagedocker exec-it redis-aof redis-cliGET visit_count# 输出 25. AOF 重写实现当 AOF 文件不断增大时可以触发 AOF 重写把冗余命令压缩为更少的等价命令。例如对同一个 key 执行 100 次INCR重写后只保留最终值的一条命令。5.1 手动触发重写docker exec-it redis-aof redis-cliBGREWRITEAOF重写完成后AOF 体积会明显下降但数据内容不变。5.2 重写过程中的数据安全AOF 重写使用子进程加写时复制重写期间新产生的写命令不会丢失主进程 fork 子进程 | v 子进程根据当前内存数据生成新 AOF | v 主进程把重写期间的增量命令写入重写缓冲区 | v 子进程完成后主进程把增量命令追加到新文件原子替换旧文件6. 同时启用 RDB 与 AOF生产环境通常同时开启 RDB 和 AOF或使用 Redis 4.0 的混合持久化。开启aof-use-rdb-preamble yes后AOF 重写时会把当前数据以 RDB 格式写到 AOF 文件开头后续增量命令再以 AOF 格式追加[RDB 格式的基础数据] [AOF 格式的增量命令]这样既能获得 AOF 的数据安全性又能获得 RDB 的快速恢复能力。6.1 完整配置示例bind 0.0.0.0 protected-mode no dbfilename dump.rdb dir /data save 900 1 save 300 10 save 60 10000 appendonly yes appendfilename appendonly.aof appendfsync everysec auto-aof-rewrite-percentage 100 auto-aof-rewrite-min-size 64mb aof-use-rdb-preamble yes6.2 Windows 下启动命令docker run-d--name redis-prod-p 6379:6379-vD:/docker-data/redis:/dataredis:7 redis-server/data/redis.conf7. Windows 环境常见问题排查7.1 常用排查命令# 查看当前持久化配置docker exec-it redis-prod redis-cliCONFIG GET save docker exec-it redis-prod redis-cliCONFIG GET appendonly docker exec-it redis-prod redis-cliCONFIG GET appendfsync# 查看 RDB/AOF 持久化状态docker exec-it redis-prod redis-cliINFO persistence# 查看容器日志docker logs redis-prod重点观察日志中是否出现Background saving startedBackground saving terminated with successBackground append only file rewriting started7.2 常见问题端口被占用报错port is already in use时先执行docker rm -f redis-prod清理旧容器或改用-p 6380:6379映射其他端口。挂载目录不存在确保已执行New-Item -ItemType Directory -Force -Path D:\docker-data\redis并确认.conf文件已经保存到该目录。旧版 Docker Desktop 无法访问盘符在 Settings → Resources → File Sharing 中添加D:\后重启 Docker Desktop。修改配置不生效容器不会自动重新加载配置文件需要删除容器后重新docker run启动。redis.conf 解析报错确认文件编码为 UTF-8用记事本打开另存为 UTF-8 编码后重试。8. 总结Windows 下挂载数据卷统一使用正斜杠路径例如-v D:/docker-data/redis:/data。把配置文件redis.conf放在挂载目录中启动时通过redis-server /data/redis.conf加载。RDB 通过save配置自动触发也可用BGSAVE手动触发适合冷备和快速恢复。AOF 通过appendonly yes开启推荐使用appendfsync everysec。生产环境建议同时开启 RDB 与 AOF或使用 Redis 4.0 的混合持久化。无论哪种持久化方式都要定期演练恢复流程确认备份文件有效。