先看结论
- “更新成功”最多说明一次更新流程没有立刻报错,不等于远程响应里一定有可用节点,也不等于新配置已经成为活动配置。
- 先保留旧配置和错误文字,再按“获取 → 内容 → 解析 → 选择 → 启动”顺序判断;不要一上来删除应用数据或反复刷新。
- Hiddify可以导入远程订阅和单条分享链接,但网页地址、登录页、验证页、空响应,以及不兼容或损坏的配置都可能造成“有订阅名、没有节点”。
适用范围:用于理解 Hiddify 的通用配置更新链路。不同系统、版本和安装包的按钮名称、配置页与日志入口可能不同;本文不把某一版本的界面位置写成所有平台通用步骤。首次使用请先看Hiddify完整教程。
安全边界:不要公开完整订阅URL、二维码、UUID、密码或令牌;不要把私人订阅上传到陌生转换网站。
一分钟症状判断
| 看到的现象 | 更可能停在哪一层 | 先做什么 |
|---|---|---|
| 添加URL后立即报错 | 地址、授权或网络获取 | 核对URL是否完整,保留HTTP或错误文字 |
| 更新后仍看不到节点 | 获取、内容或解析环节需要核对 | 保留提示文字并核对来源返回内容 |
| 配置名称存在,但仍显示旧内容 | 需要核对当前选中的配置 | 回到配置列表确认当前使用项 |
| 节点出现,连接时仍报错 | 已转为连接或配置兼容问题 | 先断开,再记录最早出现的错误 |
| 节点出现但全部超时 | 节点或当前网络不可达 | 转到连通性排查,不再反复导入 |
第一步:先确认复制的是订阅或分享链接
Hiddify官方URL Scheme说明表明,导入目标可以是Clash链接、sing-box链接、v2ray订阅或单条代理分享链接。普通网站首页、登录页或套餐购买页不是配置本身。
- 从来源的“复制订阅”“导入Hiddify”或明确的配置入口重新复制。
- 检查聊天软件是否截断了问号后的参数,或者把句号、空格和换行一起复制进去。
- 如果链接曾出现在公开截图或群聊中,先在来源方重置令牌,再继续测试。
- 不要把完整链接发给陌生人“代测”;只记录域名、HTTP状态和脱敏后的错误。
如果你还没有完成首次导入,先看免费节点导入Hiddify的格式与步骤;本页只处理已经添加或更新、但节点没有显示的问题。
第二步:区分“拿不到内容”和“拿到错误内容”
远程更新可能在地址访问、来源授权、响应下载或内容解析环节失败。下面的状态只能作为排查线索,不能脱离来源说明直接下结论:
- 401或403:回来源核对授权、令牌与访问规则;不能仅凭403判断来源停运。
- 404:核对路径是否完整以及来源是否更换入口。
- 429:请求太频繁,应停止刷新并等待来源规定的冷却时间。
- 5xx或超时:暂时不能确认是来源还是当前网络,先保留时间和错误文字。
- HTTP 200但正文是HTML:常见于登录页、验证页和错误页,状态码正常不代表内容是配置。
- HTTP 200但正文为空:Hiddify没有可解析的节点,应该回到来源核对,而不是更改客户端高级设置。
不要用在线转换站查看正文。确有排查需要时,只在自己控制的设备上检查响应类型,并遮盖凭证。
看到明确的 unknown field 时,先停在解析阶段
若提示 [SingboxParser] unmarshal error、outbounds[n] 和 unknown field "tunnel-per-resolver",说明当前订阅内容已进入字段解析,不能把它归入“获取后列表为空”。Hiddify 官方仓库 Issue #2295 与 Issue #2203 分别记录 Android 与 Windows 的此类个案;资料核验:2026-11-11。两份报告均未提供可以泛化到所有版本的修复结论。
| 最早的证据 | 先处理哪一步 |
|---|---|
| HTTP 401/403、超时或 TLS 错误 | 回到获取和授权检查 |
| 已取回内容,报具体 unknown field | 保留脱敏错误和客户端版本,核对提供方的订阅格式 |
| 没有解析错误,配置已保存但无节点 | 继续本页的配置选择、筛选与启动检查 |
不要在唯一的原始配置上直接删除字段。先按Hiddify tunnel-per-resolver 字段报错专项记录字段、数组位置、来源入口与版本,再请提供方核对输出;修正后仍需验证节点出现和实际 HTTPS 请求。
第三步:检查响应格式能否被当前版本解析
官方 URL Scheme 列出了 Clash、sing-box、v2ray 订阅和单条分享链接等导入目标。具体协议、编码和字段仍要以来源说明及当前 Hiddify 版本为准;文件能下载只说明取得了内容,不代表当前版本一定能解析。
优先检查:
- 内容是不是配置而非说明文字或网页源码。
- YAML或JSON是否被截断,缩进、引号和结尾是否完整。
- 协议字段和必要参数是否齐全;不要只改文件扩展名。
- 是否使用来源明确标注给Hiddify、Clash、sing-box或通用订阅的入口。
- 更新Hiddify前先看官方Releases和变更记录;不要从网盘安装所谓“修复版”。
本站近期免费节点页逐期标注公开候选、测试方法与证据;候选配置与进入下载的节点是两回事,测试时间以各日期页实际标注为准。
第四步:确认新配置已经保存并被选中
“配置已经加入”和“当前正在使用该配置”是两个状态。更新后逐项确认:
- 配置列表中能看到目标配置;若当前版本显示更新时间,可一并核对。
- 打开该配置后,确认应用确实解析出了可选择的条目。
- 新配置已被选为活动配置,而不是仍停留在旧配置。
- 若当前版本启用了筛选,临时取消筛选后再判断是否真的为空。
- 若配置标题相同,先根据更新时间区分,不要同时删除新旧两份。
官方URL Scheme还说明,Profile-Title或响应头中的文件名可以决定配置标题。因此“名字和以前一样”不能证明内容没有更新。
第五步:把解析成功与核心启动失败分开
Hiddify 的 GitHub Issue #2048 记录了一个特定版本、特定配置更新场景下的启动失败报告。它只能说明类似现象曾被个别用户报告,不能证明你的错误原因相同,也不能据此推断所有版本的处理流程。
安全的判断顺序是:
- 先断开当前连接,避免更新与自动重连同时发生。
- 保留原活动配置,不要立即清空应用数据。
- 重新更新一次,并记录最早出现的错误,而不是只截最后一行。
- 若新配置能显示节点但启用失败,检查配置校验和核心日志。
- 临时切回原配置;原配置能启动而新配置不能启动,问题更可能在新内容或兼容性。
- 两份配置都不能启动,再检查应用版本、系统权限和本地核心状态。
节点出现后仍不能上网怎么办
这时问题已经从“节点不显示”转成“节点或接管不可用”。不要继续删除和重加订阅,改做以下最小验证:
- 只选一个节点,执行客户端提供的连通或延迟测试。
- 连接后打开普通HTTPS网页,再检查出口IP是否变化。
- 根据现象转到代理连接成功但网页打不开的排查,不要仅凭一次失败直接认定是DNS或节点问题。
- Wi-Fi与蜂窝网络对照时一次只改变一个条件。
- 延迟有数字不等于网页可用;继续查看免费节点延迟正常但不能用的排查。
失败后的安全恢复
- 关闭Hiddify连接,确认系统VPN状态消失。
- 切回原先可用的配置;无法判断时先停用新配置,不要删除全部内容。
- 退出Hiddify后确认普通网络和DNS恢复。
- 若URL曾泄露,重置订阅令牌;只删除聊天记录不能让旧令牌失效。
- 不要关闭TLS校验、安装未知根证书或授予与排查无关的系统权限。
- 记录客户端版本、系统、测试时间、网络、配置类型、节点数量和错误文字,便于复现。
什么时候应停止继续尝试
- 来源长期不更新,返回空内容或与说明不一致。
- 多次更新触发429、群组冷却或其他频率限制。
- 来源要求公开令牌、安装未知证书或运行陌生脚本。
- 所有节点均失败,且没有新的可追溯测试证据。
- 只能靠删除全部数据才能“试试看”,但尚未保存原配置和日志。
公开免费节点只适合可替代、低风险的临时访问,不用于支付、主邮箱、工作后台或身份账户。导入前请阅读免费节点安全检查清单。
资料来源与核对边界
- Hiddify官方GitHub Wiki:URL Scheme,说明支持的导入目标、配置标题与更新间隔响应头。
- Hiddify官方GitHub Releases与HISTORY:用于核对当前版本、配置更新与已修复问题。
- Hiddify GitHub Issue #2048:只作为“不同阶段可能被合并成笼统错误”的个案线索,不作为所有设备的普遍结论。
原文资料核对日期:2026-10-21;上述字段分流补充核对日期:2026-11-11。本文是基于官方资料整理的诊断路径,本站未完成跨平台实际连接测试,不声称已经复现所有错误,也不承诺任何公开节点长期可用。
如果订阅节点仍在、只在启用WARP后出现 netip.ParsePrefix("/24"),请转到Hiddify WARP地址前缀错误排查;本页继续处理更新后节点为空的情况。
常见问题
Hiddify显示更新成功但节点数量为零,说明什么?
“更新成功”可能只代表请求完成或配置记录已保存。还需要检查响应内容是否为空、是否返回登录页或错误页、格式能否解析,以及新配置是否已经被选中。节点数量为零不能直接归因于网络。
Hiddify能导入所有Clash YAML吗?
不能保证。Hiddify基于sing-box体系,部分常见节点可转换,但Clash专属的规则、代理组、脚本或扩展字段未必兼容。优先使用服务方明确提供的Hiddify、sing-box或通用订阅。
排查时要不要删除旧配置重新导入?
先不要。保留旧配置可以区分“新订阅内容异常”和“客户端整体异常”。建议新建临时配置、保存错误文字并比较节点数量;只有确认备份存在后再清理失效配置。