最后更新
Hiddify TUN 模式无法启动或无网络：Windows、macOS、Linux 排查
解决 Hiddify TUN/VPN 模式无法启动、权限不足、连接后无网络或退出后网络异常的问题。
TUN（部分版本界面中显示为 VPN 或 VPN Service）会创建虚拟网络接口并修改系统路由，因此比普通系统代理更依赖管理员权限、系统网络组件和其他 VPN 软件的状态。
症状
- 开启 TUN 后立即断开，提示
operation not permitted、启动服务失败或权限不足。 - 系统代理模式可用，切到 TUN/VPN 后所有请求超时。
- 显示已连接但没有延迟、网页打不开或大内容加载不完整。
- Hiddify 退出后，系统仍然无法联网。
- 只有 Windows、macOS 或 Linux 中某一个平台失败，同一订阅在手机正常。
Hiddify 官方教程明确说明，启用 TUN 前需要以管理员或 root 权限启动应用；详见官方 HiddifyApp 使用文档。官方仓库 Issue #1982也展示过 Linux 下 operation not permitted 的入站监听错误。
两分钟快速判断
- 完全退出 Hiddify，包括系统托盘或菜单栏中的后台进程。
- 按操作系统的正规方式以管理员或 root 权限启动，再仅开启 TUN 测试一次。
- 若系统代理正常、TUN 失败，订阅和节点大概率不是首要问题，继续检查权限、虚拟网卡和路由。
- 暂停其他 VPN、代理、加速器、虚拟机网络和流量过滤软件，再复测一次。
- 换一个网络和一个已知可用节点。若所有模式都失败，返回故障排查总入口检查订阅与服务端。
分层排查
客户端与权限
Windows
- 先从系统托盘退出应用，再右键 Hiddify，选择“以管理员身份运行”。仅关闭主窗口可能不会结束后台进程。
- 检查是否同时运行其他 VPN、代理或带网络过滤功能的安全软件；先暂停冲突程序，不要卸载系统安全组件。
- 若系统代理能用而 TUN 不能用，记录 Windows 版本、Hiddify 安装来源和错误日志。
macOS
- 退出旧进程，确认系统是否显示网络扩展、VPN 配置或权限请求。
- 只批准来自已核实官方安装包的系统权限；不要安装第三方提供的描述文件或证书。
- 权限被拒绝后重新打开应用，并按系统提示进入隐私与安全设置检查。
Linux
- TUN 和路由操作需要相应权限。按官方文档使用受信任安装包及明确的 root 启动方式。
- 日志若出现
operation not permitted、address family not supported或入站监听失败，应记录发行版、内核、安装格式和完整错误行。 - 不要照搬 Issue 评论中的递归删除命令；删除应用数据会丢失配置，也不能证明根因。
订阅：用代理模式做对照
- 同一节点在系统代理下正常、只有 TUN 失败，说明远端节点至少能建立连接，应优先处理本地 TUN 路径。
- 两种模式都失败时，检查账号、流量和节点状态，并阅读已连接但无法上网。
- 刷新配置失败则先处理订阅更新问题。
DNS/TLS 与路由
- 先恢复默认 TUN、路由和 DNS 选项，再做基线测试。
- 若日志只出现域名解析失败，先换网络并比较系统代理模式，不要立刻修改 MTU。
- 若小请求成功而图片、大网页持续卡住，记录该现象和当前 MTU，交给开发者或服务商判断。官方 Issue #1964包含 MTU 假设及后续修正，说明它不能作为所有设备的统一答案。
- TUN 退出后没有恢复网络时，先确认 Hiddify 进程已退出，再检查系统 VPN、代理和网络接口状态；不要用来源不明的“一键重置网络”脚本。
服务端
TUN 与系统代理都无法连接，且同一订阅在其他设备也失败时，让服务商检查节点、协议参数、证书、流量和并发限制。Hiddify 客户端不能修复远端端口关闭或配置下发错误。
验证
- 以正确权限启动后，TUN 能连续连接三次且没有启动服务错误。
- 两个不同 HTTPS 域名和一个常用应用都能访问。
- 能加载包含图片或较大响应的页面，不只是小型连通性检测。
- 断开 TUN 后直连网络立即恢复。
- 完全退出 Hiddify 并重新启动后，结果仍一致。
何时联系服务商或提交 Issue
如果系统代理与 TUN 都失败，优先联系订阅服务商。如果只有 TUN 失败，且使用正确权限、暂停冲突软件、恢复默认设置后仍可稳定复现，可在官方 Issues提交问题。
请提供操作系统与内核/版本、Hiddify 版本、安装包类型、连接模式、是否以管理员/root 运行、系统代理对照结果、最短复现步骤和脱敏日志。不要提交订阅 Token、服务器凭据或完整配置。