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

docker run --restart 重启策略

为容器配置退出后的自动拉起规则:on-failure/always/unless-stopped 三种常用策略,配合 docker update 可在线调整。

Docker 容器速查云更新于 2026-10-12

策略对照

策略行为
no默认值,退出后不自动重启
on-failure[:N]以非 0 状态退出时重启,最多 N 次(省略为无限)
always总是重启,手动停掉后守护进程重启时也会被拉起
unless-stopped总是重启,但被手动停掉后不再随守护进程启动

示例

示例
docker run -d --restart unless-stopped --name web nginx:1.27-alpine
docker update --restart on-failure:3 web
docker inspect -f '{{.HostConfig.RestartPolicy.Name}} {{.RestartCount}}' web
重启发生在容器退出之后,且受退避机制影响;反复崩溃的容器不会无限高频拉起。

易错点

  • --rm 与 --restart 同时传会报冲突参数错误,想自动清理就别设重启策略
  • 崩溃循环场景先看 RestartCount 与 docker logs 尾部,直接重启只是在重复失败

数据来源与参考

  • Docker 官方 CLI 参考:docker run --restart(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌