首页/云/Docker 容器速查/compose restart 策略字段
本包目录(366 条)
基础命令50 条镜像与构建107 条网络与存储52 条
Compose 编排55 条
资源与安全50 条容器排障52 条

compose restart 策略字段

为服务设置自动重启策略:no/always/on-failure/unless-stopped,生产常配 unless-stopped 或 on-failure,并注意 YAML 引号。

Docker 容器速查云更新于 2026-10-12
取值no / always / on-failure[:次数] / unless-stopped
生产常用unless-stopped、on-failure
注意no 在 YAML 里要加引号

示例

示例
services:
  api:
    image: app/api:1.4.2
    restart: unless-stopped
  batch:
    image: app/batch:1.4.2
    restart: "no"
  flaky:
    image: app/flaky:1.4.2
    restart: on-failure:5
restart 由 Docker 守护进程执行,与编排无关;手工 stop 的容器不会被策略拉起。

易错点

  • 写成 no 不加引号会被 YAML 解析成布尔值,校验时报类型错误
  • 反复崩溃的服务配 always 会形成重启循环,先看日志定位根因再决定策略

数据来源与参考

  • Docker 官方文档:Compose restart 参考与 restart policy(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌