企业Zscaler代理环境下VS Code Dev Container无法安装扩展

问题 #

我正在为C++项目搭建VS Code Dev Container，但无法让VS Code安装我在.devcontainer/devcontainer.json中列出的扩展。我处于企业Zscaler代理环境下，已获取CA证书并将其复制到容器内的/usr/local/share/ca-certificates/目录，且确认证书已成功添加。同时，我已在docker-compose.yml和用户settings.json中配置了代理设置：

settings.json 配置 #

{
  "http.proxy": "http://localhost:80",
}

docker-compose.yml 配置 #

version: "3.9"
services:
  embedded:
    container_name: build_container
    build:
      context: .
      dockerfile: ./Dockerfile
    environment:
      - http_proxy=http://host.docker.internal:80
      - https_proxy=http://host.docker.internal:443

端口号参考了Zscaler官方文档。此外，我在.devcontainer.json中指定了需要安装的扩展列表：

.devcontainer.json 扩展配置 #

{
    // Configure tool-specific properties.
    "customizations": {
        "vscode": {
            "extensions": [
                "twxs.cmake",
                "ms-vscode.cmake-tools",
                "josetr.cmake-language-support-vscode",
                "ms-vscode.cpptools",
                "ms-vscode.docker",
                "ms-azuretools.vscode-docker",
                "fabiospampinato.vscode-highlight",
                "cschlosser.doxdocgen",
                "mhutchie.git-graph",
                "albert.tabout",
                "ms-python.vscode-pylance",
                "ms-vscode.cpptools-extension-pack",
                "marus25.cortex-debug"
            ]
        }
    },
}

打开Dev Container后，日志显示已建立连接，但未执行扩展安装操作，关键日志片段如下：

[147 ms] Dev Containers 0.275.1 in VS Code 1.75.1 (441438abd1ac652551dbe4d408dfcec8a499b8bf).
...
[19469 ms] [00:36:13] [127.0.0.1][eeed07a7][ExtensionHostConnection] <238> Launched Extension Host Process.

请问我哪里配置有误？希望得到相关解决方案。

解决方案 #

1. 统一代理地址，修正settings.json配置 #

容器内的localhost指向容器自身，而非宿主机器，因此当前settings.json的代理地址无效。需将其改为与docker-compose.yml一致的宿主代理地址，并补充HTTPS代理及SSL信任配置：

{
  "http.proxy": "http://host.docker.internal:80",
  "https.proxy": "http://host.docker.internal:443",
  "http.proxyStrictSSL": false
}

http.proxyStrictSSL设为false是临时绕过证书校验，后续可通过指定CA证书路径替代。

2. 在.devcontainer.json中集成完整代理与证书配置 #

直接在.devcontainer.json中配置VS Code容器内的代理、证书及环境变量，确保扩展安装进程能读取到正确配置：

{
    "customizations": {
        "vscode": {
            "extensions": [
                "twxs.cmake",
                "ms-vscode.cmake-tools",
                "josetr.cmake-language-support-vscode",
                "ms-vscode.cpptools",
                "ms-vscode.docker",
                "ms-azuretools.vscode-docker",
                "fabiospampinato.vscode-highlight",
                "cschlosser.doxdocgen",
                "mhutchie.git-graph",
                "albert.tabout",
                "ms-python.vscode-pylance",
                "ms-vscode.cpptools-extension-pack",
                "marus25.cortex-debug"
            ],
            "settings": {
                "http.proxy": "http://host.docker.internal:80",
                "https.proxy": "http://host.docker.internal:443",
                "ssl.caFile": "/usr/local/share/ca-certificates/你的CA证书文件名.crt",
                "http.proxyStrictSSL": false
            }
        }
    },
    "containerEnv": {
        "http_proxy": "http://host.docker.internal:80",
        "https_proxy": "http://host.docker.internal:443",
        "NO_PROXY": "localhost,127.0.0.1,host.docker.internal"
    }
}

• ssl.caFile指定容器内CA证书路径，让VS Code信任企业代理证书；
• containerEnv设置容器全局环境变量，覆盖所有进程的代理配置。

3. 验证容器内CA证书与代理连通性 #

进入容器终端，执行以下命令确认证书生效：

update-ca-certificates

再测试VS Code扩展市场的连通性：

curl -I https://marketplace.visualstudio.com

返回200系列状态码则说明代理与证书配置正常。

4. 清理缓存并重新构建容器 #

旧容器可能缓存了无效配置，需删除后重新构建：

docker-compose down
docker-compose build --no-cache

重新打开Dev Container后，查看扩展是否自动开始安装。

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