docker 无原生 --retry 参数，需通过 shell 脚本封装（如循环重试）、调整 daemon.json 中 max-concurrent-downloads、配合镜像源、或使用 skopeo --retry-times 等方式实现拉取重试。
Docker 本身没有直接提供 --retry 或 retry_count 这类命令行参数来控制 docker pull 的重试次数。但可以通过组合系统级配置、Shell 脚本封装或客户端工具，实现自动重试拉取镜像，特别适合网络不稳定场景（如弱 Wi-Fi、企业代理波动、跨境链路抖动等）。
✅ 1. 使用 Shell 脚本封装重试逻辑（最常用、零依赖）
在终端中运行带重试的拉取命令，例如：
#!/bin/bash
MAX_RETRIES=5
RETRY_DELAY=3
IMAGE="nginx:alpine"
for i in $(seq 1 $MAX_RETRIES); do
echo "尝试拉取 $IMAGE（第 $i 次）..."
if docker pull "$IMAGE"; then
echo "✅ 拉取成功"
exit 0
else
echo "❌ 第 $i 次失败，$RETRY_DELAY 秒后重试..."
sleep $RETRY_DELAY
fi
done
echo "❌ 已重试 $MAX_RETRIES 次，全部失败"
exit 1
⚠️ 注意：
docker pull默认超时由底层 HTTP 客户端决定（约 30–60 秒），脚本只控制“失败后是否再试”，不改变单次请求超时时间。
✅ 2. 调整 Docker 守护进程的 HTTP 超时（影响单次请求）
虽然不能设“重试次数”，但可延长单次连接/读取等待时间，降低因瞬时抖动导致的失败：
编辑 /etc/docker/daemon.json（Linux）或通过 Docker Desktop 设置（macOS/Windows），添加：
{
"default-runtime": "runc",
"max-concurrent-downloads": 3,
"max-concurrent-uploads": 5,
"metrics-addr": "",
"experimental": false,
"registry-mirrors": ["https://<your-mirror>.mirror.aliyuncs.com"],
"live-restore": true,
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}</your-mirror>
⚠️ Docker 不支持直接配置 http.timeout 或 retry 参数（截至 2026 年 7 月，Docker Engine v26.x 仍无此原生选项）。
但可通过以下方式间接提升稳定性：
-
max-concurrent-downloads：避免多镜像并发抢占带宽，减少单个拉取失败概率 - 配合国内镜像源（如阿里云加速器）：大幅缩短单次传输耗时，自然降低超时风险
✅ 3. 使用 docker-compose + --retries（仅限构建阶段）
注意：docker-compose pull 也没有重试参数，但 docker build 在 Dockerfile 中用 RUN curl ... 下载外部资源时，可自行加 --retry（如 curl -f --retry 3 --retry-delay 2）。
而镜像拉取本身仍由 docker pull 执行，需靠脚本兜底。
✅ 4. 替代方案：用 skopeo + 重试（高级用户）
skopeo 是容器镜像操作的轻量工具，支持显式重试：
skopeo --debug copy \ docker://docker.io/library/nginx:alpine \ docker-daemon:nginx:alpine \ --retry-times 5 \ --retry-delay 2s
✅ 支持
--retry-times和--retry-delay（需 skopeo ≥ v1.12.0）。
⚠️ 注意：它把镜像复制到本地 daemon，不是直接替代docker pull，但可用于预加载关键镜像。
✅ 5. CI/CD 场景建议（如 GitHub Actions / GitLab CI）
在流水线脚本中强制重试，例如 GitHub Actions：
- name: Pull image with retry
run: |
for i in {1..5}; do
if docker pull nginx:alpine; then
echo "Pull succeeded"
break
elif [ $i -eq 5 ]; then
echo "Pull failed after 5 attempts"
exit 1
else
echo "Retry $i..."
sleep 3
fi
done
不复杂但容易忽略：真正起效的是「镜像源 + 重试脚本 + 网络基础优化」三者配合。单靠改一个参数很难根治不稳定网络下的拉取失败。
