章节索引
浏览器在宿主机上正常访问,无法说明容器的依赖安装也有相同路径。查看构建输出与容器终端,确定失败命令在哪运行,再检查它能否访问代理,以及内部数据库是否被错误地送往代理。
依 据失败阶 段找到设置入口
先从编辑器输出或终端记录定位拉镜像、构建指令、运行中工具及扩展下载。它们由不同进程发起请求,设置也需要对应到实际运行环境。
请求来源和配置范围
| 哪一步出现错误 | 谁负责建立连接 | 对应设置位置 |
|---|---|---|
| 基础镜像无法取得 | 容器守护进程 | 桌面容器工具或 daemon 的代理设置 |
| 构建文件中的安装命令 | 构建镜像的进程 | 构建参数或构建器选项 |
| 运行中容器的下载命令 | 容器内的工具进程 | 容器变量、远程变量或工具自身设置 |
| 远程开发扩展获取失败 | 宿主编辑器及容器服务端 | 两侧网络条件及扩展的独立配置 |
容器尚未启动时,给运行环境增加变量无法影响更早的镜像获取。查看输出面板标记的阶段,再修改负责该阶段的设置。
- 宿主编辑器调用容器工具,也可能自行获取扩展
- 镜像构建读取构建参数或容器工具的代理配置
- 启动后的容器使用自己的环境变量
- 远程终端及扩展还可能读取工具单独保存的设置
先确定请求所在层,再检查该层的变量。宿主机、构建进程和运行容器不会因为名称相同就自动共享所有配置。
先确认 容器能到达宿 主端口
容器中的回环地址指向容器自身。宿主代理需要通过容器可访问的地址连接;桌面容器环境可核对 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,再检查直连是否恢复。
镜像重建仍 然中断
根据失败指令回到镜像拉取或构建参数,确认错误是否发生在容器启动之前。
共享项目前移除个人连接信息
团队配置可以读取开发者本机的代理变量,也可以提供不带真实地址的示例文件,让每个环境自行填写。
项目说明应写清代理地址格式和配置范围。提交前检查连接字符串里有无个人用户名、口令或私密参数。
分别检查镜像获取、重建、容器内工具和本地服务,保存失败阶段对应的输出。依照实际请求来源处理,避免为了单个错误同时改变全部环境。
