节点手册NODE HANDBOOK
问题排查

Hiddify订阅更新后没有节点怎么办?配置不显示的分层排查

Hiddify订阅更新后没有节点或配置不显示时,按获取、内容、解析、选择和启动五层排查,并安全恢复原配置。

原资料核对:2026-10-21 · 字段分流补充:2026-11-11

先看结论

  • “更新成功”最多说明一次更新流程没有立刻报错,不等于远程响应里一定有可用节点,也不等于新配置已经成为活动配置。
  • 先保留旧配置和错误文字,再按“获取 → 内容 → 解析 → 选择 → 启动”顺序判断;不要一上来删除应用数据或反复刷新。
  • Hiddify可以导入远程订阅和单条分享链接,但网页地址、登录页、验证页、空响应,以及不兼容或损坏的配置都可能造成“有订阅名、没有节点”。

适用范围:用于理解 Hiddify 的通用配置更新链路。不同系统、版本和安装包的按钮名称、配置页与日志入口可能不同;本文不把某一版本的界面位置写成所有平台通用步骤。首次使用请先看Hiddify完整教程。

安全边界:不要公开完整订阅URL、二维码、UUID、密码或令牌;不要把私人订阅上传到陌生转换网站。

一分钟症状判断

看到的现象更可能停在哪一层先做什么
添加URL后立即报错地址、授权或网络获取核对URL是否完整,保留HTTP或错误文字
更新后仍看不到节点获取、内容或解析环节需要核对保留提示文字并核对来源返回内容
配置名称存在,但仍显示旧内容需要核对当前选中的配置回到配置列表确认当前使用项
节点出现,连接时仍报错已转为连接或配置兼容问题先断开,再记录最早出现的错误
节点出现但全部超时节点或当前网络不可达转到连通性排查,不再反复导入

第一步:先确认复制的是订阅或分享链接

Hiddify官方URL Scheme说明表明,导入目标可以是Clash链接、sing-box链接、v2ray订阅或单条代理分享链接。普通网站首页、登录页或套餐购买页不是配置本身。

  1. 从来源的“复制订阅”“导入Hiddify”或明确的配置入口重新复制。
  2. 检查聊天软件是否截断了问号后的参数,或者把句号、空格和换行一起复制进去。
  3. 如果链接曾出现在公开截图或群聊中,先在来源方重置令牌,再继续测试。
  4. 不要把完整链接发给陌生人“代测”;只记录域名、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 版本为准;文件能下载只说明取得了内容,不代表当前版本一定能解析。

优先检查:

  1. 内容是不是配置而非说明文字或网页源码。
  2. YAML或JSON是否被截断,缩进、引号和结尾是否完整。
  3. 协议字段和必要参数是否齐全;不要只改文件扩展名。
  4. 是否使用来源明确标注给Hiddify、Clash、sing-box或通用订阅的入口。
  5. 更新Hiddify前先看官方Releases和变更记录;不要从网盘安装所谓“修复版”。

本站近期免费节点页逐期标注公开候选、测试方法与证据;候选配置与进入下载的节点是两回事,测试时间以各日期页实际标注为准。

第四步:确认新配置已经保存并被选中

“配置已经加入”和“当前正在使用该配置”是两个状态。更新后逐项确认:

  1. 配置列表中能看到目标配置;若当前版本显示更新时间,可一并核对。
  2. 打开该配置后,确认应用确实解析出了可选择的条目。
  3. 新配置已被选为活动配置,而不是仍停留在旧配置。
  4. 若当前版本启用了筛选,临时取消筛选后再判断是否真的为空。
  5. 若配置标题相同,先根据更新时间区分,不要同时删除新旧两份。

官方URL Scheme还说明,Profile-Title或响应头中的文件名可以决定配置标题。因此“名字和以前一样”不能证明内容没有更新。

第五步:把解析成功与核心启动失败分开

Hiddify 的 GitHub Issue #2048 记录了一个特定版本、特定配置更新场景下的启动失败报告。它只能说明类似现象曾被个别用户报告,不能证明你的错误原因相同,也不能据此推断所有版本的处理流程。

安全的判断顺序是:

  1. 先断开当前连接,避免更新与自动重连同时发生。
  2. 保留原活动配置,不要立即清空应用数据。
  3. 重新更新一次,并记录最早出现的错误,而不是只截最后一行。
  4. 若新配置能显示节点但启用失败,检查配置校验和核心日志。
  5. 临时切回原配置;原配置能启动而新配置不能启动,问题更可能在新内容或兼容性。
  6. 两份配置都不能启动,再检查应用版本、系统权限和本地核心状态。

节点出现后仍不能上网怎么办

这时问题已经从“节点不显示”转成“节点或接管不可用”。不要继续删除和重加订阅,改做以下最小验证:

  1. 只选一个节点,执行客户端提供的连通或延迟测试。
  2. 连接后打开普通HTTPS网页,再检查出口IP是否变化。
  3. 根据现象转到代理连接成功但网页打不开的排查,不要仅凭一次失败直接认定是DNS或节点问题。
  4. Wi-Fi与蜂窝网络对照时一次只改变一个条件。
  5. 延迟有数字不等于网页可用;继续查看免费节点延迟正常但不能用的排查。

失败后的安全恢复

  1. 关闭Hiddify连接,确认系统VPN状态消失。
  2. 切回原先可用的配置;无法判断时先停用新配置,不要删除全部内容。
  3. 退出Hiddify后确认普通网络和DNS恢复。
  4. 若URL曾泄露,重置订阅令牌;只删除聊天记录不能让旧令牌失效。
  5. 不要关闭TLS校验、安装未知根证书或授予与排查无关的系统权限。
  6. 记录客户端版本、系统、测试时间、网络、配置类型、节点数量和错误文字,便于复现。

什么时候应停止继续尝试

  • 来源长期不更新,返回空内容或与说明不一致。
  • 多次更新触发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或通用订阅。

排查时要不要删除旧配置重新导入?

先不要。保留旧配置可以区分“新订阅内容异常”和“客户端整体异常”。建议新建临时配置、保存错误文字并比较节点数量;只有确认备份存在后再清理失效配置。

也可以前往全部文章浏览。