Docker 容器连不上代理？宿主机地址、环境变量与镜像拉取排查

电脑上的机场客户端能用，Docker 容器里的应用却连不上，先区分三个问题：容器能否到达宿主机代理、应用是否读取代理设置，以及失败发生在运行容器还是拉取镜像。把代理变量写进容器，并不等于镜像下载也会采用同一配置。

作者：小六｜资料核对日期：2026年10月12日。本文以 Windows 或 macOS 上 Docker Desktop 的普通 Linux 容器网络为例，讨论显式 HTTP 代理；原生 Linux Engine、远端守护进程和 host 网络模式应按对应环境核对。

一、先认清失败发生在哪个阶段

例如，镜像已经拉取成功，容器里的下载工具仍然超时，不能直接说“Docker 代理已经配置好了”。反过来，容器中某次请求成功，也不能证明镜像仓库的访问配置正确。

Docker 的容器代理配置文档明确区分容器环境变量与 Docker CLI、Engine 自身的代理。先记下报错来自哪一步，再选择对应设置，避免在三个位置反复复制同一段配置。

在本文讨论的普通容器网络中，容器有自己的网络环境。把宿主机上可用的 127.0.0.1:7890 原样填进容器，可能是在连接容器自己，并没有到达电脑上的代理程序。

Docker Desktop 官方建议，通过特殊名称 host.docker.internal 访问宿主机服务，它解析到宿主机使用的内部地址。见 Docker Desktop 常见问题。不要把一个教程里的网关 IP 当成所有电脑的固定值。

这也不是所有 Docker 环境都自动具有的名称。若名称无法解析，先确认使用的是 Docker Desktop、容器的网络模式及实际运行位置；不要立刻给系统 DNS 增加一个猜测地址。连接远端环境时，也不能把当前电脑当成那个环境的宿主机。

如果现有容器中已安装 curl，且确认宿主机提供 HTTP 代理，可参考以下写法：

curl --proxy http://host.docker.internal:7890 --noproxy "" --connect-timeout 10 --max-time 30 https://example.com/

7890 和目标网址是示例，必须替换为实际端口与测试目标；本文没有执行结果，不代表测速。--noproxy "" 只对这次对照请求覆盖已有代理排除设置，含义见 curl 官方手册。

保持宿主机客户端、节点和目标相同，观察相应时间的客户端记录。名称解析失败，先查容器环境；连接入口被拒绝，查程序是否运行及监听；出现认证要求，查入口认证；请求已进入但目标失败，再查规则与目标连接。

如果容器没有这个工具，可以使用现有应用支持的明确代理设置。为了测试再拉取一个新镜像，会把“镜像下载”问题混进来，未必能得到清楚的对照。

Docker 可以通过容器启动参数 --env 传入代理变量，也可以用客户端配置文件 ~/.docker/config.json 的 proxies 为新容器和构建准备相关设置。官方说明，这些配置不影响已经存在的容器。

因此，保存文件后只重启原有容器，不应被当成它已获得新变量的证明。按实际部署方式核对容器配置，确需重新创建时先处理数据卷和正在运行的任务，不为一次代理测试直接删除工作容器。

还要核对应用支持哪些变量，以及 NO_PROXY 等排除条件。Docker 文档提醒，各工具对代理变量及排除格式的处理并不完全统一。显式请求可用而平时操作失败时，应回到容器内应用的有效配置检查，可参考本站curl 代理设置排查。

Docker Desktop 的当前代理设置文档分别说明 Desktop proxy 与 Containers proxy 的职责，其中镜像拉取有专门的处理路径。按自己安装版本的设置说明核对，不能把容器内的变量当成界面配置已经生效的证据。

没有使用 Desktop 的 Engine 环境，应查守护进程代理说明。该文档也明确提醒，Desktop 会忽略 daemon.json 中的代理配置，应使用 Desktop 设置。分清产品环境后，再决定修改哪个入口。

构建步骤需要代理时，按构建方式使用相应参数；不要把仅供构建使用的私人代理信息用 Dockerfile 的 ENV 固化进镜像。Docker 容器代理文档说明了 --build-arg 的用途，也提醒环境中的代理信息可能以明文保存在容器配置里。求助不需要公开完整环境变量或认证地址。

通常不是这条问题的直接解法。端口发布主要让宿主机或外部访问容器服务，而这里是容器访问宿主机代理，方向不同。依据见 Docker Desktop 网络说明。

先根据实际请求判断是否被监听范围或访问规则挡住，再限定所需接口、端口与来源。不要一律开放所有接口；基础入口检查可参考共享代理监听排查。容器入口可用后，仍需核对应用真正发出的请求。

欢迎带着 Docker 类型、容器网络模式、失败阶段和脱敏后的错误交流，不必发送镜像中的私人配置或代理密码：Telegram 联系我。