首页/云/Docker 容器速查/构建期网络与代理问题
容器排障52 条

构建期网络与代理问题

构建容器不继承宿主代理环境:需要在构建时显式传入代理或使用镜像源,凭据类代理要走 BuildKit secret 避免写进层与历史。

Docker 容器速查云更新于 2026-10-12
现象RUN 里拉依赖超时或拒绝连接
手段--build-arg 传代理变量 / 配置镜像源
安全代理含凭据时用 secret,不用 ARG

示例

示例
docker build --build-arg https_proxy=http://proxy.example.com:3128 --build-arg http_proxy=http://proxy.example.com:3128 -t app:1.0 .
docker build --add-host=registry.example.com:10.0.0.20 -t app:1.0 .
ARG 值会进入镜像历史可被检出,代理含账号密码时用 BuildKit secret 挂载。

易错点

  • 宿主能联网不等于构建容器能联网:Docker0/桥接与公司网络策略都可能拦截
  • 忽略 no_proxy 会让内网仓库请求被错误走代理,构建内网地址失败先查这个

数据来源与参考

  • Docker 官方文档:BuildKit secrets 与 build-arg(docs.docker.com/build)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌