服务对象与地域限制
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 状态。
查看网络服务及系统代理状态
shellnetworksetup -listallnetworkservices
networksetup -getwebproxy "Wi-Fi"
networksetup -getsecurewebproxy "Wi-Fi"
networksetup -getsocksfirewallproxy "Wi-Fi"
对比显式本地代理请求与 Safari
从 v2rayN 的本地监听设置中确认 HTTP 与 SOCKS 端口,不要从旧截图或另一台设备复制端口。将下面的两个占位值替换成当前监听端口,再分别发出 HTTPS 请求。curl 使用显式代理时,测试的是该协议入口是否能完成这一次请求;它不会证明 Safari 已读取系统设置,也不能单独证明每个网站或 UDP 应用都可用。
随后在 Safari 中访问同一个 HTTPS 测试地址。若显式 HTTP 与 SOCKS 请求都成功而 Safari 仍显示直连,应把“本地代理可用”和“系统代理未启用或未应用”作为两个独立观察记录。若显式请求也失败,先查监听端口、活动配置与核心日志,不要先改全局代理开关。
分别验证本地 HTTP 与 SOCKS 入口
shellHTTP_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
满足条件后再由客户端启用系统代理
只有在 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 状态、显式本地请求和系统代理状态;不要凭猜测修改权限。