现象:Windows 浏览器走 Clash,WSL2 里却像「没开代理」
在典型的 Windows 11 工作流里,你会先装好基于 Mihomo 的 Clash 图形客户端,导入可用配置,然后看到 Edge 或 Chrome 跟随系统代理或手动指向本地的 mixed 端口,访问外站没有压力。接着打开 WSL2 里的 Ubuntu(或其它发行版),执行 sudo apt update、git fetch 或 curl -I https://example.com,同一台机器立刻分裂成两种网络体验:下载卡在直连路径上,Clash 连接日志里却几乎看不到对应请求,仿佛子系统活在另一个世界。
这并不是玄学故障。WSL2 本质跑在轻量级虚拟化网络命名空间里:当 Linux 进程访问 127.0.0.1:7890 时,它连的是子系统自己的回环,而不是 Windows 上挂着 mixed 端口的那个进程。除非你显式把流量指向桥接到 Windows 的那一侧 IP,或者在宿主机上再做一层端口转发把 Windows loopback 映射到子系统能摸到的地址,否则你在 WSL2 里复制网上教程写的 export http_proxy=http://127.0.0.1:7890,语法完全正确,结果却永远是「连错了主机」。
如果你在 macOS 上也折腾过「终端不走系统代理」,本站《macOS 终端不走 Clash?环境变量与 Shell 配置排查》讲的是同一套心智模型:图形界面的开关 ≠ 命令行自动继承的契约。差别在于,macOS 上主要是 Shell 与 launchd 的加载顺序;而在 Windows + WSL2 上,边界是 Hyper-V 虚拟交换机隔开的两台逻辑主机。
先建立心智模型:一台笔记本,两个「局域网邻居」
请把 WSL2 与 Windows 想象成用虚拟网线连在一起的小型局域网。Clash 进程在 Windows 上监听 loopback、监听所有接口,或二者兼有,取决于你在客户端里怎么勾选。Linux 程序要想把 TCP 流交给 Clash,必须使用指向 Windows 那一侧网卡的 IPv4 地址(常见写法里叫它 WIN_IP 或「宿主机 IP」),而不是 Linux 自己的 127.0.0.1,除非你额外配置了把 Windows 端口「镜像」进客户机的机制。
这一句话能解释大量工单式提问:「我明明 export 了,为什么 apt 还是慢?」——export 可能已生效,但目标地址仍指向子系统本机,数据包根本没离开 WSL2 的协议栈,自然也不会触发 Windows 侧 Clash 的规则与日志。
步骤一:在 WSL2 里读出真实的 Windows 主机地址
在改 YAML、动防火墙之前,先把当前发行版默认用来访问 Windows 的 IPv4打印出来。较新的 WSL2 构建里,客户机默认路由的下一跳,往往与 /etc/resolv.conf 里由 Windows 侧参与生成的 nameserver 一致或高度相关。建议同时查看两条信息,避免只记其中一个在更新后漂移:
ip route show | grep -i default
grep -i nameserver /etc/resolv.conf
记下默认路由里的 via 地址,以及首个 nameserver。下文统一把它当作你在 shell 里要填的 Windows 主机 IP。若你装有多个 WSL 发行版,请在每个发行版里各执行一遍:虚拟网卡顺序在系统更新后可能变化,「在 A 发行版里好用的 IP」不一定在 B 里仍是最短路径。
为了减少每次重启后手工复制,可以把解析逻辑写进一小段 shell 函数(例如从 ip route 里 awk 出默认网关),但务必在重大 Windows 或 WSL 更新后复查一次。微软在过去几个版本里多次调整过 resolv 生成策略,「曾经稳」的取法有可能需要微调。
步骤二:让 Clash 在「WSL2 → Windows」这条路径上真正可达
打开你的 Clash / Mihomo 图形界面,确认当前使用的 mixed 端口,或拆分的 HTTP / SOCKS 端口(文档里常见 7890,请以你客户端状态页为准)。然后问自己两个问题:监听是否绑在仅 127.0.0.1?以及是否关闭了「允许来自局域网的连接」类选项?
若监听只绑定在 loopback,Windows 本机连 127.0.0.1 当然正常,但 WSL2 子网里的进程无法穿越虚拟交换机摸到那个套接字。对多数个人开发场景,较直接的修复是在你接受暴露范围的前提下,让 mixed 端口绑定到 0.0.0.0,并打开客户端里与 允许局域网(allow LAN)等价的开关,使桥接子网可以连入。随后请在 Windows Defender 防火墙里加一条窄范围的入站允许规则:尽量把来源限定在 vEthernet WSL 所在子网,而不是对整个「公用网络配置文件」大开绿灯。
如果你暂时不想在 0.0.0.0 上暴露监听,可以在 Windows 侧使用管理员权限执行 netsh interface portproxy,把子系统能访问的某个 listenaddress / listenport 转发到 127.0.0.1 上 Clash 实际监听的 connectport。具体 listen 地址取 WSL 虚拟网卡还是主机在桥接子网里的地址,取决于你的拓扑;先固定好步骤一得到的 WIN_IP,再用 WSL 里的 curl 分步验证,避免把网上一整段「一键端口转发」命令原样粘贴却与本地 IP 不符。
若你还希望把 Clash 共享给同一 Wi‑Fi 下的手机或其它电脑,涉及访客网络隔离、手动填代理等话题,可对照本站《Windows 上 Clash 局域网代理与手机 Wi‑Fi 场景》里的防火墙思路。WSL2 子网比咖啡馆局域网小得多,但「开 LAN 就要有对应的边界策略」这条原则是一样的。
步骤三:在 WSL2 里导出 http_proxy、https_proxy 与 ALL_PROXY
Debian / Ubuntu 系镜像里的多数 CLI 工具会认小写与大写的 HTTP_PROXY 系列变量,但生态碎片化程度和 macOS 类似。为减少「有的只认大写」的隐性坑,建议成对写入。若你还有依赖 SOCKS 的二进制,可同时设置 all_proxy。把步骤一的 WIN_IP 与步骤二确认过的 PORT 代入,一个常用模板如下(mixed 走 HTTP 语义时):
export http_proxy="http://WIN_IP:PORT"
export https_proxy="http://WIN_IP:PORT"
export HTTP_PROXY="$http_proxy"
export HTTPS_PROXY="$https_proxy"
export all_proxy="socks5h://WIN_IP:PORT"
export ALL_PROXY="$all_proxy"
若你的配置只提供 HTTP 而不在同一端口上复用 SOCKS,可删去 all_proxy 两行;若 HTTP 与 SOCKS 分开监听,请把 PORT 换成各自真实端口。socks5h 会把域名解析交给代理侧,需与你在 Clash DNS 段的策略一致,避免「HTTP 走通了但 SOCKS 路径解析分叉」。
导出后先跑 env | grep -i proxy,再用 curl -vI https://www.google.com 观察 verbose 输出:应能看到与 WIN_IP:PORT 的代理握手,而不是直连 TLS。确认无误后,把同一段写入 ~/.bashrc 或 ~/.zshrc。若你经常在办公 VPN 与家庭网络间切换,可以用一个小脚本在登录时选择「启用 / 清空代理」,避免全局永久强制代理给内网 Git 添堵。
步骤四:用 NO_PROXY 保护内网与本地开发流量
一旦 apt 与 git 能穿过 Clash,下一类典型故障是过代理:本地 Minikube、Docker 网桥、公司内网 Git、Windows 文件共享经过地址转换后的目标,本应保持直连,却被一股脑送进代理。请维护一份有意识的 no_proxy 列表,并镜像到 NO_PROXY:
export no_proxy="127.0.0.1,localhost,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16,*.local"
export NO_PROXY="$no_proxy"
通配符支持因库而异。遇到顽固案例时,把具体主机名逐条枚举往往比依赖宽泛模式更可靠。这个步骤是从「全局代理进 WSL2」平滑过渡到「开发机还要访问局域网服务」的桥梁。
步骤五:apt、git 以及那些不完全听话环境变量的程序
apt 除环境变量外,还会读取 /etc/apt/apt.conf 及 /etc/apt/apt.conf.d/ 下的片段。交互式排错用 export 往往足够;若你在构建自动化镜像,可把 Acquire::http::Proxy 与 Acquire::https::Proxy 写成与 curl 验证过的同一 http://WIN_IP:PORT,避免 CI 与手工 shell 行为不一致。
Git 可能单独启用 git config --global http.proxy,其优先级足以让你怀疑「环境变量是不是没生效」。用 git config --global --get http.proxy 查看;不需要时 git config --global --unset http.proxy。若远端是 [email protected]: 的 SSH 形式,流量路径由 ssh 与 ~/.ssh/config 的 ProxyCommand 决定,而不是 HTTPS_PROXY,排错时请切换问题域。
从 WSL2 启动、却自带独立网络命名空间的容器运行时,不要把父 shell 的 export 当成子环境的必然继承;每个运行时都要按同一套 WIN_IP 故事单独验收。
步骤六:当 TCP 已通,仍卡在解析或奇怪 CDN 边时——对齐 WSL2 DNS
如果 curl 通过代理握手已经正常,但仍出现「能解析却连不对」「部分域名永远落到奇怪的 CDN」等现象,嫌疑会落到 Linux 解析器与 /etc/resolv.conf 上。WSL2 可能在每次启动时重写该文件,把查询导向 Windows 侧参与的 stub,与你在 Mihomo 里使用的 fake-ip 或 redir-host 模型产生预期差。
需要完全自控时,可在 /etc/wsl.conf 中关闭自动生成(如设置 generateResolvConf = false),再手写 /etc/resolv.conf,把 nameserver 指到你真正信任的地址——有时是 Linux 侧本地 stub,有时是策略允许的上游公共解析。代价是你必须自己维护生命周期:一份写错的静态 resolv 比系统托管的默认行为更难排查。
请把这一节与 Clash 图形界面里的 DNS 面板对照阅读:若你希望「所有名字最终都由核心按规则处理」,就要避免操作系统在核心之外绕路抢答。若你考虑在宿主机启用 TUN 做更粗粒度统一接管,可延伸阅读本站《Clash TUN 模式完全指南》,权衡「只在 WSL2 里 export」与「在 Windows 层统一捕获」的复杂度。
一次性验证清单(建议按顺序勾完)
- 在 Windows 上确认 Clash mixed(或 HTTP)端口监听位置与客户端日志级别合理,能看清新连接。
- 在 WSL2 中打印
ip route与resolv.conf,写下本环境当前的WIN_IP。 - 在 WSL2 内执行
curl -vI http://WIN_IP:PORT,区分「防火墙拒绝」与「应用层拒绝」。 - 导出
http_proxy/HTTPS_PROXY后,再用curl -vI https://example.com确认握手走代理。 - 在 apt 继承环境或通过 apt.conf 显式配置后,跑
sudo apt update试拉索引。 - 对允许的 HTTPS 远端执行
git ls-remote冒烟测试。 - 若仅名字失败,临时切换你可控的解析对比 Mihomo DNS 与 fake-ip 设定。
与裸机 Linux、macOS「只改 shell」方案有何不同
在单一裸机 Linux 安装上,127.0.0.1:7890 通常确实就是本机 Clash。macOS 上,Terminal 与 Safari 共享同一内核的 loopback 语义,虽然环境变量仍要单独配置,但至少不会遇到「127 不是同一个 127」的问题。Windows 11 + WSL2 是异类:客户机里的回环与宿主机服务监听不在同一接口上,第一跳排错必须从虚拟网卡与默认路由开始,而不是先怀疑节点延迟。
安全提示:端口、防火墙与解析文件都不是「随便点点」
把监听从纯 loopback 扩到子网、修改防火墙、动 portproxy、手写 resolv,都属于高影响操作。请保持 Clash / Mihomo 构建来源可信,防火墙规则尽量窄,拒绝把不明来源的「万能转发」脚本直接粘贴进管理员 PowerShell。若需核对客户端能力与文档口径,可先浏览本站使用文档;若需查阅开源协议或上游源码,再单独打开 GitHub,与日常安装包获取路径区分开。
小结
当你不再把 WSL2 当成「只是多了一个终端」,而是把它看作带独立默认路由的客户机,Windows 11 上的 Clash 行为就会变得可预期:先拿到 WIN_IP,再让 mixed 端口在该路径上可达(允许局域网 + 收紧防火墙,或 netsh 转发),随后在子系统里稳定导出 HTTP_PROXY 系列,必要时为 apt / git 补专用配置,最后让 WSL2 DNS 与 Mihomo 的解析模型对齐。做到这一步,curl、apt 和长会话的 git 才能与 Edge 共用同一套策略,而不必在每次系统更新后重新「玄学重装」。
相比零散脚本临时拼出来的方案,维护良好、日志清晰的 Mihomo 系 Clash 客户端在 Windows 上仍更容易把这条「虚拟网桥」走稳:规则、DNS、模式切换都在同一套界面里可观测。若你尚未安装或准备换用更一致的版本,可从本站客户端下载页获取 Windows 安装包,再按本文步骤完整验收一遍。