路由配置网标志路由配置网ROUTECFG.COM

Hiddify 配置文件怎么导入、更新和排查

更新于 2026-10-30 · routecfg.com

简答:Hiddify 配置文件要先区分类型:订阅链接用于批量节点和自动更新,单节点链接用于单个连接,本地文件用于保存配置,App 设置 JSON 用于运行参数迁移;

定义:Hiddify 配置文件是客户端读取连接或运行参数的数据,但订阅链接、单节点链接、本地配置文件和 App 设置 JSON 的用途并不相同。

先看速查表:你手里的 Hiddify 配置是什么

如果你搜索“Hiddify 配置文件”,先不要急着改文件后缀。链接不是文件,App 设置也不是节点订阅。Hiddify 官方使用文档将 Profile、Subscription link 和 Config 分开说明:Profile 是应用保存的一条连接入口,订阅链接可以返回多个服务器并继续更新,Config 通常是单个服务器的连接配置。Hiddify 官方使用文档还说明,当前 v4.1.1 的页面与旧版本截图可能不同,但基本添加流程相同。

类型常见形式导入入口是否自动更新适用场景
订阅链接https://...剪贴板、手动 URL、二维码可以,取决于链接服务端多个节点、日常使用
单节点链接vless://、vmess://、trojan://、ss://剪贴板或快速导入链接通常不会随订阅自动更新测试单个连接
本地配置文件JSON、YAML 或其他客户端配置内容取决于客户端或 HiddifyCli需要手动替换或重新获取备份、服务器、无桌面环境
App 设置 JSON应用导出的 JSONHiddifyCli 的 -d 参数不是节点订阅迁移运行设置

最快判断:手里是完整的 https:// 地址,优先按订阅导入;是 vless:// 等协议链接,按单节点导入;是本地 JSON 或其他文件,先确认它是节点配置还是 App 运行设置,不能混用。

Hiddify 配置文件最短导入步骤

Hiddify 配置文件最短导入步骤
  1. 先保留旧配置。如果 Hiddify 中已有可用 Profile,先记录名称和来源,不要直接删除唯一可用配置。
  2. 确认内容类型。订阅链接应是完整的 https:// 地址;官方文档明确说明,Hiddify App 不再接受普通 http:// 订阅链接。单节点则通常以 vless://、vmess://、trojan:// 或 ss:// 开头。官方导入说明
  3. 打开 Hiddify,点击主页顶部的“+”。常见入口包括 Clipboard、Manually 和 Scan QR:已复制链接用 Clipboard,手动填写名称和 URL 用 Manually,屏幕上有二维码时使用 Scan QR。
  4. 导入后检查 Profile。如果提示 Invalid URL 或 Failed to add profile,先重新复制完整内容,删除标题、空格和多余换行,再尝试手动输入。
  5. 选择节点并连接。Profile 出现后进入 Proxies 页面选择节点,回到主页点击连接按钮。Android 和 iOS 首次连接需要允许系统创建 VPN 配置。
  6. 连接失败先更新再换节点。官方使用页建议在 Connecting 或报错时先换 Proxies 中的其他服务器,或点击 Profile 的更新按钮重新获取服务器列表。

Hiddify 官方安装文档当前标注的最新稳定版本为 v4.1.1,并列出 Android、iOS、Windows、macOS 和 Linux 的安装方式;不同系统的按钮位置可能略有差异,但“添加 Profile—选择节点—连接”的主流程一致。官方安装与支持平台说明

不同平台怎么导入:手机、电脑与命令行

平台优先操作需要特别确认
Android主页“+”后使用剪贴板、手动 URL 或二维码首次连接允许 VPN;后台断开时检查电池优化设置
iOS主页“+”后导入订阅或单节点首次连接允许添加 VPN 配置
Windows导入后先使用 System proxy 验证部分桌面软件可能不读取系统代理;VPN 模式需要管理员权限
macOS先用 System proxy,再按需切换 VPNVPN 模式可能需要管理员权限;官方给出了使用 sudo 启动的方式
Linux桌面端导入 Profile,或使用 AppImageVPN 模式可能需要 root 权限;命令行环境可使用 HiddifyCli

电脑端的三种模式不要混为一谈:Proxy只提供本地代理,应用需要自行配置;System proxy依赖浏览器或应用遵循操作系统代理,官方文档说明它是电脑端默认模式;VPN用于让更广泛的设备流量经过 Hiddify,官方文档说明电脑端切换 VPN 可能需要管理员或 root 权限。模式与权限说明

如果电脑端出现 Missing privilege,先完全退出 Hiddify,再按系统权限重新启动:Windows 使用“以管理员身份运行”;macOS 和 Linux 按官方文档使用管理员或 root 权限启动。不要把“显示 Connected”直接当成所有软件都已接管,目标应用是否遵循系统代理仍需单独验证。

订阅、单节点和 App 设置 JSON 的更新与备份

订阅链接如何更新

订阅链接是应用重新获取节点列表的入口。打开 Profile 卡片上的更新按钮,等待列表重新加载;更新后检查节点数量和名称,再进行连接。订阅更新失败时,不要立即删除旧 Profile,先保留旧配置作为回滚入口。

单节点链接什么时候使用

单节点适合验证某一个连接参数,或者临时导入一个服务器。官方 URL Scheme 文档列出了 vless://、vmess://、ss:// 和 trojan:// 等形式,也支持通过 hiddify://import/ 快速导入订阅或单节点。单节点不是订阅,服务端参数发生变化后通常需要重新获取链接。Hiddify URL Scheme 文档

App 设置 JSON 与节点配置的区别

App 设置 JSON 保存的是客户端运行参数,不等于节点订阅,也不一定包含可直接连接的服务器。HiddifyCli 官方文档使用 -c 加载配置文件或订阅链接,使用 -d 加载 Hiddify App 设置文件或设置 URL。迁移时应分别备份订阅入口和 App 设置,不能把设置 JSON 当成订阅地址粘贴到普通导入框。HiddifyCli 官方说明

订阅链接、单节点链接和设置文件可能包含令牌、UUID、密码或私钥等敏感信息。不要把完整内容公开到论坛、截图或代码仓库;如果已经泄露,应联系配置提供方重新生成或撤销相关凭据。

HiddifyCli 运行本地配置或订阅链接

HiddifyCli 面向无桌面环境,例如服务器或自动化环境。官方给出的基本命令是:

HiddifyCli run -c <配置文件或订阅链接>

运行本地配置文件:

HiddifyCli run -c ./config.conf

运行订阅链接:

HiddifyCli run -c <https 订阅链接>

如果还要加载 Hiddify App 导出的设置:

HiddifyCli run -c <配置文件或订阅链接> -d <HiddifyApp 设置 JSON 或 URL>

执行前检查二进制文件架构、文件路径和读取权限。-c 的对象是要运行的配置或订阅,-d 的对象是 App 设置,两者用途不同。官方 HiddifyCli 页面还说明,App 设置可从应用中导出为 JSON;但如果当前 App v4 页面已经没有旧版 Config Options 入口,应以当前客户端界面为准,不要机械照抄旧截图。HiddifyCli 参数与导出说明

导入失败、更新失败和连接后无网络:按阶段排查

现象先判断阶段排查顺序
Invalid URL链接格式或复制内容重新复制完整链接;订阅确认是 HTTPS;单节点确认协议头完整
Failed to add profile添加阶段去掉标题、空格和换行;改用手动 URL;再尝试二维码
Profile 已添加但没有节点订阅响应阶段手动更新;确认设备能访问订阅地址;核对订阅是否仍有效
一直 Connecting节点连接阶段先换同一 Profile 的其他节点,再更新 Profile;仍失败时检查系统时间、网络和权限
Connected 但某个软件无网络代理模式或应用兼容阶段确认 System proxy 或 VPN 模式;检查目标应用是否遵循系统代理
VPN 模式权限不足系统权限阶段完全退出客户端,按系统使用管理员或 root 权限重新启动
  1. 先看影响范围:只有一个节点失败,优先检查该节点;所有节点都失败,优先检查订阅、客户端网络和权限。
  2. 再看失败阶段:添加失败属于链接解析;更新失败属于订阅获取;Connected 但无网络属于代理、VPN、DNS、路由或应用兼容问题。
  3. 每次只改一个变量:先换节点,再更新订阅,再切换模式,最后才检查 DNS、TUN 或 MTU,避免多个改动同时发生。
  4. 保留回滚入口:恢复旧 Profile,或关闭刚启用的 VPN 模式;确认恢复后再继续下一步。

官方使用页明确写出,Hiddify App v4 已不再保留旧版的 Config Options、Enable TUN、Routing Assets、MultiPlexer 和部分 Experimental 开关。看到旧教程中的菜单时,应先按当前页面的 Routing、DNS、Inbound 或 VPN 设置寻找对应功能,不要直接把旧字段写入新版本。Hiddify App v4 页面变化说明

常见问题

Hiddify 配置文件和订阅链接有什么区别?

订阅链接是获取一组节点并支持后续更新的入口,本地配置文件是已经保存下来的数据。App 设置 JSON 主要用于迁移运行参数,不应直接当成节点订阅导入。

Hiddify 能导入 Clash、sing-box 和 V2Ray 订阅吗?

官方安装文档列出 Hiddify 对 sing-box、V2Ray、Clash 和 Clash Meta 订阅的支持,也列出了多种协议。具体是否成功仍取决于链接内容、服务端响应和当前版本,导入前应保留原有 Profile。官方支持格式说明

Hiddify 配置文件导入后为什么没有节点?

先手动更新 Profile,再确认订阅地址可访问。如果只有一个节点失败,换节点验证;如果整个 Profile 都为空,应核对订阅是否失效或响应为空,并联系配置提供方。

Hiddify 显示 Connected,但软件仍然不能联网怎么办?

先确认电脑处于 System proxy 还是 VPN 模式,再检查目标软件是否遵循系统代理。部分软件可能忽略系统代理,因此 Connected 只说明客户端状态,不等于每个应用的流量都已验证。

Hiddify 配置链接可以公开分享吗?

不建议。订阅链接和单节点链接可能包含令牌、UUID、密码或私钥等凭据。公开前应脱敏;已经泄露时,应尽快撤销或重新生成相关配置。

参考资料

Hiddify:How to use the Hiddify app

Hiddify:How to install the Hiddify app

Hiddify:How to use HiddifyCli

Hiddify:URL Scheme in HiddifyApp

常见问题

Hiddify 配置文件和订阅链接有什么区别?

订阅链接用于获取并更新一组节点,本地配置文件是已保存的数据,App 设置 JSON 则用于迁移运行参数,三者不能直接混用。

Hiddify 能导入 Clash、sing-box 和 V2Ray 订阅吗?

Hiddify 官方安装文档列出对 sing-box、V2Ray、Clash 和 Clash Meta 订阅的支持,但最终结果仍取决于链接内容、服务端响应和客户端版本。

Hiddify 配置文件导入后没有节点怎么办?

先手动更新 Profile,再区分单个节点失败还是整个订阅为空;若全部为空,检查订阅地址是否有效以及设备是否能访问该地址。

Hiddify 显示 Connected 但软件无法联网怎么办?

先确认 System proxy 或 VPN 模式,再检查目标软件是否遵循系统代理;不要只根据 Connected 状态判断所有应用流量都已生效。

Hiddify 配置链接可以公开分享吗?

不建议。链接可能包含令牌、UUID、密码或私钥等凭据,已经泄露时应联系配置提供方重新生成或撤销。

相关阅读

参考资料

  1. How to use the Hiddify app(hiddify.com)
  2. How to install the Hiddify app(hiddify.com)
  3. How to use HiddifyCli(hiddify.com)
  4. URL Scheme in HiddifyApp(hiddify.com)
读者交流群(DNS · TUN · Clash 规则配置交流):t.me/routecfg_chat