PuppyIP 资源中心
网络与连接排错 7 分钟 发布于 2026-11-17

macOS 应用不走 v2rayN 代理?先检查系统代理

TUN 关闭时,应用能否通过 v2rayN,取决于它是否使用已启用的系统代理,或主动连接本地代理端口。

macOS 代理 v2rayN 系统代理 Safari TUN

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • 本地 HTTP 或 SOCKS 代理可用,不代表 Safari 等应用已经把请求交给它。
  • 先查看 Wi-Fi 等当前网络服务的 HTTP、HTTPS 和 SOCKS 代理状态,再用显式代理请求与普通应用请求做对照。
  • 只有 TUN 关闭、核心运行、本地代理验证成功且系统代理确实关闭时,才考虑由 v2rayN 启用系统代理。
  • 启用系统代理会影响整台 Mac 上遵循系统设置的应用;不支持系统代理的软件和部分 UDP 流量可能仍走其他路径。

先判断问题是在核心、本地监听,还是系统代理

如果 macOS 上的 v2rayN 已经启动 Xray,TUN 处于关闭状态,而且使用本地 HTTP 或 SOCKS 端口发出的显式请求可以成功,但 Safari 仍然直接访问网站,排查重点应放在系统代理设置。TUN 关闭时,应用通常需要读取 macOS 的代理设置,或由应用自身配置本地代理;核心运行并不会自动把所有应用的连接重定向到它。

这类故障与“节点不可达”不同:本地代理成功说明所测试的该端口、当前配置和请求目标至少在那一次请求中可用,但不能代替 Safari 的验证。自动设置系统代理为何没有生效,如果客户端界面和系统状态都没有给出原因,就应保留为未知,不要猜测是权限、网络或某个版本缺陷。

只读查看当前网络服务的代理开关

先确认 macOS 正在使用的网络服务名称。常见名称是 Wi-Fi,但设备也可能使用有线网络、VPN 或自定义服务名。以下查询只读取配置,不会启用或清除代理。若服务名不是 Wi-Fi,将命令中的名称替换为列表里当前正在使用的服务;分别检查网页 HTTP、HTTPS 安全网页和 SOCKS 状态。

查看网络服务及系统代理状态

shell
networksetup -listallnetworkservices
networksetup -getwebproxy "Wi-Fi"
networksetup -getsecurewebproxy "Wi-Fi"
networksetup -getsocksfirewallproxy "Wi-Fi"
只读查询。将 Wi-Fi 替换为当前活动网络服务名称;输出可能包含本机代理地址与端口,不要公开分享完整输出。

对比显式本地代理请求与 Safari

从 v2rayN 的本地监听设置中确认 HTTP 与 SOCKS 端口,不要从旧截图或另一台设备复制端口。将下面的两个占位值替换成当前监听端口,再分别发出 HTTPS 请求。curl 使用显式代理时,测试的是该协议入口是否能完成这一次请求;它不会证明 Safari 已读取系统设置,也不能单独证明每个网站或 UDP 应用都可用。

随后在 Safari 中访问同一个 HTTPS 测试地址。若显式 HTTP 与 SOCKS 请求都成功而 Safari 仍显示直连,应把“本地代理可用”和“系统代理未启用或未应用”作为两个独立观察记录。若显式请求也失败,先查监听端口、活动配置与核心日志,不要先改全局代理开关。

分别验证本地 HTTP 与 SOCKS 入口

shell
HTTP_PORT='REPLACE_WITH_CURRENT_HTTP_PORT'
SOCKS_PORT='REPLACE_WITH_CURRENT_SOCKS_PORT'
curl --silent --show-error --max-time 15 --proxy "http://127.0.0.1:${HTTP_PORT}" --output /dev/null --write-out 'HTTP %{http_code}\n' https://www.cloudflare.com/cdn-cgi/trace
curl --silent --show-error --max-time 15 --proxy "socks5h://127.0.0.1:${SOCKS_PORT}" --output /dev/null --write-out 'HTTP %{http_code}\n' https://www.cloudflare.com/cdn-cgi/trace
先把占位值替换为客户端当前端口。命令会发出真实 HTTPS 请求;成功只证明对应显式代理入口完成了该次请求。

满足条件后再由客户端启用系统代理

只有在 TUN 已关闭、Xray 或当前核心仍在运行、至少一个显式本地代理请求成功,并且当前网络服务显示相关系统代理都关闭时,才进入客户端的“设置系统代理”操作。确认 v2rayN 为 HTTP、HTTPS 或 SOCKS 指定的监听端口与上一步相同;不要手工猜端口,也不要在已有 VPN、企业代理或需要直连的网络配置上覆盖设置。

系统代理是设备级配置,会改变其他遵循 macOS 系统代理的应用的出口。若设备由组织管理,或现有代理属于其他网络工具,应先保留原设置并确认切换范围。TUN 与系统代理是不同的转发方式;如果实际需要由 TUN 接管流量,不应为了绕过这个问题而同时叠加两套未确认的代理路径。

用真实应用和系统状态复核

启用后重新运行只读状态查询,确认目标网络服务显示已启用的代理类型和预期本地端口。然后在 Safari 中重新打开测试页面,并再访问一个平时失败的 HTTPS 站点。观察的是实际页面能否完成请求,以及 v2rayN 的活动连接是否对应这次访问;仅看到开关处于开启状态不等于应用流量已经通过代理。

如果 Safari 恢复,而另一个应用仍直连,先确认该应用是否遵循 macOS 系统代理。若系统状态显示代理仍关闭、端口不符或 Safari 报错,则不要把成功归因于节点或 DNS;回到具体服务名称、代理协议和本地端口继续定位。

回滚范围与排查边界

若要撤销本次切换,回到 v2rayN 关闭系统代理,或在网络设置中仅关闭本次启用的 HTTP、HTTPS 和 SOCKS 代理状态,再用前面的只读命令确认状态。不要清空其他网络服务的代理,也不要删除 VPN、证书或配置文件来代替回滚。

这一指南适用于 TUN 关闭、应用未使用系统代理的分支。自动设置为何失败尚未确认。比较测速指标、系统开关和真实业务请求时应分别记录;某一项不能代替另一项。

资料来源

常见问题

核心正在运行,为什么 Safari 仍然直连?

TUN 关闭时,核心不会自动接管所有应用。Safari 需要使用已启用的 macOS 系统代理,或使用自身配置的代理。

显式 SOCKS 请求成功,是否代表系统代理也正常?

不代表。显式请求只验证指定的本地 SOCKS 入口;Safari 是否采用系统设置需要单独检查和实际访问确认。

启用系统代理会覆盖整台 Mac 吗?

它会影响遵循该网络服务系统代理设置的应用。企业配置、VPN、忽略系统代理的软件和部分 UDP 流量可能有不同路径。

如果自动设置系统代理失败,应该改权限吗?

自动设置失败的原因仍未知。先核对 TUN 状态、显式本地请求和系统代理状态;不要凭猜测修改权限。