Hiddify 的导入入口有三类：Home 页 + 里的 Add from clipboard、Add manually，以及网页按钮常用的 URL Scheme。官方使用教程要求手动导入时填写 Name 和 URL；URL Scheme wiki 给出的新格式是 hiddify://import/订阅链接#名称。

先看前 20 行，还是先重装 App？

先看前 20 行。Profile 更新为空，最常见的原因不是安装包坏了，而是订阅地址实际返回了网页、错误页或空内容。

桌面端：

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

Windows PowerShell：

Invoke-WebRequest -Uri "订阅URL" -MaximumRedirection 5 -OutFile hiddify-profile.txt
Get-Content .\hiddify-profile.txt -TotalCount 20

看到 <!doctype html>、登录表单、403、套餐页或过期提示，就不用继续点导入。Hiddify 支持多种订阅格式，但不会把网页自动转换成节点。

三种导入入口该选哪一个？

入口官方术语适合什么情况先排查什么
Home 页 +Add from clipboard手机和桌面刚复制完链接剪贴板权限、链接是否被截断
Home 页 +Add manually想确认 Name 和 URL 有没有填对首尾空格、漏掉 query 参数
网页唤起 Apphiddify://import/订阅链接#名称订阅后台提供一键导入按钮系统是否关联 Hiddify、井号后内容是否被截断

第一次排错建议从 Add manually 开始。它最笨，但能把 Name、URL、复制内容三个变量分开看，不会被系统剪贴板或浏览器深链处理干扰。

URL Scheme 的 #名称 为什么容易出错？

#名称 是给 Profile 命名的片段，不是订阅 URL 的一部分。问题在于：很多聊天软件、网页按钮和浏览器都会特殊处理井号后面的内容。

如果原始订阅 URL 本身已经带 #，深链就很容易被截断。遇到这类链接，别先测网页按钮，改用 Add manually，把完整 URL 粘进 Hiddify。

旧格式如 hiddify://install-sub?url=...、install-config、install-proxy 已被官方 wiki 标成 deprecated。网上还能搜到这些写法，但排错时不要把旧格式当成基准。

Profile 更新为空看哪几个信号？

导入后马上点 Profile 更新按钮，然后只看三个信号：

  • Profile 名称是否变成你填的 Name，或变成 URL 末段。
  • Proxies 页面是否出现节点，以及延迟测试按钮。
  • 错误提示里是否有 Failed to Add Profile、Unexpected connection error、parse。

GitHub issue #1661 里，报告者在 Windows 10/11 上遇到 Failed to add profile 和 Unexpected connection error，同一订阅在其它设备可用。这种情况不能只写「链接坏了」，要同时记录设备系统、Hiddify 版本、网络环境和应用日志。

怎么判断是格式不兼容？

Hiddify 说明页提到它支持 Clash、Sing-box、Shadowsocks 等订阅类型；项目 README 也写过 ClashMeta、v2rayN、sing-box outbound 等常见格式。

先看响应开头长什么样：

proxies:             # Clash/Mihomo YAML 常见
outbounds            # sing-box JSON 常见
vmess://             # V2Ray 分享链接
vless://             # VLESS 分享链接
响应表现更可能原因下一步
proxies: 开头Clash/Mihomo YAML若解析失败，换 Sing-box 输出再试
outbounds 开头sing-box JSON检查 JSON 是否完整、是否被登录页替换
vmess:// 或 vless://单节点链接确认一行一个链接，没有被换行截断
HTML 或错误 JSON订阅后台返回错页面重新登录后台复制订阅 URL

如果同一账号要给 Clash、sing-box、V2Ray 多端共用，后台输出格式不一致会让排错时间翻倍。多端迁移时，用兼容 Clash / Singbox / V2Ray 的订阅承载主力客户端，比手工转换一份来历不明的配置更省事。

修好以后怎么确认？

导入成功不等于配置已经可用。至少做完下面 4 个检查：

  1. Profile 列表里能看到你设置的名称。
  2. Proxies 页面有节点列表，不是空白页。
  3. 手动点一次 Profile 更新，没有再次出现导入错误。
  4. 延迟测试按钮能跑出结果，失败节点和可用节点有明确区分。

如果只有某一台 Windows 设备失败，其它平台正常，把 Hiddify 版本、系统版本和错误日志一起留存，再对照官方 issue 排查。不要在同一轮里同时换订阅、换客户端、换系统代理设置，否则很难判断是哪一步生效。

相关阅读

FAQ

hiddify://import 后面能放什么链接？

官方 wiki 写法是 hiddify://import/订阅链接#名称。订阅链接可以是 Clash link、Sing-box link、V2Ray sublink，也可以是 vmess://、vless://、ss://、trojan:// 这类单节点分享链接。

Failed to Add Profile 一定是链接无效吗？

不一定。issue #1661 里有人在 Windows 上导入可用订阅仍报 Failed to add profile 和 Unexpected connection error。所以要同时看设备、Hiddify 版本、当前网络和应用日志。

导入成功但节点为空怎么办？

先看订阅响应前 20 行。若是 HTML、错误 JSON、过期提示或空文本，Hiddify 无法生成节点；若是正常配置，再换 Clash、Sing-box 或 V2Ray 输出做交叉测试。

旧的 install-sub 链接还要用吗？

不建议优先用。官方 wiki 已把 install-sub、install-config、install-proxy 标成 deprecated。排错时先测 hiddify://import/订阅链接#名称 和 Add manually。