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 clipboard 和 Add manually,手动添加时要填 Name 和 URL。如果 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
正常配置通常会出现这些特征之一:
outbounds、route、dns,更像 Sing-box JSON。proxies:、proxy-groups:、rules:,更像 Clash 或 Clash Meta YAML。vmess://、vless://、ss://、trojan://,更像 V2Ray 或单节点分享链接列表。
看到 <!doctype html>、登录表单、套餐页、403、404、空文本或一段错误 JSON,就不用继续清 Hiddify 缓存。App 没有拿到可解析配置,Profiles 为空是结果,不是根因。
格式兼容要看内容,不看链接名字
Hiddify App 官方 README 写明,它是基于 Sing-box 的多平台代理客户端,同时支持 Sing-box、V2Ray、Clash、Clash Meta 等订阅或配置格式。问题在于,很多订阅后台的按钮名字和实际输出不一定一致。
排错时按内容判断:
| 返回内容 | 适合的判断 | 处理动作 |
|---|---|---|
JSON 里有 outbounds | Sing-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、分组选择和界面设置。
更稳的顺序:
- 在 Hiddify 里删除空列表对应的 Profile。
- 完全退出 Hiddify,再重新打开。
- 用
Add manually填 Name 和 URL,避免剪贴板截断。 - 保存后立刻点更新按钮。
- 进入
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 页面。