首页/云/Docker 容器速查/docker build 构建期网络模式
镜像与构建107 条

docker build 构建期网络模式

--network 选择构建容器网络:host 直接用宿主网络、none 完全断网、default 走 NAT;用于解决拉包网络问题或验证离线构建。

Docker 容器速查云更新于 2026-10-12
用途控制构建期网络
语法--network=host / none / default
场景企业代理、离线可构建性验证

示例

示例
docker build --network=host -t app/web:1.0 .
docker build --network=none -t app/web:1.0 .   # 验证构建不依赖网络
host 模式在部分企业网络下能绕开构建容器的 DNS/代理问题;none 用于验证镜像构建对网络的依赖清单。

易错点

  • Docker Desktop 上 host 指虚拟机内部网络,与 Linux 行为不同,涉及宿主服务的构建脚本注意区分
  • 构建期若走 none,所有下载(apt/npm/pip)都会失败,适合验证而不是常规加速

数据来源与参考

  • Docker 官方 CLI 参考:docker build --network(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌