先确认 Clash 的本地代理端口
客户端里的「系统代理」开关,通常只是把本机代理地址写入操作系统。浏览器可以读取这份设置,也可能被扩展、手动配置或管理策略覆盖。命令行工具则各有自己的设置来源:浏览器已经能访问,不代表同一台电脑上的终端会走同一个端口。
- 先看客户端显示的内核运行状态和当前端口。以 Clash 或 mihomo 为内核的客户端里,
mixed-port是同时接受 HTTP 和 SOCKS 连接的混合端口;port是 HTTP 代理端口,socks-port是 SOCKS 代理端口。下文按 HTTP 或混合端口7890举例,若运行界面显示7897,就把命令里的端口一并替换。 - 地址用
127.0.0.1,前提是客户端和测试程序在同一系统环境里。不要把控制器端口(例如9090)当成代理端口。WSL、虚拟机和容器里的127.0.0.1不一定能到达宿主机,先在宿主机终端跑通再分别排查。 - 打开客户端的连接记录或日志,再发一次测试请求。看到目标域名后,继续看它命中了哪条规则、最终走的是
DIRECT还是代理节点。规则模式下命中DIRECT,只说明这条请求从 Clash 直连出去,并不等于应用没接入 Clash。
浏览器不生效:查系统地址、扩展和例外列表
系统代理里有地址,不只是客户端里有开关
- Windows 11:「设置」→「网络和 Internet」→「代理」,在「手动设置代理」下检查「使用代理服务器」的地址和端口是否与客户端一致。若另有「使用设置脚本」,先确认它是不是单位下发的配置,别直接删除。
- macOS 13 及以后:「系统设置」→「网络」→ 选中当前使用的网络服务 →「详细信息」→「代理」。Wi‑Fi 和有线网络要分别看;核对 HTTP 与 HTTPS 对应的代理项,以及要测试的域名是否列在绕过代理的名单中。
- Firefox:「设置」→「常规」→ 页面底部「网络设置」→「设置」。如果希望跟随操作系统,确认选中「使用系统代理设置」,而不是「不使用代理」、旧的手动地址,或另一份自动代理配置。
用同一个网址定位覆盖发生在哪一层
在 Chrome 的 chrome://extensions/ 或 Edge 的 edge://extensions/ 暂停自己安装的代理切换扩展,再用新标签访问 https://example.com/,对照 Clash 中对应时刻的连接记录。无痕窗口不适合替代这一步:被允许在无痕模式运行的扩展仍可能生效。若浏览器显示由组织管理,可在 chrome://policy/ 或 edge://policy/ 查看是否存在代理策略,受管设置应由管理员确认。
只有一个网站表现异常时,再用那个具体域名复测。主页面、登录跳转和图片可能来自不同域名,连接记录里要找的是失败的那条请求。如果目标已经出现在记录中,先查规则目标和节点报错;如果没有出现,再核对系统例外列表、浏览器代理配置,以及页面是否只是从缓存加载。
终端不生效:先用 curl 指定代理做对照
下面两条命令请求同一个 HTTPS 地址,第一条让 curl 不使用代理,第二条明确连接本机 HTTP 代理,并把本次的代理例外限制为两个本机地址,避免已有的 NO_PROXY=* 让测试绕过代理。两条命令都设置了 8 秒连接超时和 15 秒总时限。Windows PowerShell 请把 curl 写成 curl.exe,避免旧版 PowerShell 把它解析成别的命令。
curl --noproxy "*" -v -I --connect-timeout 8 --max-time 15 https://example.com/
curl --proxy http://127.0.0.1:7890 --noproxy "localhost,127.0.0.1" -v -I --connect-timeout 8 --max-time 15 https://example.com/
| 第二条命令的结果 | 下一步 |
|---|---|
连接 127.0.0.1:7890 被拒绝 | 检查内核是否运行、端口是否填错、终端是否和内核在同一系统环境。这个阶段还没连目标网站。 |
已连接本机端口,但 CONNECT 失败 | 确认使用的是 HTTP 或混合端口,再对照 Clash 日志检查规则、节点连接和目标解析报错。 |
CONNECT 已建立,但随后报 TLS 错误 | 区分隧道成功与目标站证书验证成功。检查系统时间、目标域名和工具的证书信任配置,不要把关闭证书验证当作修复。 |
| 收到目标站的 HTTP 响应 | 显式代理已用于本次请求。还需在连接记录里查看走的是代理节点还是 DIRECT;两条命令都成功也可能是正常结果。 |
如果实际配置只开了 SOCKS 端口,例如 1080,第二条命令的代理参数可以改成 --proxy socks5h://127.0.0.1:1080,让 curl 把目标主机名交给 SOCKS 代理解析。别在同一个端口上反复更换协议来碰运气,先认准它对应的字段。
显式代理能用,再检查环境变量和工具配置
如果带 --proxy 能用,去掉就不行,先确认工具读取什么。对 curl,可以在当前终端临时设置 http_proxy 和 https_proxy。变量名区分目标 URL 的协议;即使访问的是 HTTPS 网站,只要本地代理入口说的是 HTTP,变量值仍应以 http:// 开头。curl 对 HTTP 目标只认小写 http_proxy,在区分大小写的系统里不要只设 HTTP_PROXY。
Bash 或 zsh:只给一次命令传值
http_proxy=http://127.0.0.1:7890 \
https_proxy=http://127.0.0.1:7890 \
no_proxy=localhost,127.0.0.1 \
curl -v -I --connect-timeout 8 --max-time 15 https://example.com/
PowerShell:在新窗口内临时设置
$env:http_proxy = 'http://127.0.0.1:7890'
>$env:https_proxy = 'http://127.0.0.1:7890'
>$env:no_proxy = 'localhost,127.0.0.1'
>curl.exe -v -I --connect-timeout 8 --max-time 15 https://example.com/
PowerShell 的这些设置只影响当前进程及其后续启动的子进程,测完关掉测试窗口即可。若 curl 已通,Git 或 npm 仍失败,检查工具是否保存了旧地址:Git 可用 git config --show-origin --get-regexp '^http\..*proxy$' 看配置来源,npm 可分别用 npm config get proxy 和 npm config get https-proxy 查看。输出可能含代理凭据,不要原样粘贴到公开求助帖。
如果只在编辑器集成终端里失败,先在独立终端做同样测试。已运行的编辑器不会自动收到另一个窗口里临时设置的变量;在实际执行命令的终端里配置,或在修改持久设置后重新启动编辑器。先做临时验证,再决定要不要写进启动文件,避免客户端退出后工具仍尝试连接失效的本地端口。
系统代理和终端都查过,什么时候才看 TUN
如果浏览器和带 --proxy 的 curl 都能进入 Clash,只有某个程序没有代理选项、也不读取系统代理或环境变量,才值得查客户端是否支持 TUN。TUN 在系统路由层接管流量,适用范围取决于内核、权限、路由和 DNS 设置。它不是用来修复本地监听失败、规则选错目标或节点连接超时的开关。
结束前只复测原来失败的程序和域名,确认请求进了 Clash,再确认最终出口符合预期。需要继续求助时,记下操作系统、客户端与内核版本、实际端口和协议、哪条 curl 命令失败,以及对应时刻的规则或错误信息。去掉订阅地址和凭据后,这些信息比一张「系统代理已开启」的截图更容易定位问题。