章节索引
主机浏览器能够联网,只证明主机这一侧的访问正常。子系统、构建任务和运行容器各有自己的网络视角,因此直接复制主机地址容易连错位置。先把失败动作归到具体进程,再临时验证地址是否可达,成功之后再考虑保存长期配置。
把 失败请 求对应到实际进程
先确认连接从哪里发出
| 操作表现 | 负责联网的位置 |
|---|---|
| 子系统终端下载停住 | 发行版里正在执行的命令进程 |
| 拉取镜像没有返回 | 容器桌面程序或独立守护服务 |
| 构建中的软件安装失败 | 负责构建的任务与临时容器 |
| 应用启动后访问失败 | 已经运行的应用容器 |
回环地址表示当前网络环境自身。主机进程监听本机回环入口,不等于子系统和容器也能通过相同写法访问它。先检查网络隔离方式,再填写当前环境确实能到达的宿主地址。
- 主机侧代理入口监听位置须允许目标环境连接
- 子系统里的进程向可达的宿主地址发起请求
- 镜像构建阶段由构建任务接收所需代理变量
- 容器中的应用再核实具体工具读取哪些选项
同样的回环写法放在不同环境中,含义可能改变。只有先验证宿主入口,再传入应用设置,才能避免请求被送回隔离环境自身。
先 开放 必要的 宿 主监听范围
在主机客户端核对当前监听端口和地址。使用宿主网络地址访问时,可能需要允许局域网连接;同时还要确认监听位置覆盖目标环境,不能只看界面上的开关。
允许局域网连接会扩大访问范围,应限制在可信网络和必要来源内。配合防火墙约束访问,不把缺少认证的代理暴露到公共网络;不再需要这条路径时可收回开放设置。
根 据网 络模式判断宿主位置
使用地址转换网络时,可从子系统默认路由寻找宿主侧地址线索。镜像网络下的访问方式可能不同,不能把某一种模式的写法当作所有环境都成立的规则。
# HOST_PROXY_URL 应先填写为已确认可达的宿主入口
curl -I -x "${HOST_PROXY_URL}" https://example.com 端口拒绝连接时,先查监听地址、局域网权限和防火墙。入口能连上而目标请求无返回时,再沿分流规则和外部访问继续排查。取得正常响应后,才把这个入口交给环境变量。
临时 设置 终端变 量后 重做 原请求
# HOST_PROXY_URL 应先填写为已确认可达的宿主入口
export HTTP_PROXY="${HOST_PROXY_URL}"
export HTTPS_PROXY="${HOST_PROXY_URL}"
export NO_PROXY="localhost"
curl -I https://example.com 临时变量由当前终端启动的程序读取。验证成功后再按 shell 的启动机制保存;某些工具区分变量大小写,因此仅设置大写名称并不能覆盖所有请求方式。
系统软件安装工具可能使用自己的代理项,也可能读取小写变量。通过提权命令启动时,环境是否被保留同样影响结果;应在真正执行下载的进程里确认。
支持自动导入主机代理的环境,可检查相应配置项并重启子系统,再查看实际变量。自动导入是否成功仍以进程看到的值与请求结果为依据。
把需要留在本地网络的服务加入绕过范围。内部域名和私有地址是否适合直连,应根据服务部署位置决定,不能照抄别的环境。
镜 像拉 取要 检 查守护端设置
终端里导出的变量只作用于读取它们的进程,不能据此认定桌面容器程序已经取得同样的镜像拉取设置。
在桌面程序的资源或代理分区核对实际入口,再应用配置。菜单位置可能变化,重点是找到负责外部下载的那一项。
若界面分别提供程序代理与容器代理,需要检查拉取镜像实际使用哪套设置。应用改动后直接重做原拉取任务,不以终端访问成功代替验证。
桌面封装与独立守护进程读取配置的方式并不相同。判断哪份文件有效之前,应先确认当前运行形态。
独立运行的守护服务,应按其配置文件或服务环境设置代理,并正常重启服务。不要同时修改多处入口,再猜哪一项产生了效果。
构建任务和运行应用分别接收变量
构建参数与容器运行环境是不同入口,应分别传入所需值。带凭据的代理地址不宜写死在镜像构建文件中,以免随配置或历史记录保存。
构建命令应在已有项目目录中使用,并按项目替换示例名称。它不是独立的连通性检查;应先确认容器能访问宿主入口,再排查具体构建步骤。
# HOST_PROXY_URL 应先填写为容器能够访问的宿主入口
docker build --build-arg HTTP_PROXY="$HOST_PROXY_URL" --build-arg HTTPS_PROXY="$HOST_PROXY_URL" -t demo-app .
docker run --rm --env HTTP_PROXY="$HOST_PROXY_URL" --env HTTPS_PROXY="$HOST_PROXY_URL" --env NO_PROXY="localhost" demo-app 某些桌面容器环境提供指向宿主的内部主机名,独立运行环境则可能需要网关设置。是否可用应在目标容器里验证解析和端口,而非只在主机上检查。
常见疑问
主机能联网为何构建仍失败?构建任务拥有自己的环境,需要检查参数是否确实传入。内部服务为什么也经过代理?先看目标进程的 NO_PROXY 是否包含实际服务名及地址。绕过项已经填写为何仍无效?不同工具对匹配表达式的支持可能不同,要在目标进程中查看变量并重做访问。
含凭据的地址应保存在适合项目的本地私密配置中。公开构建文件、运行清单和日志不应带出完整访问凭据。
按请求发生的位置逐项验证
- 子系统终端可以经已确认的主机入口取得响应
- 镜像拉取动作完成,守护端没有对应访问错误
- 构建期间所需下载能够继续执行
- 运行应用可访问目标,同时保留内部服务直连
