开发环境

在 VS Code Dev Containers 中按报错阶段核对代理设置

开发容器的镜像获取、构建命令和运行中下载各有请求来源。先找到报错阶段,再检查宿主端口和对应环境变量,最后确认内部服务仍可直连。

  • #编辑器
  • #开发容器
  • 容器环境
  • 接配置
章节索引

浏览器在宿主机上正常访问,无法说明容器的依赖安装也有相同路径。查看构建输出与容器终端,确定失败命令在哪运行,再检查它能否访问代理,以及内部数据库是否被错误地送往代理。

依 据失败阶 段找到设置入口

先从编辑器输出或终端记录定位拉镜像、构建指令、运行中工具及扩展下载。它们由不同进程发起请求,设置也需要对应到实际运行环境。

请求来源和配置范围

哪一步出现错误谁负责建立连接对应设置位置
基础镜像无法取得容器守护进程桌面容器工具或 daemon 的代理设置
构建文件中的安装命令构建镜像的进程构建参数或构建器选项
运行中容器的下载命令容器内的工具进程容器变量、远程变量或工具自身设置
远程开发扩展获取失败宿主编辑器及容器服务端两侧网络条件及扩展的独立配置

容器尚未启动时,给运行环境增加变量无法影响更早的镜像获取。查看输出面板标记的阶段,再修改负责该阶段的设置。

从宿主到容器逐层检查
  1. 宿主编辑器调用容器工具,也可能自行获取扩展
  2. 镜像构建读取构建参数或容器工具的代理配置
  3. 启动后的容器使用自己的环境变量
  4. 远程终端及扩展还可能读取工具单独保存的设置

先确定请求所在层,再检查该层的变量。宿主机、构建进程和运行容器不会因为名称相同就自动共享所有配置。

先确认 容器能到达宿 主端口

容器中的回环地址指向容器自身。宿主代理需要通过容器可访问的地址连接;桌面容器环境可核对 host.docker.internal,Linux 环境还需确认网关映射。

宿主只监听回环接口时,容器可能无法建立连接。调整监听范围前,先用防火墙约束允许来源,避免将代理端口开放到公共网络。

先在运行中的容器终端检查地址及端口。临时 docker run 检查命令应在 Linux 宿主运行,不要在开发容器中再次创建测试容器,示例端口需与实际监听值一致。

从容器检查解析与代理连接,端口按本机设置填写
PROXY_HOST=host.docker.internal
PROXY_PORT=7890
getent hosts "$PROXY_HOST" || true
curl -v -x "http://$PROXY_HOST:$PROXY_PORT" https://www.example.com/

# Linux 宿主机中的临时连接检查
docker run --rm --add-host=host.docker.internal:host-gateway curlimages/curl:latest -v -x http://host.docker.internal:7890 https://www.example.com/

为 Li nux 环 境添加宿主映射

开发容器配置中的网关映射示例
{
  "runArgs": [
    "--add-host=host.docker.internal:host-gateway"
  ]
}

映射修改后,需要重建开发容器,原先已经运行的实例不会自动取得新 hosts 条目。

使用 Compose 时,在对应服务中设置 extra_hosts;先确认配置入口,避免在多处重复定义相同映射。

连通端口后 再安排 环境变量

在容器中确认 curl 能通过代理取得响应,再配置工具变量。Dockerfile 或 image 项目可查看下面示例;Compose 项目应把容器变量写在服务配置中,远程变量留在开发环境设置里。

容器环境与远程环境的变量衔接示例
{
  "containerEnv": {
    "HTTP_PROXY": "http://host.docker.internal:7890",
    "HTTPS_PROXY": "http://host.docker.internal:7890",
    "NO_PROXY": "localhost,127.0.0.1,::1,host.docker.internal",
    "http_proxy": "http://host.docker.internal:7890",
    "https_proxy": "http://host.docker.internal:7890",
    "no_proxy": "localhost,127.0.0.1,::1,host.docker.internal"
  },
  "remoteEnv": {
    "HTTP_PROXY": "${containerEnv:HTTP_PROXY}",
    "HTTPS_PROXY": "${containerEnv:HTTPS_PROXY}",
    "NO_PROXY": "${containerEnv:NO_PROXY}",
    "http_proxy": "${containerEnv:http_proxy}",
    "https_proxy": "${containerEnv:https_proxy}",
    "no_proxy": "${containerEnv:no_proxy}"
  }
}

HTTPS_PROXY 的地址描述所连接的代理端口,使用 http 协议并不代表关闭目标网站的 HTTPS。NO_PROXY 应包含内部服务名与开发域名,避免数据库请求经由代理绕行。

配置保存后,在新终端检查生效变量。旧进程可能保留启动时的环境,应按修改范围决定重连还是重建。

构建参数与运行变量 分别检查

基础镜像请求由 daemon 或构建器处理,构建文件的 RUN 指令则需要对应构建参数。Linux 的运行时映射不覆盖构建阶段,需另查 build.options;个人代理及认证内容不应固化在镜像里。

构建阶段的代理及网关参数示例
{
  "build": {
    "dockerfile": "Dockerfile",
    "args": {
      "HTTP_PROXY": "http://host.docker.internal:7890",
      "HTTPS_PROXY": "http://host.docker.internal:7890",
      "NO_PROXY": "localhost,127.0.0.1",
      "http_proxy": "http://host.docker.internal:7890",
      "https_proxy": "http://host.docker.internal:7890",
      "no_proxy": "localhost,127.0.0.1"
    },
    "options": [
      "--add-host=host.docker.internal:host-gateway"
    ]
  }
}

逐个 检查工具与 扩展下载

在容器里查看代理变量后,分别运行源码工具和包管理器。若某个工具仍连接旧地址,继续查它保存的独立配置,而不是反复覆盖容器变量。

扩展下载可能涉及宿主编辑器和容器服务端。调整 remoteEnv 后,重连并从新进程查看日志;只修改远程变量时,应先确认重连效果,再决定是否需要重建。

容器里的源码连接检查,目标可替换为项目仓库
REPO_URL='https://github.com/octocat/Hello-World.git'
env | grep -i '_proxy'
git config --show-origin --get-regexp 'http.*proxy' || true
git ls-remote "$REPO_URL"

# 临时请求通过参数指定代理
git -c http.proxy=http://host.docker.internal:7890 ls-remote "$REPO_URL"

curl 可用而源码工具 仍失败怎么办?

从 git config 的来源输出找出旧代理位置,检查用户配置与仓库配置是否覆盖了环境变量。

软件源 更新失败应查什 么?

查看错误里的仓库主机及证书,再检查 /etc/apt/apt.conf.d 是否有单独的代理定义。

程序可运行,扩展为何无法获取?

查看开发容器输出中的扩展请求,确认远程服务取得了所需变量,并检查下载地址的连接情况。

本地数据库连接出现异常

将数据库的服务名称与实际内部范围加入 NO_PROXY,再检查直连是否恢复。

镜像重建仍 然中断

根据失败指令回到镜像拉取或构建参数,确认错误是否发生在容器启动之前。

共享项目前移除个人连接信息

团队配置可以读取开发者本机的代理变量,也可以提供不带真实地址的示例文件,让每个环境自行填写。

项目说明应写清代理地址格式和配置范围。提交前检查连接字符串里有无个人用户名、口令或私密参数。

分别检查镜像获取、重建、容器内工具和本地服务,保存失败阶段对应的输出。依照实际请求来源处理,避免为了单个错误同时改变全部环境。

出处与查阅入口