macOS 系统代理未生效:浏览器、终端和单个应用怎么定位
简答:macOS 系统代理未生效时,先确认客户端正在运行并实际监听入口端口,再检查当前真正联网的 Wi-Fi、以太网或热点服务是否写入了相同地址和端口。端口无监听先查客户端;端口正常但系统未写入查网络服务;只有终端失败查环境变量;只有单个应用失败查独立设置、权限或应用自身限制。
定义:macOS 系统代理未生效,是指系统或客户端看似已开启代理设置,但目标应用没有通过指定的本地地址和端口建立连接。
先看判断表:根据现象决定先查哪一层
不要一开始反复切换开关,也不要同时修改 DNS、浏览器和客户端设置。先判断是所有应用都失败,还是只有某一类应用失败,再做最短验证。
| 现象 | 优先检查 | 下一步 |
|---|---|---|
| 浏览器和终端都失败 | 客户端是否运行、入口端口是否监听、系统设置是否写入 | 先记录客户端实际显示的地址和端口,再检查当前网络服务 |
| 浏览器正常,终端或 Git 失败 | 终端环境变量、命令行工具自己的配置 | 用 curl 显式指定入口测试,再检查 http_proxy、HTTPS_PROXY、ALL_PROXY 和 NO_PROXY |
| 只有一个浏览器或应用失败 | 独立设置、扩展、绕过列表、应用权限或自身网络栈 | 暂时关闭重复设置,改用单一系统设置做对比 |
| 退出客户端后仍无法直连或网络异常 | 残留系统设置、自动配置、网络扩展或企业策略 | 恢复当前网络服务的直连设置,再观察问题是否消失 |
| 切换 Wi-Fi、以太网或热点后失效 | 当前活跃网络服务发生变化 | 在当前显示已连接的网络服务下重新检查代理设置 |
Apple 说明,Mac 的代理入口通常位于“苹果菜单 → 系统设置 → 网络 → 当前网络服务 → 详细信息 → 代理”。其中可能包含自动发现、自动配置、网页代理、安全网页代理、其他代理入口以及绕过主机和域名等项目,具体文字以当前 macOS 页面为准。查看 Apple 的 Mac 代理设置说明
第一步:确认客户端运行,并核对实际入口端口
系统代理只是把请求交给某个本地地址和端口,并不代表该端口一定有程序提供服务。先打开正在使用的客户端,确认其运行状态、内核状态或连接状态正常,然后记录页面中实际显示的入口地址和端口。
- 记录客户端显示的本机地址,例如本机回环地址或客户端指定的本地地址,不要直接照抄网上示例。
- 记录客户端当前显示的网页代理、安全网页代理或其他入口端口。不同客户端、不同配置项的端口可能不同。
- 如果客户端显示已连接但没有入口信息,先在设置中查找“系统代理”“本地服务”或含义相近的页面,具体名称以当前版本为准。
- 把客户端退出后重新启动,只作为一次复位操作,不要在没有记录原设置的情况下批量删除配置。
可以用下面的命令检查某个端口是否有本机进程监听。将 PORT 替换为客户端实际显示的端口,不要使用固定示例值:
lsof -nP -iTCP:PORT -sTCP:LISTEN
如果没有输出,通常表示该端口当前没有监听进程,或客户端使用了其他端口。此时停止继续修改 DNS 和浏览器设置,先回到客户端核对入口。若有输出,只能说明本机存在监听,不能单独证明目标应用或远端线路记录正常。
第二步:检查 macOS 当前使用的网络服务
macOS 可能同时存在 Wi-Fi、以太网、手机热点或扩展坞网络服务。在 Wi-Fi 中设置成功,不代表切换到以太网或热点后仍会自动使用相同设置。
- 打开“系统设置 → 网络”。
- 选择当前确实显示已连接的网络服务,而不是只选择之前使用过的 Wi-Fi。
- 进入“详细信息 → 代理”,检查启用的项目、服务器地址和端口。
- 将系统页面中的地址和端口与客户端当前显示内容逐项对照。
- 检查绕过主机与域名列表,确认测试目标没有被加入绕过范围。
- 如果同时启用了自动发现或自动配置,先记录原值,再暂时关闭不需要的项目,避免多个来源同时决定连接方式。
Apple 的 networksetup 工具可用于列出网络服务和查看网络设置。可以先执行:
networksetup -listallnetworkservices
再将 SERVICE_NAME 替换为实际网络服务名称,查看网页代理设置:
networksetup -getwebproxy "SERVICE_NAME"
如果系统版本或当前权限不支持某个查询命令,以“系统设置 → 网络”页面为准。Apple 对 networksetup 的用途和网络服务查询方式有说明。查看 Apple 的 networksetup 说明
还可以执行 scutil --proxy 查看系统读取到的代理状态。该输出只能作为辅助证据:它不能证明本地端口一定有监听,也不能证明所有应用都会读取系统设置。
第三步:分别验证浏览器、终端和单个应用
“系统代理已开启”不代表所有软件都会读取它。浏览器、终端、Git、Homebrew、容器工具和企业应用可能使用不同配置来源,因此要按应用类别分别测试。
浏览器失败,但所有浏览器都失败
先检查客户端入口和 macOS 当前网络服务。如果多个浏览器都失败,优先回到前两步,不要先安装扩展或更换浏览器。若只有部分网页失败,再检查绕过列表、自动配置、DNS、证书和客户端规则。
浏览器正常,终端失败
用 curl 做一次显式指定入口和一次明确不使用入口的对比。将 PROXY_URL 换成客户端帮助文档或当前页面显示的实际格式,将 TEST_URL 换成你有权限访问的测试地址:
curl -I --proxy "PROXY_URL" "TEST_URL"
curl -I --noproxy "*" "TEST_URL"
curl 官方文档说明,--proxy 可以为当前命令指定入口,--noproxy 可以让指定请求不使用入口;命令行还会读取 http_proxy、HTTPS_PROXY、ALL_PROXY 和 NO_PROXY 等环境变量。查看 curl 官方参数说明 查看 curl 环境变量说明
如果显式指定入口成功,而普通命令失败,说明本地入口可能正常,问题更接近终端没有读取系统设置、环境变量过期或命令行工具使用了自己的配置。如果两种方式都失败,再回到端口、地址、DNS 或线路记录检查。
只有一个应用失败
先关闭该应用的独立设置、扩展、自动配置和自定义绕过项,再用系统设置做一次对比。若关闭独立设置后仍失败,再检查应用权限、网络扩展或应用自身限制。部分应用可能强制直连、使用独立网络栈,或根本不读取 macOS 的系统代理,这时不能仅凭系统页面判断应用一定会跟随。
排查时不要把订阅地址、访问令牌、账号信息或包含身份信息的完整命令粘贴到公开工单和截图中。
第四步:处理绕过规则、DNS、网络扩展和企业策略
只有在本地入口、系统网络服务和应用读取方式都基本正常后,才进入这一层。此时要判断请求是否被绕过、是否被其他系统组件接管,或是否遇到设备管理限制。
- 绕过列表:如果只有部分域名或应用失败,检查 macOS 的绕过主机与域名、自动配置内容以及客户端规则。某个目标被绕过时,表现可能是“部分生效”。
- DNS:如果错误明确表现为域名无法解析、解析等待或不同域名结果不同,再单独检查 DNS。网页打不开本身不足以证明 DNS 有问题。
- 网络扩展:Apple 说明,Network Extension 可以扩展系统网络能力,并支持系统级 DNS 配置、内容过滤等功能。部分网络软件会通过系统网络扩展提供相关能力,多款网络扩展或安全工具同时运行时可能互相覆盖。查看 Apple Network Extension 文档
- 企业设备策略:如果代理选项无法修改、重启后自动恢复,或系统显示由组织管理,可能存在设备管理策略。不要自行删除管理配置,应联系设备管理员。
- 残留设置:退出客户端后仍无法直连时,重新打开当前网络服务的代理页面,关闭不再使用的入口、自动配置和自动发现项目,恢复后再测试普通网络连接。
Apple 也提示,第三方网络过滤软件或其他系统扩展可能影响相关网络功能。如果关闭客户端后问题仍存在,应把“客户端运行状态”和“系统网络扩展状态”分开判断,不要把两者视为同一个开关。查看 Apple 关于第三方网络设置影响的说明
完成一次最短复位,并留下结果记录
如果仍无法确定原因,可以按下面顺序操作,每次只改变一个变量:
- 关闭浏览器、终端和其他需要联网的应用。
- 确认客户端运行,并记录当前入口地址和端口。
- 执行
lsof -nP -iTCP:PORT -sTCP:LISTEN,记录是否有监听。 - 在当前联网的网络服务中核对系统代理地址、端口、自动配置和绕过列表。
- 执行
scutil --proxy,记录系统读取到的状态。 - 使用
curl -I --proxy "PROXY_URL" "TEST_URL"做显式测试,再用浏览器复测。 - 若只有单个应用失败,检查该应用的独立设置、权限、扩展和网络限制。
- 退出客户端后若仍无法直连,恢复当前网络服务的直连设置,再重新测试。
建议保存以下结果记录,便于继续定位或提交给管理员:
端口监听:有/无;系统代理状态:开/关;系统地址端口:一致/不一致;显式请求:成功/失败及错误;浏览器:正常/失败;终端:正常/失败;单个应用:正常/失败。
停止条件是:端口无监听、系统地址与客户端不一致,或显式请求明确提示连接被拒绝时,先修复本地入口,不要继续批量修改 DNS、规则和系统配置。
常见问题
macOS 系统代理开了,但浏览器仍像直连,先查什么?
先确认客户端正在运行并监听实际入口端口,再检查当前真正联网的 Wi-Fi、以太网或热点服务是否写入了相同地址和端口。随后查看绕过列表、自动配置和浏览器独立设置。
为什么浏览器能用,终端里的 curl 却不行?
浏览器可能读取 macOS 系统设置,而终端可能使用环境变量或自己的配置。先用 curl 的 <code>--proxy</code> 显式指定实际入口,再检查 <code>http_proxy</code>、<code>HTTPS_PROXY</code>、<code>ALL_PROXY</code> 和 <code>NO_PROXY</code>。
scutil --proxy 显示已开启,就能证明系统代理正常吗?
不能。它只能说明 macOS 读取到了某些状态,不能证明本地端口有程序监听,也不能证明目标应用会读取该设置。还要结合端口监听、显式请求和实际应用表现判断。
切换到手机热点后,系统代理为什么可能失效?
Wi-Fi、以太网和热点可能对应不同网络服务。之前写入 Wi-Fi 的设置不一定出现在当前热点服务中,应在当前显示已连接的网络服务下重新核对。
只有一个应用打不开,是否说明 macOS 系统代理坏了?
不一定。该应用可能使用独立设置、独立网络栈、强制直连、自己的绕过规则或权限限制。先关闭应用自身的重复设置,再检查权限、网络扩展和应用限制。
需要直接删除网络配置或修改 DNS 吗?
不建议一开始就这样做。先完成入口端口、当前网络服务和应用读取三层验证;只有出现明确解析错误或确认存在残留设置时,再针对 DNS 或残留项目处理,并先记录原值。