macOS · macOS / 网络扩展 / TUN
macOS 客户端无法接管流量：网络扩展权限排查
权限确认
在系统设置的网络与隐私安全页面确认相关网络扩展已允许。若设备受 MDM 管理，应联系管理员，不要绕过配置描述文件。
最小化复测
关闭其他 VPN 或过滤器，重启客户端并测试基础网络；再恢复自定义 DNS 与规则。
诊断范围
“macOS 客户端无法接管流量：网络扩展权限排查”应先按可观察现象缩小范围：macOS 上客户端无网络、TUN 无法启用时，检查网络扩展与系统权限。 记录发生时间、使用的客户端与系统版本、是否仅在某个网络或某个配置下发生。不要从单次测速、单个节点或一次重试直接推断根因，也不要在未备份配置时同时修改多个开关。
操作步骤
- 保留错误提示的非敏感部分，并记下当前客户端、系统、网络类型和最近一次成功时间；订阅链接、账号、令牌和个人网络标识不得写入截图或工单。
- 在受控条件下只改变一个变量，例如切换已知可用的网络、恢复一份已导出的配置，或暂时停用可能重复接管流量的另一个客户端；每次改动后回到同一个操作复测。
- 将结果归为“现象消失、现象不变、出现新错误”之一。前两类分别保留变更前后记录；出现新错误时立即恢复上一步，而不是继续叠加 DNS、代理模式、内核或系统权限改动。
验证与回退
完成调整后，以原始失败动作连续复测，并确认目标功能恢复而不是只看到界面状态改变。若复测失败，回退到已导出的配置或原先已知可用的客户端状态，再依据记录选择下一项检查。任何无法解释的证书、权限、路由或账户提示都应停止扩大改动范围并转交产品或网络管理员。
来源与适用边界
本文未绑定可逐条核验的外部案例，只提供本机侧可重复的诊断顺序，不把任何现象归因于特定服务商、线路或版本。若需要升级，应带着脱敏后的时间、错误文本和已执行步骤联系相应产品支持。
来源与更新
本文为本地诊断整理，未把它表述为某个公开个案的结论。执行前请以所用客户端和系统的当前官方说明为准。
排查顺序
- 记录症状确认客户端、系统、错误文本与发生范围。
- 低风险核对先检查本文对应的配置、权限、网络或版本条件。
- 复测与回退只改变一项；现象变化后再决定是否继续。
常见问题
为什么每次都提示允许扩展？
扩展可能未被系统批准，或应用更新后需要重新授权。
卸载应用会删除配置吗？
不一定；先导出配置，并查看应用文档中的清理范围。
确认结果、回退与日志
每次只修改一项并复测原始现象。若出现新错误，恢复导出的配置或关闭刚启用的开关；仍未解决时，请保留客户端与系统版本、错误文本、发生时间、已尝试步骤以及脱敏日志。
不要公开订阅地址、账号或完整连接信息。文中的命令与配置片段仅适用于其标注的客户端和系统；未提供命令时，请以来源中的官方界面或系统文档为准。