docker restart 策略

赵丙双2026-04-09 10:18

docker restart 策略

docker 有 4 中 restart 策略，在容器退出后 Docker daemon 是否重启容器：

不会自动重启容器。这是默认值。

on-failure $:max-retries$

如果容器的退出码非零，则重新启动该容器。可以通过可选的 max-retries 来限制尝试重启的次数，例如 docker run --restart=on-failure:10 redis，默认为无限制。

如果重启 Docker daemon 进程时 on-failure 容器的状态为 Exited (0)，则不会自动启动容器，如果状态为 Restarting、Exited (x > 0) 则会自动重启容器。

always

总是重新启动容器。如果容器是手动停止的（通过 docker stop、docker kill），那么只有当 Docker daemon 重新启动，它才会重新启动。

unless-stopped

与always类似。但如果容器是手动停止的（通过 docker stop、docker kill），即使 Docker daemon 重新启动，也不会重新启动容器。

在每次重新启动之前会有延迟时间，初始值是 100ms，之后每次翻倍，直到达到最大值 1分钟。下图是执行 docker run --restart always -d redis --entrypoint exit 1 后的 docker events | grep "container start" 的输出，可以看出延迟时间的趋势基本符合前述的规律：

通过以下命令可查看容器的重启次数

shell 复制代码

docker inspect -f "{{ .RestartCount }}" my-container
2