Hiddify App 更新订阅后 Profiles 为空,先不要反复点更新。Hiddify 官方说明里,Profile 可以通过剪贴板或手动 URL 添加,更新按钮只是重新拉取这条 URL;如果服务端返回的不是配置文本,App 看起来完成了刷新,Proxies 页面仍然会是空的。

GitHub Release 页显示 v4.1.1 为最新版本,发布时间是 2026-03-05;后续版本可能改变界面名称或缓存位置。本文只把官方仓库、Release 页和使用文档能支撑的行为写成结论。

先判断是 Profile 空,还是 Proxies 空

Hiddify 里有两个容易混淆的页面:

看到的现象更像哪一层问题先看哪里
Home 页没有任何 Profile订阅没有保存成功,或本地记录被清掉添加入口、Profile 名称、App 权限
Profile 存在,但 Proxies 为空URL 拉到了内容,但没有解析出节点订阅返回内容、格式、版本
更新按钮无报错,节点仍为 0服务端返回空文件、错误页或不匹配格式浏览器或命令行下载 URL
手机端正常,桌面端为空不同端拿到的输出或 Hiddify 版本不同User-Agent、导出格式、Release 版本
旧 Profile 有节点,新 Profile 没有新 URL 或新格式有问题新旧响应内容对照

如果 Home 页连 Profile 名称都没有,先回到添加入口。官方使用文档给了两种方式:Add from clipboardAdd manually,手动添加时要填 NameURL。如果 Profile 名称存在但 Proxies 空,重点转到订阅返回和格式兼容。

把订阅 URL 单独下载

桌面端最省时间的做法,是把同一条 Profile URL 单独下载成文件。

macOS / Linux:

curl -L "你的订阅URL" -o hiddify-profile.txt
sed -n '1,30p' hiddify-profile.txt

Windows PowerShell:

Invoke-WebRequest -Uri "你的订阅URL" -MaximumRedirection 5 -OutFile "$env:TEMP\hiddify-profile.txt"
Get-Content "$env:TEMP\hiddify-profile.txt" -TotalCount 30

正常配置通常会出现这些特征之一:

  • outboundsroutedns,更像 Sing-box JSON。
  • proxies:proxy-groups:rules:,更像 Clash 或 Clash Meta YAML。
  • vmess://vless://ss://trojan://,更像 V2Ray 或单节点分享链接列表。

看到 <!doctype html>、登录表单、套餐页、403404、空文本或一段错误 JSON,就不用继续清 Hiddify 缓存。App 没有拿到可解析配置,Profiles 为空是结果,不是根因。

格式兼容要看内容,不看链接名字

Hiddify App 官方 README 写明,它是基于 Sing-box 的多平台代理客户端,同时支持 Sing-box、V2Ray、Clash、Clash Meta 等订阅或配置格式。问题在于,很多订阅后台的按钮名字和实际输出不一定一致。

排错时按内容判断:

返回内容适合的判断处理动作
JSON 里有 outboundsSing-box 配置优先给 Hiddify 使用,确认 JSON 没被截断
YAML 里有 proxies:Clash / Clash Meta 配置若为空,换 Sing-box 输出交叉测试
多行 vmess://vless://V2Ray 分享链接确认一行一个链接,没有被网页转义
只有 subscription-userinfo 头,没有正文服务端只返回了流量信息重新复制完整 Profile URL
HTML、错误 JSON、空文本不是配置文件回订阅后台换导出入口

一个常见误判是:URL 里写着 clash,但后台按当前设备返回了网页;或者 URL 后缀像 .json,实际内容是过期提示。Hiddify 解析的是响应正文,不解析按钮文案。

版本问题放到后面查

官方 Release 页标记的最新版本是 v4.1.1,发布日期是 2026-03-05,Release 里提供 Android、Windows、macOS、Linux 等安装包。版本排查放到后面,是因为旧版本确实可能有解析或界面问题,但不该早于 URL 内容检查。

建议这样记录:

  • Hiddify 版本号,例如 v4.1.1。
  • 安装来源,是 GitHub Release、应用商店还是系统包管理器。
  • 操作系统版本,例如 Windows 11、macOS 14、Android 14、iOS 17。
  • 同一 Profile URL 下载后的前 30 行内容。
  • 更新后 Home 页 Profile 名称和 Proxies 页面节点数量。

如果同一 URL 在新版本 Hiddify 正常,在旧版本为空,升级是合理动作。如果新旧版本下载到的都是 HTML 或空文本,升级不会改变服务端返回。

缓存处理不要一上来清全局数据

缓存只适合在这两种情况下处理:URL 返回内容正常,格式也对,但 Hiddify 仍显示旧结果或空列表。不要先清全局数据,否则会丢掉本地 Profile、分组选择和界面设置。

更稳的顺序:

  1. 在 Hiddify 里删除空列表对应的 Profile。
  2. 完全退出 Hiddify,再重新打开。
  3. Add manually 填 Name 和 URL,避免剪贴板截断。
  4. 保存后立刻点更新按钮。
  5. 进入 Proxies 页面,看节点数量和延迟测试按钮。

移动端还要注意系统剪贴板权限。剪贴板入口失败时,直接改用手动添加。桌面端如果之前开着 TUN 或系统代理,先关闭连接再更新 Profile,避免更新请求被旧配置影响。

验证方法:看四个结果,而不是只看刷新提示

修好后至少看到四个结果:

  • Home 页能看到正确 Profile 名称。
  • Profile 更新后没有回到空列表。
  • Proxies 页面出现节点或策略组,不是空白页。
  • 点延迟测试后,能看到延迟数值或明确失败原因。

如果只有“更新完成”提示,但 Proxies 仍然为空,说明刷新动作完成了,配置解析没有完成。把下载到的响应文件、Hiddify 版本和平台写在一起,再决定是换输出格式、升级版本,还是重新添加 Profile。

什么时候该停手

这些场景不适合继续点更新:

  • 同一 Profile URL 在浏览器里一直返回登录页或 403。
  • 订阅后台只给 Clash 输出,但你需要 Hiddify 使用 Sing-box 输出做对照。
  • Profile URL 被聊天软件、短链或网页按钮截断,手动复制仍不完整。
  • GitHub Release 版本比你当前安装包新很多,但你无法确认安装来源。
  • 多台设备拿到不同响应,需要先向订阅服务确认导出规则。

Hiddify 是客户端,不负责修复订阅后台返回的内容。客户端能做的是保存 Profile URL、拉取配置、交给 Sing-box 相关内核处理,再把节点显示到 Proxies 页面。

Hiddify 订阅为空还可以接着查什么