为什么容器看起来「绕开」了宿主机上的 Clash?

这是很多开发者在本地调试时的典型困惑:Windows 或 macOS 上,Clash 客户端已经运行,浏览器访问检测站能看到代理出口;但一进 Docker 里执行 curl、apt update、pip install,要么长时间卡住,要么仍然像直连本地宽带。搜索里常出现「Docker Clash」「容器代理」——问题往往不在订阅坏了,而在网络命名空间:默认的桥接网络把容器放在独立栈里,容器内的 127.0.0.1 指向容器自己,而不是宿主机。你在宿主机上开的 Clash 混合端口,在容器里用 http://127.0.0.1:7890 去连,等于让容器连自己的空端口,自然「完全不走 Clash」。

另一条常见误区是:以为设置了宿主机的「系统代理」,容器就会自动继承。多数情况下,系统代理与 Docker 守护进程拉起的容器进程无直接关系;要让容器内工具走代理,需要显式配置环境变量(如 HTTP_PROXY、HTTPS_PROXY)或等价机制,并且把代理地址写成从容器路由可达的宿主机 IP 或专用主机名。下文按「概念 → 宿主机地址 → Clash 监听 → docker run → Compose → 验证与排错」给出可复现步骤。

若你在 WSL2 里跑 Docker 而 Clash 在 Windows 宿主机上,回环地址与 DNS 还会再多一层差异,可对照《WSL2 终端不走 Clash?宿主机代理桥接与 DNS 同步》;若你主要在 macOS 终端里配环境变量,可并行阅读《macOS 终端与 Homebrew 代理环境变量》——本文专注容器与桥接网络,与上述场景互补。

桥接网络里,127.0.0.1 与「宿主机」不是同一个东西

Docker 默认把容器接到 bridge 网络上:容器拿到的是虚拟网段里的一个 IP,通过 NAT 访问外网。此时:

  • 容器访问自己监听的端口:用 127.0.0.1 正确。
  • 容器访问宿主机上监听的端口:不能用宿主机的 127.0.0.1,而要使用宿主机在容器视角下的地址——例如 Docker Desktop 提供的 host.docker.internal,或 Linux 上常见的 docker0 网桥网关 IP(常见为 172.17.0.1,以你机器 ip route 为准)。

只有把 HTTP_PROXY 写成「http://<宿主机可达地址>:<Clash 混合端口>」,容器内的 HTTP 客户端才会把请求发到宿主机上的 Clash 入站,再由 Clash 规则决定直连或出节点。若地址写错,现象就是「Clash 连接面板里根本看不到容器流量」,因为流量从未到达 Clash。

第一步:确定「从容器里能 ping 通」的宿主机地址

按你的运行环境选择其一(可先在容器里 getent hosts host.docker.internal 或查看路由表验证):

  • Docker Desktop(Windows / macOS):优先使用 host.docker.internal。这是 Docker 注入的特殊 DNS,解析到宿主机在桥接网络中的可达地址。
  • Linux 原生 Docker:通常使用默认 bridge 的网关,多为 172.17.0.1;若你自定义了网段,请用 docker network inspect bridge 查看 Gateway。部分环境也可配置 extra_hosts 模拟 host.docker.internal。
  • 需要与宿主机网络完全同一视角时:可考虑 network_mode: host(Linux 上语义最直白;Windows / macOS 的 Docker Desktop 行为与 Linux 不同,需以官方文档为准)。在 host 网络下,127.0.0.1 才再次与宿主机本地回环对齐,但隔离性与端口冲突风险也更高,适合明确需要的场景而非默认首选。
ℹ️
占位符说明:下文示例用 7890 作为 Clash 混合端口占位;请你替换为自己客户端界面显示的实际端口。端口不一致时,代理环境变量怎么写都不会通。

第二步:Clash 侧确认混合端口与 Allow LAN

在 Clash Verge Rev、ClashX Meta、FlClash 等客户端中,确认混合端口 / Mixed Port已启用且数值与即将写入环境变量的端口一致。若 Clash 只监听 127.0.0.1,从容器经网桥过来的连接会被拒绝——需要让入站监听在宿主机的局域网接口上(常见表述为「允许来自局域网的连接」或 Allow LAN),使 172.x.x.1:7890 这类来源可以连上混合端口。

打开 Allow LAN 意味着同一局域网内的其他设备理论上也能访问你的代理入站,请在可信网络环境下使用,并在不需要时关闭。安全与便利需要自行权衡。更系统的分流与策略仍建议以 YAML 规则为准,可结合《Clash 规则分流配置详解》维护策略组与规则顺序。

若你刚完成客户端安装与订阅导入,可先通读文档与基础教程,再回本文对齐端口与 Docker 环境变量,避免在低层网络上反复试错。

第三步:用 docker run 注入 HTTP_PROXY(实测)

下面示例在启动交互容器时传入代理环境变量(请替换主机名与端口):

# docker run — replace host and port; host.docker.internal works on Docker Desktop
docker run --rm -it \
  -e HTTP_PROXY="http://host.docker.internal:7890" \
  -e HTTPS_PROXY="http://host.docker.internal:7890" \
  -e http_proxy="http://host.docker.internal:7890" \
  -e https_proxy="http://host.docker.internal:7890" \
  -e NO_PROXY="localhost,127.0.0.1,::1" \
  -e no_proxy="localhost,127.0.0.1,::1" \
  curlimages/curl:latest \
  sh -c 'curl -I --connect-timeout 10 https://www.google.com'

在 Linux 且没有 host.docker.internal 时,把上述主机名换成你的 bridge 网关,例如 http://172.17.0.1:7890。同时设置大小写两套变量,可减少部分工具只认大写或小写的历史包袱。NO_PROXY 用于让访问本地 Registry、内网 API 时不强行走代理,避免把不该过 Clash 的流量也塞进代理链。

第四步:Docker Compose 里对齐 HTTP_PROXY

在 docker-compose.yml 中,可在 environment 段写入与上文相同的一组变量;若多个服务共用,也可用 env_file 或在 shell 中 export 后由 Compose 继承。注意:build 阶段拉基础镜像时,若需要代理,可能还要配置 build 级别的 args 或 Docker Buildx 的代理设置,这与运行容器时的 environment 是两条路径,排错时要分开看。

# docker-compose.yml excerpt — proxy for a service (YAML)
services:
  app:
    image: your-image:tag
    environment:
      HTTP_PROXY: "http://host.docker.internal:7890"
      HTTPS_PROXY: "http://host.docker.internal:7890"
      http_proxy: "http://host.docker.internal:7890"
      https_proxy: "http://host.docker.internal:7890"
      NO_PROXY: "localhost,127.0.0.1,::1,your.internal.domain"
      no_proxy: "localhost,127.0.0.1,::1,your.internal.domain"

多项目并行时,建议把代理地址与 NO_PROXY 列表收拢到团队文档,避免有人仍把 127.0.0.1 写进 HTTP_PROXY 导致「只有我的机器能复现」的隐性问题。

第五步:验证与排错清单

在容器内依次检查:

  • echo "$HTTP_PROXY" 是否为指向宿主机可达地址的 URL,而不是 http://127.0.0.1:...(除非使用 host 网络且你明确如此设计)。
  • curl -I --connect-timeout 10 https:// 某外站,观察是否与宿主机浏览器出口一致(具体结果受节点与站点策略影响)。
  • 打开 Clash 连接日志或面板,确认在发起请求时出现对应连接;若完全没有,优先怀疑监听地址、Allow LAN、防火墙或 Docker 网络模式。
  • 若仅 HTTPS 失败,检查是否混用了只支持 HTTP CONNECT 的端口、或公司证书与 MITM 与容器内 CA 信任不一致(超出本文范围,需单独排查)。
⚠️
安全提示:全局 Allow LAN 与宽泛的 HTTP_PROXY 会扩大暴露面。仅在开发与可信网络中使用;生产环境请使用专用出口、服务网格或策略明确的出站网关,而不是把桌面 Clash 当作长期后端依赖。

备选:不想逐容器配环境变量时

在宿主机侧启用 Clash TUN 模式可以在更底层接管流量,减少对「每个容器是否读取 HTTP_PROXY」的依赖;但影响范围更大,权限与路由要求也更高。适用场景与注意点见《Clash TUN 模式详解》。与本文的显式环境变量方案并不冲突,可按团队规范二选一或组合使用。

写在最后

Docker Clash 类问题的核心,是同时理解三件事:桥接网络里容器与宿主机的地址关系、Clash 混合端口在宿主机上的真实监听范围、以及 HTTP_PROXY 如何把应用层请求交给本地入站。把「127.0.0.1 在容器内≠宿主机」这条记牢,再按步骤替换为 host.docker.internal 或网关 IP,多数「容器总绕开代理」的现象会立刻消失。相比反复重装 Docker 或 Clash,按清单自检能更快定位问题。

若你希望使用维护活跃、对 Mihomo 内核兼容友好的发行版,可从我们的客户端下载页获取适合当前系统的安装包,再结合文档完成基础配置后,回到本文核对混合端口、Allow LAN 与容器环境变量即可。→ 立即免费下载 Clash,开启流畅上网新体验。