docker stop 是 docker 停止容器的原生命令，通过发送 sigterm 信号触发应用优雅落盘，需配合信号处理、挂载卷持久化及 pre-stop 备份策略实现数据一致性。
“dockerstop”并不是 docker 的原生命令，docker 中实际用于停止容器的命令是 docker stop。它本身不直接支持“优雅落盘”或“快照备份”，但可以通过合理配合容器内应用行为、信号机制、挂载卷（volumes）和外部工具，实现有状态服务在停止前完成数据持久化与一致性快照。关键不在命令本身，而在如何设计容器生命周期与数据管理策略。
理解 docker stop 的工作原理与信号传递
docker stop 默认向容器主进程（PID 1）发送 SIGTERM 信号，等待默认 10 秒（可通过 -t 参数调整），若进程未退出则补发 SIGKILL 强制终止。要实现“优雅落盘”，需确保容器内应用能响应 SIGTERM 并执行清理逻辑（如刷写缓冲、关闭连接、提交事务）。
- 应用需主动监听 SIGTERM（例如 Java 应用通过 ShutdownHook、Node.js 使用
process.on('SIGTERM', ...)、PostgreSQL 依赖pg_ctl stop -m fast） - Dockerfile 中避免使用
exec bash -c "..."类封装，防止信号被阻断；推荐使用exec "$@"或直接运行可执行程序作为 PID 1 - 可通过
docker stop --time=30 my-db延长等待时间，为慢速落盘留出窗口
利用绑定挂载或命名卷保障落盘数据不丢失
容器停止后，仅当数据写入到 宿主机挂载路径 或 Docker 卷（volume） 时，状态才能持久保留。“落盘”不是 Docker 的功能，而是应用将内存/缓存数据写入挂载路径的过程。
- 启动时务必使用
-v /host/data:/container/data或--mount source=myvol,target=/data挂载状态目录 - 确认应用配置指向挂载路径（例如 Redis 的
dir /data、MySQL 的datadir = /var/lib/mysql并挂载该路径） - 禁用
tmpfs或内存盘存储核心状态，除非明确用于临时缓存
结合 pre-stop hook 实现自动化快照备份
Docker 本身无内置 pre-stop 钩子，但可通过以下方式在 stop 前触发备份：
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
-
使用轻量守护进程：在容器内运行 supervisor 或 tini，并配置 pre-stop 脚本（例如在 SIGTERM 处理中先调用
mysqldump或redis-cli bgsave） -
借助 docker-compose 的 healthcheck + 自定义脚本：在
docker-compose.yml中定义command包裹启动逻辑，加入 trap 语句捕获信号并执行备份 -
宿主机侧协同：编写 wrapper 脚本，先调用备份命令（如
tar -czf /backups/app-$(date +%s).tgz /mnt/vol），再执行docker stop
对强一致性服务补充文件系统级快照（可选进阶）
对于数据库等要求 ACID 的服务，仅靠应用层落盘可能仍存在写入顺序风险。此时可借助底层存储能力做原子快照：
- LVM 卷：将 Docker volume 所在 LV 创建快照（
lvcreate -s -n snap_vol -L 5G /dev/vg/lv_data），再停止容器 - ZFS/Btrfs：在挂载点所在文件系统上执行
zfs snapshot pool/vol@pre-stop-20240520 - 云平台：AWS EBS、阿里云云盘等支持在线创建快照，可在
docker stop前调用 API 触发
不复杂但容易忽略：优雅落盘本质是应用行为 + 信号治理 + 存储路径设计三者协同的结果。docker stop 只是触发器，真正的“状态安全”取决于你是否让应用听得懂、写得到、备得全。
