故障排查 预计阅读 7 分钟

开了 Clash 系统代理却不生效:浏览器插件冲突与终端环境变量分别排查

分两条线排查:浏览器侧检查代理插件与系统设置是否被覆盖,终端侧检查 http_proxy 环境变量与命令行工具的代理读取方式。

先测本地代理端口,再查应用设置

客户端里的「系统代理」开关负责写入操作系统的代理设置,不等于把所有进程的连接都送进 Clash。排查时把连接拆成两段:应用是否连到本地代理入站;请求进入内核后,规则把它交给哪个出站。浏览器打不开网页、终端命令超时和出口地址没变,可能分别卡在不同位置。

先在客户端的端口设置里读出当前监听值。下面用 mihomo 的 mixed-port: 7890 举例,它能接收 HTTP 和 SOCKS 代理请求;7890 只是示例,不是所有客户端的默认值。如果配置分开用了 port 和 socks-port,以下命令应取 HTTP 入站的 port,不要把控制接口 external-controller 的端口填进去。

curl -v --connect-timeout 5 --max-time 15 --noproxy "" --proxy http://127.0.0.1:7890 https://example.com/

Windows 上建议写 curl.exe,避免旧版 Windows PowerShell 把 curl 解释成别名。旧版 PowerShell 还可能丢弃传给外部程序的空字符串参数;若命令因此报参数错误,改在命令提示符中执行,将开头换成 curl.exe。这里的 --noproxy "" 用于清除本次测试继承的代理绕过列表。

浏览器:先排代理扩展,再核对系统地址

一次只保留一个代理设置来源

Chrome 打开 chrome://extensions/,Edge 打开 edge://extensions/。先暂停负责切换代理、按域名选线路或写入 PAC 的扩展。扩展里的「直连」通常是在明确指定直连,不等于「使用系统设置」。如果要保留扩展,选它的系统代理模式,再确认没有另一个扩展同时接管设置。

测试时重新加载目标页面,并用客户端连接记录确认确实产生了新请求。必要时彻底退出浏览器后再启动,避免沿用旧连接。不要只凭无痕窗口判断扩展是否已排除:有些扩展被允许在无痕模式运行,而设备策略也不会因为切换窗口而消失。设置显示由组织管理时,到 chrome://policy/ 或 edge://policy/ 查有效策略,受管设备交由管理员处理。

核对操作系统与 Firefox 的独立设置

如果系统地址刚写入就被改回,记录开关前后的值,再检查是否有另一个代理客户端、网络管理软件或组织策略在更新它。先找出写入来源,不要一边开多个客户端,一边来回切换规则模式。

终端:比较默认请求与显式代理请求

浏览器正常而终端失败,先用同一个终端、同一个目标运行上面的显式代理命令,再运行 curl -v https://example.com/。如果显式代理成功、默认请求却直接连目标地址,优先查工具读取环境变量的方式。以下是 POSIX shell 的临时设置,只影响当前 shell 和它随后启动的子进程:

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
curl -v https://example.com/

这里目标是 HTTPS,但代理地址仍以 http:// 开头:前者是访问目标的协议,后者是连接本地代理的协议。curl 对 HTTP 请求只认小写的 http_proxy,对 HTTPS 请求也支持大写 HTTPS_PROXY。若机器曾同时配置大小写版本,检查两份值是否一致;不要假设不同工具遇到冲突时都选同一个。

$env:http_proxy = 'http://127.0.0.1:7890'
$env:https_proxy = 'http://127.0.0.1:7890'
curl.exe -v https://example.com/

上面是 Windows PowerShell 的当前进程写法。已经启动的 IDE、后台服务、容器和其他终端不会继承此刻的修改。终端里 curl 正常,但 IDE 拉取依旧失败时,要在实际启动任务的环境里核对代理;如果是 Git,还可用 git config --show-origin --get-all http.proxy 检查是否有独立设置,以及设置来自哪个文件。不要把含账号密码的代理变量或完整日志直接贴到公开求助帖。

单个域名失效:区分绕过列表和内核规则

no_proxy 或 NO_PROXY 在应用侧生效。例如 curl 读取到 localhost,127.0.0.1,example.com 时,对 example.com 的请求会绕过配置的代理。用同一个 URL 对比普通请求和带 --noproxy "" 的显式测试;若只有普通请求跳过本地端口,再核对环境变量和工具自身的例外项。不要为修一个域名就永久清空公司内网的绕过名单。

内核规则则在请求进入 Clash 之后生效。观察连接记录时,对照请求发生的时间、域名、命中的规则以及出站链。若记录显示命中 DIRECT,检查这条规则是否在预期规则前面;若命中代理策略组但连接失败,检查组内当前选项和该出站的连通性。规则模式下通常按列表顺序匹配,把范围过宽的规则放在上面,后面的具体规则就可能没有机会生效。

修复后复测:用同一个目标确认两条路径

  1. 保留已验证的本地端口,选一个遇到问题的 URL。浏览器按平常的配置访问一次,终端再用不带 --proxy 的命令访问一次。两次分别对照客户端连接记录,不要只看页面是否打开。
  2. 如果只有浏览器缺少记录,回查扩展、策略、系统脚本和浏览器例外;如果只有终端缺少记录,回查变量、工具配置及进程运行的位置。如果两次都有记录,后续就从出站或目标服务查起。
  3. 关闭临时测试终端可丢弃这次设置的环境变量;若改动涉及持久化配置,按原先记录恢复不需要的变更。重新打开实际使用的终端和浏览器再测一轮,确认修复不依赖某个旧窗口。

复测仍失败时,记录操作系统、客户端和内核版本、入站类型与端口,以及失败发生在本地连接、CONNECT、TLS 还是目标响应阶段。配置字段的含义可对照配置字段文档。求助时提供这几项,比一句「开了但不走」更容易定位故障。

下载Clash