docker-compose pause/unpause用于冻结/解冻运行中容器,不重启、不丢状态、毫秒级恢复;pause仅对Up状态容器有效,stop/start则终止进程并释放资源。

直接用 docker-compose pause 和 docker-compose unpause 就能挂起或恢复整个 Compose 环境,不重启、不丢状态,适合调试、维护或临时腾资源。
确认容器当前是运行中状态
pause 只对正在运行的容器有效。执行前先检查:
- 运行
docker-compose ps,确保目标服务显示 Up(不是 Exited 或 Paused) - 如果服务已停止,需先
docker-compose start启动,再 pause - pause 对已 stop 的容器无效,unpause 也无法唤醒它们——会报错“no such container”或“container is not paused”
暂停指定服务或全部服务
在 docker-compose.yml 所在目录下操作:
- 暂停单个服务:
docker-compose pause web - 暂停多个服务:
docker-compose pause redis db - 暂停所有服务:
docker-compose pause(不带参数,默认作用于全部) - 执行后,
docker-compose ps中对应服务状态会变成 Paused
恢复服务时保持完全一致的运行上下文
unpause 不是重启,而是“解冻”进程:
- 内存数据、TCP 连接、未完成的 I/O、应用内部计时器等全部保留
- 恢复命令格式与 pause 对称:
docker-compose unpause web或docker-compose unpause - 恢复后服务立即响应请求,无启动延迟,也不触发 entrypoint 或 init 流程
- 适用于需要“冻结现场”排查问题,比如观察某个服务卡顿前的堆栈或网络连接状态
和 stop/start 的关键区别必须清楚
别把 pause/unpause 当成轻量版 stop/start:
-
stop会发 SIGTERM → SIGKILL,进程终止,内存释放,端口释放,状态丢失 -
pause用 cgroups freezer 冻结进程,内核标记为T (stopped)状态,内存和文件描述符全留着 - 所以 unpause 后,
ps aux | grep yourapp显示的 PID、启动时间、CPU 累计时间都和暂停前一模一样 - 而 start 之后 PID 重置,应用重新初始化,可能重连数据库、重载配置、触发健康检查等


















