DevContainer CLI自定义Docker构建选项配置未生效，如何解决？

架构老林

2026-6-30

问题

运行devcontainer up命令时，需要为docker build添加以下选项：

--add-host=host.docker.internal:host-gateway --build-arg HTTPS_PROXY=http://host.docker.internal:1080

配置了build.args后，自定义参数并未生效，具体配置如下：

{
  "image": "mcr.microsoft.com/vscode/devcontainers/base:ubuntu",
  "build": {
    "args": {
      "http_proxy": "http://172.17.0.1:1080",
      "https_proxy": "http://172.17.0.1:1080"
    }
  },
  "appPort": 8080,
  "features": {
    "ghcr.dockerproxy.com/devcontainers/features/go:1": {"version": "1.21"},
    "ghcr.dockerproxy.com/devcontainers/features/node:1": {"version": "20"},
    "ghcr.dockerproxy.com/devcontainers/features/docker-in-docker:2": {},
    "ghcr.dockerproxy.com/devcontainers/features/python:1": {}
  },
  "forwardPorts": [9000,9090,2746,8080],
  "hostRequirements": {"cpus": 4},
  "runArgs": [
    "--add-host=host.docker.internal:host-gateway",
    "--add-host=dex:127.0.0.1",
    "--add-host=minio:127.0.0.1",
    "--add-host=postgres:127.0.0.1",
    "--add-host=mysql:127.0.0.1",
    "--add-host=azurite:127.0.0.1"
  ],
  "postCreateCommand": ".devcontainer/pre-build.sh",
  "workspaceMount": "source=${localWorkspaceFolder},target=/home/vscode/go/src/github.com/argoproj/argo-workflows,type=bind",
  "workspaceFolder": "/home/vscode/go/src/github.com/argoproj/argo-workflows",
  "remoteEnv": {
    "PATH": "${containerEnv:PATH}:/home/vscode/go/bin",
    "GOPATH": "/home/vscode/go"
  }
}

实际执行的docker build命令如下，未包含自定义参数：

docker buildx build --load --build-context dev_containers_feature_content_source=/tmp/devcontainercli-chenglab/container-features/0.56.1-1707032528485 --build-arg _DEV_CONTAINERS_BASE_IMAGE=mcr.microsoft.com/vscode/devcontainers/base:ubuntu --build-arg _DEV_CONTAINERS_IMAGE_USER=root --build-arg _DEV_CONTAINERS_FEATURE_CONTENT_SOURCE=dev_container_feature_content_temp --target dev_containers_target_stage -t vsc-argo-workflows-main-786eedc0416670a1d14a7d9eff7e152b3e6c365adf4daac9c51d4fc9614302e7-features -f /tmp/devcontainercli-chenglab/container-features/0.56.1-1707032528485/Dockerfile.extended /tmp/devcontainercli-chenglab/empty-folder

解决建议

区分构建与运行阶段参数：runArgs仅作用于容器运行时，构建阶段的--add-host需要放在build.options中，修改build配置块如下：

"build": {
  "args": {
    "http_proxy": "http://host.docker.internal:1080",
    "https_proxy": "http://host.docker.internal:1080"
  },
  "options": [
    "--add-host=host.docker.internal:host-gateway"
  ]
}

修正代理地址：将配置中的172.17.0.1替换为host.docker.internal，该地址是Docker官方提供的宿主机映射地址，比固定网关IP更通用可靠。
排查features干扰：当前启用的多个devcontainer features会生成临时Dockerfile构建，可能导致自定义参数未被传递。可以临时注释所有features配置，重新运行devcontainer up测试参数是否生效，确认后再逐个恢复features排查冲突。
更新devcontainer CLI：旧版本CLI可能存在配置解析bug，执行devcontainer --version检查版本，若不是最新版，更新后重试。

内容的提问来源于stack exchange，提问作者link89