docker构建无内置--timeout参数，超时需分场景处理：先用--progress=plain定位卡点（如from拉取、run执行），再针对性优化——配置国内镜像加速器、修正代理、使用多阶段构建、合并run指令，或用系统timeout命令包裹构建流程。

Docker 构建过程本身没有内置的 --timeout 参数，但超时问题往往源于网络拉取、资源不足或构建步骤卡顿。解决的关键不是“加一个开关”，而是分场景针对性处理。

确认是不是真的超时，还是卡在某一步
运行构建时加上 --progress=plain 查看实时输出，观察是卡在 FROM（镜像拉取）、RUN apt-get update（包源慢），还是某个自定义命令。别一上来就调参数，先定位瓶颈。

针对镜像拉取慢或失败（最常见）

• 配置国内镜像加速器：编辑 /etc/docker/daemon.json，加入稳定镜像源（如阿里云、中科大、网易）：

  {
    "registry-mirrors": [
      "https://docker.m.daocloud.io",
      "https://docker.nju.edu.cn",
      "https://hub-mirror.c.163.com"
    ]
  }

  保存后执行 sudo systemctl daemon-reload && sudo systemctl restart docker。

• 若用代理，确保 daemon.json 中 proxy 配置正确，且与系统环境变量不冲突。
• 测试是否生效：docker pull hello-world 看耗时是否明显下降。

针对构建步骤执行慢（比如编译、安装依赖）

Docker Cli

使用 Docker CLI 构建、运行、停止、检查和管理容器与镜像的助手。用于执行容器相关任务。

下载

• 使用多阶段构建，避免把构建工具和中间产物打进最终镜像。
• 合并 RUN 指令减少层数，同时用 \ 换行保持可读性，例如：

  RUN apt-get update && apt-get install -y \
      curl \
      build-essential \
      && rm -rf /var/lib/apt/lists/*

• 对于 Python/Node.js 等项目，优先用 --no-cache-dir 或 .dockerignore 排除 node_modules、__pycache__ 等无用目录。

需要人为设时限？用系统级 timeout 控制
Linux/macOS 下可用 timeout 命令包裹构建过程，例如：

timeout 1800 docker build --no-cache -t myapp .  # 30分钟超时

超时后进程被终止，适合 CI 场景防死锁，但不会自动重试或清理残留容器。

检查 Docker 守护进程资源是否吃紧

• docker info | grep -i "memory\|cpus" 看实际分配；
• 在 Docker Desktop 设置里调高 CPU 和内存配额（Mac/Windows）；
• Linux 上检查 systemctl show docker | grep MemoryLimit，必要时调整 cgroup 限制。

注意：HEALTHCHECK 是运行时健康检查，和构建超时无关，别混淆。