怎么在Docker中配置容器的重启计数器限制无效的自动拉起循环-Docker-PHP中文网

Docker容器无内置重启次数上限，需用on-failure:N策略限制连续失败重试次数，并配合健康检查和启动守卫脚本实现有效防循环控制。

在 docker 中，容器的“重启计数器限制无效的自动拉起循环”本质上是对 --restart 策略与容器启动失败行为之间误解导致的问题。docker 本身**没有内置的“重启次数上限”机制来终止无限重启循环**（比如 on-failure 不带最大重试次数），但可以通过组合策略、健康检查和外部干预来有效控制。

理解 restart 策略的真实行为

Docker 的 --restart 选项有几种模式，关键点在于：

no：从不自动重启（默认）
always：无论退出码如何，总是重启（可能造成无限拉起循环）
on-failure[:max-retries]：仅当非零退出码退出时重启；若指定 max-retries（如 on-failure:3），则最多尝试 3 次后停止，不再自动拉起
unless-stopped：等同于 always，但跳过已手动 docker stop 的容器

⚠️ 注意：on-failure 的 max-retries 是**自上次成功运行以来的连续失败计数**，不是全局累计值；且该计数器由 Docker 守护进程维护，重启 Docker daemon 会重置它。

用 on-failure + max-retries 切断无效循环

这是最直接有效的做法——明确限制失败重试次数：

启动容器时指定：docker run --restart on-failure:5 nginx:alpine → 最多重启 5 次，第 6 次失败后容器状态变为 Exited (1) 并停止尝试
对已有容器，可通过 docker update --restart on-failure:3 container_name 动态修改（需容器处于 stopped 状态或支持热更新的 Docker 版本）
在 docker-compose.yml 中写为：
```
restart: "on-failure:3"
```
（注意引号，避免 YAML 解析为布尔值）

配合健康检查实现更智能的退出控制

单纯依赖退出码可能不够（例如进程卡死但没崩溃）。可添加健康检查，在检测到异常时主动退出，触发 on-failure 逻辑：

Docker Encyclopedia

Docker 文档优先工作流：针对 Docker 特定问题、故障排除、命令规划、镜像/构建、容器/运行时操作及 Compose 等

下载

示例：一个 Python Web 应用，启动后需连接数据库，若 30 秒内连不上就应放弃
在镜像中编写健康脚本 /health.sh，检查关键依赖是否就绪，失败时 exit 1

Dockerfile 中声明：

HEALTHCHECK --interval=10s --timeout=3s --start-period=30s --retries=3 CMD ["/health.sh"]

搭配 --restart on-failure:2：健康检查连续失败 3 次 × 重启 2 次 = 最多约 1 分钟后彻底停止

用 init 进程或 wrapper 脚本做启动守卫

对于易崩溃的旧应用，可在容器内加一层控制逻辑：

使用 tini（Docker 官方推荐 init）处理僵尸进程，避免信号传递异常导致假死
自定义启动脚本，记录启动时间戳和失败次数（存入 /tmp 或内存文件系统），超过阈值则 exit 1 而非反复 exec

示例片段：

#!/bin/sh
ATTEMPTS=$(cat /tmp/start_count 2>/dev/null || echo 0)
if [ "$ATTEMPTS" -ge 3 ]; then
  echo "Too many start failures, bailing out." >&2
  exit 1
fi
echo $((ATTEMPTS + 1)) > /tmp/start_count
exec "$@"

不复杂但容易忽略：Docker 的重启机制是守护进程级的简单逻辑，真正的“防循环”要靠策略选对（on-failure:N）、依赖可控（健康检查）、启动可审计（wrapper 脚本）三者结合。