首页/云/云与容器速查/Compose 重启策略 restart
本包目录(340 条)
云基础概念44 条计算与存储56 条网络与安全组33 条
容器与 Docker106 条
Kubernetes68 条容器排障33 条

Compose 重启策略 restart

restart 字段控制容器退出后的自动拉起:开发常用 unless-stopped,常驻服务建议 always/unless-stopped;但它替代不了健康检查。

云与容器速查云更新于 2026-10-12
取值no / always / on-failure[:max] / unless-stopped
关键差异always:宿主重启也拉起;unless-stopped:手动停过就不再拉起
查看docker inspect <容器> 的 HostConfig.RestartPolicy
局限只对『进程退出』生效:进程活着但服务假死不会重启

示例

示例
services:
  web:
    image: nginx:1.27-alpine
    restart: unless-stopped
  worker:
    restart: on-failure:5
启动即崩的容器配 always 会无限重启刷屏:先用日志定位根因,再配 on-failure 限流。

易错点

  • 依赖 restart 兜底坏代码:重启循环掩盖故障,日志被刷爆
  • 在 Swarm 部署里期待 restart 生效:Swarm 用 deploy.restart_policy,字段不同

数据来源与参考

  • Docker Docs:Compose restart
  • Docker Docs:Restart policies

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌