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看耗时是否明显下降。
针对构建步骤执行慢（比如编译、安装依赖）
- 使用多阶段构建，避免把构建工具和中间产物打进最终镜像。
- 合并
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 是运行时健康检查，和构建超时无关，别混淆。
