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

macOS v2rayN TUN 无网:分别检查代理回环和系统 DNS

显式 SOCKS5 可用、系统 TUN 请求失败时,先比较核心连接和 DNS 路径;两个问题可能同时存在,必须分别复核。

macOS v2rayN TUN 排错 scoped DNS 代理回环 DoH

服务对象与地域限制

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

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

本文要点

  • 用核心日志和重复 socket 采样确认是否存在代理自循环;单次高计数本身不是根因证明。
  • 修复或隔离回环后,再比较 Wi-Fi scoped resolver、系统 DNS、TUN DNS 和真实 HTTPS。
  • 系统级 DNS 描述文件的覆盖取决于安装方式、网络及解析范围,仍需验证受影响应用。
  • DNS 查询命令成功不能替代真实应用访问;最终要复测实际 TUN 流量。

把本地代理故障和系统 TUN 故障分开

显式 SOCKS5 请求能访问网站,但不指定代理的系统请求在 TUN 下超时或 TLS 失败,说明两种请求经过的路径不同。先确认当前节点、负责 TUN 的核心和负责节点连接的核心,再用同一目标做显式代理与系统请求对照。

如果 TUN 日志反复显示代理核心自己的入口连接又进入本地代理链路,可能形成回环;处理回环后系统流量仍失败,则需继续检查 DNS。关闭一个问题不等于另一个问题已解决。

用日志和 socket 趋势判断是否存在回环

当代理核心把自己的节点入口再次交给本地代理时,可能出现连接持续增长或临时端口错误。先查看 Xray、sing-box 与 v2rayN 的进程和核心日志,再间隔数秒重复统计 TCP socket;只有增长趋势、日志路径和本地入口/节点入口关系一致时,回环假设才有支持。

下方 netstat 命令统计整台 Mac 的 TCP 条目,包含其他应用和不同连接状态,并不筛出 Xray 或 sing-box 的连接。数量上升只是粗略信号;应结合核心日志、进程拓扑和目标地址确认是否重复连接到本地入口或节点入口。单次计数、Can't assign requested address 或同时运行两个核心都不足以单独定因。

检查 TUN 进程及 TCP 套接字计数变化

sh
ps -axo pid,comm | grep -Ei 'v2rayn|xray|sing-box'
netstat -an -p tcp | wc -l
sleep 5
netstat -an -p tcp | wc -l
只读进程与套接字计数检查。计数上升只是诊断信号,单独不能证明发生环路;结合核心日志以及到本地代理和节点入口的重复连接判断。分享前脱敏进程与本地网络信息。

单独比较系统 DNS、TUN DNS 与真实请求

读取 scutil --dns 和当前 Wi-Fi DNS 配置,查看系统 resolver 是否含 scoped resolver,再用同一测试域名比较系统解析和客户端 TUN DNS。若结果不同,记录差异及请求路径;DNS 查询返回成功只证明该次查询有答复,不证明应用使用的解析路径正确。

再分别发出显式 SOCKS5 HTTPS 和不显式指定 curl 代理的 HTTPS。第二种请求仍可能由 TUN 接管;若显式代理成功、系统请求失败,问题在两者之间的 DNS、路由或 TUN 处理路径,需要更多日志证据。

查看 macOS DNS 解析器状态并执行普通查询

sh
scutil --dns
networksetup -getdnsservers Wi-Fi
dscacheutil -q host -a name example.com
这些命令读取解析器配置并查询保留的示例域名,不会清除缓存或修改 DNS。分享输出前脱敏搜索域和本机网络信息。

对比显式代理请求与系统请求

sh
LOCAL_SOCKS_PORT='<LOCAL_SOCKS_PORT>'
curl --proxy "socks5h://127.0.0.1:${LOCAL_SOCKS_PORT}" --connect-timeout 5 --max-time 15 https://example.com/
curl --noproxy '*' --connect-timeout 5 --max-time 15 https://example.com/
这些命令发出只读 HTTPS GET。第二条请求没有显式使用 curl 代理,但 macOS TUN 仍可能接管它。替换本地端口占位符;不要粘贴节点凭据或私有节点地址。

先处理已确认的核心自接管

只有在日志、拓扑和连接趋势共同支持旧版 TUN 保护造成自接管时,才考虑关闭该保护。若当前版本支持让同一个核心处理 TUN、DNS 和节点出站,可在备份设置后评估统一核心;不要把 Xray 与 sing-box 组合本身当成错误,也不要把某次有效配置写成所有 Mac 的固定要求。

修改后完整退出并重启 v2rayN,再次检查核心进程、socket 趋势、显式代理和系统 TUN 请求。连接增长停止只说明这个指标稳定,不代表 DNS 或网页访问已经恢复。

DNS 仍异常时才评估系统加密 DNS

如果回环停止后,系统 resolver 仍返回与 TUN DNS 不同的结果,且真实系统 HTTPS 连到错误地址或继续失败,可评估使用 macOS 支持的加密 DNS 配置。安装前先审核配置描述文件的 DNS 端点和标识,只采用可信来源的配置;不要从示例命令生成或安装未知描述文件。

Apple 的 Device Management DNSSettings 文档说明:MDM 安装的设置只应用于受管理 Wi-Fi;在支持蜂窝网络的设备上,手动安装的设置也可应用于蜂窝网络。

NetworkExtension 的 NEDNSSettings.matchDomains 是独立 API 的解析范围规则:匹配域名使用对应 resolver,空字符串表示默认域;隧道默认路由可使 DNS 服务器成为默认并忽略 matchDomains。该 API 规则不等于每种配置描述文件的实现,也不保证每个应用都使用这个 resolver。

保留移除配置的步骤。公共 Wi-Fi 门户异常时,可暂时移除描述文件完成认证,再决定是否恢复;按受影响应用的实际解析路径验证。缓存刷新不能修复错误上游或 scoped resolver。

复核两条路径并决定是否回滚

完成设置后,重新比较系统解析、TUN DNS、显式 SOCKS5 和不显式指定代理的真实 HTTPS。确认系统应用访问成功,且 socket 数量在重复采样中稳定;把这些结果分别记录,不用某一项替代其他项。

如果关闭保护或更换核心引入新问题,退出 v2rayN 后恢复备份配置。若 DoH 配置造成门户或其他网络问题,只移除本次添加的描述文件。不要同时更改 MTU、路由、DNS 和核心,否则无法判断哪一步影响了结果。

资料来源

常见问题

显式 SOCKS5 可用是否证明 TUN 正常?

不能。显式代理和系统 TUN 流量经过不同路径;分别测试两者并查看核心日志。

关闭旧版 TUN 保护后网页仍失败怎么办?

继续检查系统 scoped resolver、TUN DNS 和真实 HTTPS。回环停止与 DNS 恢复是两个验收条件。

socket 数量很高就能确定代理回环吗?

不能。要将重复采样趋势、核心日志、进程拓扑和连接目标一起对照。

DNS 描述文件会接管 Mac 上所有 App 的全部请求吗?

不一定。MDM 安装只应用于受管理 Wi-Fi;在支持蜂窝网络的设备上,手动安装也应用于蜂窝网络。matchDomains API 仅描述匹配域名的 resolver 规则;启用隧道默认路由时,该规则可能被忽略。应检查受影响应用的实际解析路径。