Hiddify 故障排查指南：连接、订阅与 TUN 问题

Hiddify 显示的错误往往只是结果，不一定直接指出根因。同一个“连接失败”，可能来自客户端权限、订阅内容、DNS/TLS，或远端节点。因此，最有效的方法不是连续切换设置，而是每次只改变一个变量并记录结果。

症状：先选择对应入口

两分钟快速判断

按顺序完成下面五步，不要同时改 DNS、路由、TUN 和节点：

1. 记录现场：记下 Hiddify 版本、操作系统、连接模式、报错原文和发生时间。版本可与官方 Releases核对。
2. 确认基础网络：断开 Hiddify 后打开一个原本就可直接访问的网站。如果仍然失败，应先修复 Wi-Fi、移动网络或系统网络。
3. 只换一次网络：在 Wi-Fi 与手机热点之间切换。换网络后恢复，优先检查本地网络、DNS 或网络侧限制。
4. 只换一次设备或节点：同一订阅在另一台设备可用，说明服务端并非整体离线；同一设备切换节点后恢复，则更像单节点问题。
5. 比较连接模式：系统代理可用而 TUN/VPN 不可用，优先进入 TUN 排查；两种模式都不可用，再检查订阅和服务端。

订阅 URL 通常包含账号 Token。不要把完整链接、二维码、配置文件或未脱敏日志发布到论坛、聊天群或 GitHub Issue。

分层排查

第一层：客户端

• 完全退出应用后重新打开，避免只关闭窗口但后台进程仍在运行。
• 核对当前版本和安装来源；升级前保留仍可用的配置，不要先删除唯一的工作配置。
• 暂停其他 VPN、代理、流量过滤或虚拟网卡软件，再做一次单变量测试。
• 将高级设置恢复为默认值后复测。只有在日志能指向具体选项时，才逐项修改。
• Windows 的 TUN 需要管理员权限；官方使用文档也要求启用 TUN 前以管理员或 root 权限启动应用。

第二层：订阅

• 确认链接复制完整、没有前后空格，也没有把网页地址误当成订阅地址。
• 检查账号是否过期、流量是否耗尽、设备数是否超限。
• 如果链接返回登录页、验证码页、错误页或空内容，客户端无法把它解析为配置。
• Clash、Sing-box 和单节点链接不是同一种内容。Hiddify 支持多种格式，但实际返回内容仍必须有效；可参考官方使用说明。

第三层：DNS 与 TLS

• 校准系统日期、时间和时区。时间明显错误会导致 HTTPS 证书校验失败。
• 查看订阅域名在浏览器中是否出现证书错误；不要绕过证书警告。
• 如果日志出现 dns、certificate、TLS handshake 或域名解析失败，先用另一网络复测，再恢复默认 DNS 或采用服务商明确提供的设置。
• 不要把 https:// 改成 http://。 官方变更记录显示，Hiddify 4.x 已禁用 HTTP 订阅链接，因为它会带来安全问题；明文订阅还可能泄露 Token 和节点信息。参见官方 HISTORY。

第四层：服务端

• 多台设备、多个网络同时失败，且其他订阅正常，优先联系该订阅的服务商。
• 让服务商检查订阅域名证书链、HTTP 状态、重定向、返回格式、节点在线状态及账号限制。
• Hiddify 是客户端，不能修复服务商证书、过期 Token、节点拥塞或服务器离线。

验证：确认问题已经解决

不要只看连接按钮变绿。至少完成以下验证：

1. 原错误连续三次不再出现。
2. 订阅可手动刷新，并能显示预期的配置或节点。
3. 域名网页和常用应用都能访问，而不是只有单个测试地址成功。
4. 断开 Hiddify 后系统网络恢复正常，没有残留代理或异常路由。
5. 记录“修改前、唯一改动、修改后结果”，以便问题复发时复用。

何时联系服务商或提交 Issue

如果同一订阅在多设备、多网络都失败，先联系订阅服务商。如果只有某个 Hiddify 版本或某个操作系统稳定复现，而订阅在其他客户端正常，可在官方 Issue 列表搜索相同报错后提交新问题。

提交时附上：操作系统与版本、Hiddify 版本、安装来源、连接模式、最短复现步骤、发生时间和脱敏日志。删除域名中的个人路径、Token、UUID、服务器 IP 及可识别账号的信息。