TL;DR:Hiddify Next 被订阅链接唤起,只代表系统把链接交给了 App;配置为空或 invalid profile,通常是格式、协议字段或编码问题。先把链接原文保存出来,再判断是不是 sing-box 能理解的内容。
Hiddify Next 的导入链路比传统桌面客户端多一层:浏览器、二维码、剪贴板或系统分享菜单先把链接交给 App,App 再解析 profile。任何一层出错,用户看到的都像「导入失败」。
先把症状分清
| 现象 | 优先排查 |
|---|---|
| 点链接没有打开 App | 系统关联、浏览器拦截、App 未安装 |
| App 打开但 profile 为空 | 链接内容格式或编码 |
| 提示 invalid profile | sing-box JSON/YAML 字段不兼容 |
| 导入后节点为空 | 订阅返回空列表或格式转换失败 |
| 扫码失败,复制成功 | 二维码编码或长度问题 |
能唤起 App 但导入为空时,不要反复点链接。先复制原始 URL,用浏览器打开,看返回内容是什么。
格式不匹配是第一原因
Hiddify Next 以 sing-box 生态为主,也会兼容一部分通用订阅。下面几类最容易失败:
- Clash YAML 里大量使用
proxy-providers、rule-providers、脚本覆写。 - sing-box JSON 使用了当前 App 内核尚未支持的新字段。
- V2Ray base64 订阅里混入了客户端私有参数。
- 分享链接中
#备注、&参数没有正确编码。
快速判断:如果返回内容第一行是 <html>,那是网页;如果是 { "outbounds": ... },可能是 sing-box JSON;如果是 proxies:,更像 Clash YAML;如果是一长串 base64,需要确认里面每条链接的协议是否被 Hiddify 支持。
sing-box 支持也要看版本
Hiddify Next 依赖内置 sing-box 内核。服务端如果下发了较新的 Reality、TUIC、Hysteria2 或 AnyTLS 字段,而你的 App 几个月没更新,就会出现「链接没问题但客户端说无效」。
建议顺序:
- 升级 Hiddify Next 到最新 release 或商店版。
- 重新复制订阅链接,避免使用旧二维码截图。
- 在 App 内用「添加配置 / 从 URL」手动粘贴。
- 仍失败时,让服务商导出 sing-box/Hiddify 专用格式。
如果你正在换订阅来源,选择兼容 Clash / Singbox / V2Ray 的订阅时,也要在后台明确选 Hiddify 或 sing-box 格式,而不是默认 Clash 格式。
移动端权限和二维码问题
iOS 和 Android 常见坑不一样:
| 平台 | 排查点 |
|---|---|
| iOS | 剪贴板读取提示是否被拒绝,VPN 配置权限是否已授予 |
| Android | 后台启动权限、相机扫码权限、浏览器是否允许外部 App 打开 |
| Windows | 防火墙或安全软件是否拦截首次网络请求 |
| macOS | 首次启动是否被 Gatekeeper 拦截,网络扩展是否授权 |
二维码不要用太低纠错级别。长订阅 URL 建议直接复制,不要截图转发再识别;二次压缩后最容易把 ?token= 后面的参数读错。
可操作的最小修复流程
- App 升级到最新版。
- 删除空 profile,不要覆盖旧的可用 profile。
- 复制原始订阅 URL,确认浏览器能拿到非网页内容。
- 在 Hiddify Next 内手动添加 URL。
- 如果仍失败,换导出格式:Hiddify/sing-box 优先,其次通用 V2Ray 链接,最后才尝试 Clash YAML。
到这一步还失败,基本可以把问题定位到订阅内容本身。把原始返回内容去掉 token 后发给服务商,比只说「导入不了」更容易得到有效回复。