· 故障排查 · 预计阅读 8 分钟

macOS 系统代理开了却不生效:Safari、Chrome 与终端分开排查

浏览器、终端和命令行工具读取代理的方式各不相同。本文分别讲清网络设置检查、浏览器扩展冲突,以及 export 环境变量的写法。

先核对 macOS 代理地址与监听端口

先判断请求有没有进入 Clash 客户端,再判断它走了哪个出口。系统代理负责让支持该设置的应用把请求交给本地端口;规则模式负责决定收到请求之后是直连、代理还是拒绝。开启了系统代理,不代表每个网站都会走代理节点。

  1. 确认当前连接的网络服务。在 macOS 13 Ventura 及更新版本中,使用 Wi‑Fi 时打开「系统设置」→「网络」→「Wi‑Fi」→已连接网络的「详细信息」→「代理」。使用有线网络时,从「网络」进入当前以太网服务的「详细信息」→「代理」。macOS 12 Monterey 则从「系统偏好设置」→「网络」选择当前服务,再打开「高级」→「代理」。
  2. 核对协议、地址和端口。对于使用本地 HTTP 或混合端口的配置,检查「网页代理(HTTP)」和「安全网页代理(HTTPS)」是否指向 Clash 客户端实际监听的地址与端口。例如客户端显示混合端口为 7890 时,两项可以指向 127.0.0.1:7890。仅支持 SOCKS 的端口不能填进 HTTP 或 HTTPS 代理项。
  3. 检查是否存在另一套代理设置。留意「自动代理发现」「自动代理配置」和代理绕过列表。自动代理配置脚本可以针对不同网址返回不同结果,绕过列表则可能让某个域名直接连接。受管理的 Mac 不要自行移除策略,先向管理员确认当前配置的用途。

然后在终端执行下面两条命令。第二条中的 7890 是示例,换成客户端显示的 HTTP 或混合端口。

scutil --proxy
lsof -nP -iTCP:7890 -sTCP:LISTEN

在手动 HTTP 代理方案下,前一条命令通常会列出 HTTPEnable : 1、HTTPSEnable : 1 和对应的主机、端口。后一条用于核对监听进程和绑定地址。如果设置指向 127.0.0.1:7890,但客户端只在另外一个端口监听,浏览器会尝试连接错误的端口。合上盖子后从 Wi‑Fi 切到扩展坞网线,也应重新检查当前服务,不能沿用上一条连接的设置结果。

Safari 不生效:用连接记录区分绕过与分流

Safari 通常使用 macOS 的系统代理。排查时,打开 Clash 客户端的「连接」视图或可用的日志视图,再用 Safari 打开一个无须登录的 HTTPS 页面,例如 https://example.com/。按访问时间和主机名筛选,不要把页面加载的其他主机当成主请求。

  • 有记录,策略显示 DIRECT:请求已进入 Clash 客户端,只是按规则直连。查看匹配规则和当前策略组,不要反复开关系统代理。若这正是配置预期,直连不是故障。
  • 有记录,但请求失败:先看失败发生在域名解析、连接上游还是握手阶段。用同一策略组测试另一个已知可用的目标,有助于区分单一站点故障和整个出口不可用。
  • 没有记录:先确认连接视图没有筛选掉该请求,再检查系统代理绕过列表、自动代理配置和当前网络服务。用新的浏览窗口重试;必要时按 ⌘ + Q 退出 Safari 后重开,以减少旧连接或页面缓存对判断的干扰。

Chrome 不生效:排查扩展、启动参数和管理策略

如果 Safari 的同一目标已经出现在连接记录里,而 Chrome 没有,先检查 Chrome 自己的设置。Chrome 在 macOS 上默认采用系统代理设置,但有代理控制权限的扩展、启动参数和管理策略都可能改写实际使用的代理。

  1. 打开 chrome://extensions/,暂时停用代理切换、网络加速等可能管理代理的扩展。一次停用一个,重试同一网址。无痕窗口不是可靠对照,因为扩展可能获准在其中运行。
  2. 打开 chrome://version/,检查「命令行」里是否有 --proxy-server 或 --no-proxy-server。如果平时用脚本或快捷入口启动 Chrome,按 ⌘ + Q 完全退出,再从「应用程序」正常打开并复测。
  3. 打开 chrome://policy/,查找 ProxySettings 等代理相关策略。公司或学校设备若有相关策略,记下名称和值并交给管理员核对,不要把受管设置当成普通扩展开关处理。

如果 Chrome 和 Safari 都有连接记录,但只有 Chrome 报错,记录具体错误码。ERR_PROXY_CONNECTION_FAILED 提示先核对 Chrome 选用的代理地址是否可达;证书错误则应检查系统时间和证书信任链。不要通过忽略证书错误来验证代理是否正常。

终端不生效:先用 curl 指定代理,再设置 export

终端窗口并不会替所有命令读取 macOS 系统代理。先用 curl 显式指定本地代理,排除工具配置差异。以下示例假定 Clash 客户端的本地 HTTP 或混合端口为 7890。两条命令使用同一目标,各给 15 秒完成请求。

curl -q -vI --max-time 15 --noproxy "" --proxy http://127.0.0.1:7890 https://example.com/
curl -q -vI --max-time 15 --noproxy '*' https://example.com/

-q 放在首个参数位置,让 curl 跳过默认配置文件。第一条用空的绕过列表强制本次请求使用指定代理,在输出里可找 CONNECT example.com:443,并与客户端记录对照。若一开始就提示无法连接 127.0.0.1,先检查监听端口;若隧道已建立之后才报错,继续看 TLS 或站点响应。第二条只让 curl 不使用应用层代理;如果同时打开了 TUN,它仍可能被虚拟网卡接管。

只给当前 shell 设置代理变量

export http_proxy='http://127.0.0.1:7890'
export https_proxy='http://127.0.0.1:7890'
export no_proxy='localhost,127.0.0.1,::1'
curl -q -vI --max-time 15 https://example.com/

https_proxy 中的 http:// 描述的是终端连接本地代理的协议,不是目标网站的协议。对于 HTTPS 网站,curl 可以通过 HTTP 代理发出 CONNECT,再在隧道中与目标建立 TLS。这里使用小写变量,尤其不要只设 HTTP_PROXY:curl 对 HTTP 请求不读取这个大写变量。

这些变量只影响当前 shell 和此后从中启动、且支持相应变量的程序。显式指定代理能通、去掉参数却不通时,先检查变量是否在同一个终端窗口导出,再检查现有的 NO_PROXY、ALL_PROXY 或工具自己的配置。curl 成功不代表 Git 的 SSH 连接也会走同一代理;仓库地址以 git@ 或 ssh:// 开头时,要按 SSH 的配置单独判断。

临时测试结束后,运行 unset http_proxy https_proxy no_proxy 可移除本次设置;如果测试覆盖了原有值,应恢复原值。先验证再考虑写入 shell 启动文件,否则退出 Clash 客户端后,新终端仍可能把请求发往已关闭的端口。

何时需要 TUN 模式

Safari 和 Chrome 已经按预期工作、只有某个命令行工具失败时,优先使用该工具支持的代理设置,不必先开 TUN。只有当目标应用既不读取系统代理,也没有适用的应用内代理选项时,再评估客户端是否支持通过 TUN 接管这类流量。

TUN 通过虚拟网卡和路由接管流量,仍受路由范围、排除项和出站规则影响。测试时一次只改一项:先保留同一测试地址,记录原来的系统代理与终端变量状态;再按客户端说明启用 TUN,查看同一请求是否进入连接记录。若启用后公司内网、局域网或 VPN 异常,先关闭 TUN 恢复原设置,再核对路由冲突,而不是把出站模式改成全局。

复查时可以用三条信号快速定位:请求没到本地端口,查系统或应用设置;到了端口却走 DIRECT,查匹配规则;已选代理出口但连接失败,查该出口和日志。每次保留相同的网址与端口,才能知道是哪项修改起了作用。

下载Clash