节点手册NODE HANDBOOK
完整教程

Hiddify完整教程:全平台下载、添加配置、连接与故障排查

Hiddify中文完整教程,覆盖官方下载安装、配置导入、自动选择、系统VPN、订阅更新、常见错误和安全退出。

节点手册编辑部 · 资料核对日期:2026.10.21 · 实质修订:2026.11.03

当前版本 v5.5.5(发布于 2026-11-04)· 在下载中心核对安装包、文件大小与签名校验方式

Hiddify中文完整教程,覆盖官方下载安装、配置导入、活动配置确认、首次连接、订阅更新、常见错误和安全退出。“更新后节点为空”另有专项排查,避免把完整教程写成单一故障页。

资料核对日期:2026.10.21

基本结论

  • 平台:官方文档与项目下载表列出 Android、iOS、Windows、macOS、Linux;实际可用安装包以当前官方发布页为准。
  • 收费与授权:官方安装文档说明应用免费、无广告且开源;仓库中的 Linux 元数据标注项目许可为 GPL-3.0-or-later。
  • 验证边界:本站核对了官方资料,但未完成跨平台实际连接测试,不写成速度、稳定性、耗电或解锁实测。

适合谁

需要跨平台客户端、订阅更新和系统 VPN/TUN 接管的用户。不同系统版本的按钮名称、权限提示和安装包会变化,本文按任务顺序说明,不把示意图当成软件截图。

主要优点

  • 免费、开源,官方项目提供多平台安装包。
  • 官方 URL Scheme 支持导入 Clash、sing-box、v2ray 订阅及单条分享链接等目标。
  • 可以保存多份配置,适合把日常配置和临时公开配置分开管理。

主要缺点与限制

  • 支持某类导入目标不等于所有协议字段、覆写与转换结果完全兼容。
  • 高级路由、DNS、系统代理和 VPN/TUN 权限存在平台差异。
  • 配置名称出现不代表节点已经解析,也不代表该配置正在使用。
  • 本站尚未验证睡眠唤醒、退出恢复和资源占用。

官方下载

从 Hiddify 官方 GitHub 项目、GitHub Releases 或项目明确链接的应用商店下载。官方项目当前列出的入口如下;文件名可能随版本变化,下载前仍要以 Releases 页面为准:

系统官方入口与基础安装
iOS使用官方项目链接的 App Store,或核对 Releases 是否提供当前 iOS 资产;不要安装来源不明的签名包。
Android官方项目列出 universal、ARM64、ARMv7 与 x86_64 APK;不确定架构时优先使用官方商店或 universal 包。
Windows官方项目列出 x64 安装包与便携版;安装版运行下载文件并按安装向导完成,便携版解压后运行。
macOS官方项目列出 App Store、DMG 与 PKG;DMG 方式下载后将应用移入 Applications,再从应用目录启动。
Linux官方项目列出 x64 AppImage、Debian 包和 RPM;按发行版选择,AppImage 需要可执行权限。

核对系统、CPU 架构和安装包类型,不使用第三方“汉化修复版”或来历不明的网盘包。本站不重新打包安装文件。

开始前先分清三个状态

Hiddify 中“添加了配置”“配置解析出节点”“该配置正在使用”不是同一件事:

  1. 配置已添加:列表里出现名称,只能说明保存了一个配置入口。
  2. 内容已解析:打开配置后出现可选择条目,才说明当前版本识别了返回内容。
  3. 配置正在使用:连接时实际选择的是这份配置,而不是另一份旧配置。

如果更新后只有配置名称、仍看不到节点,转到Hiddify订阅更新后没有节点专项排查。

添加配置而不是普通网页

官方使用指南说明可以在主页通过“+”添加配置,支持“从剪贴板添加”,也可手动填写名称与 URL 后保存;官方 URL Scheme 还列出 Clash、sing-box、v2ray 订阅和单条分享链接等导入目标。不同版本的按钮文字可能变化,导入前先判断拿到的是配置入口还是普通网页:

拿到的内容应该怎么做不要怎么做
来源明确提供的远程配置 URL在 Hiddify 的添加配置入口保存并更新公开完整 URL 求助
单条分享链接使用当前版本提供的链接导入方式截掉问号后的参数
Clash 或 sing-box 配置使用来源明确标注兼容的入口只改扩展名冒充另一种格式
登录页、套餐页或验证页回来源复制真正配置地址把 HTTP 200 当作配置有效

需要公开临时配置时,从近期免费节点页查看各期明确标注的测试方法与证据;候选来源可访问不等于节点可连接。

第一次连接的最短路径

  1. 先保持默认路由和 DNS,不同时改多个高级选项。
  2. 官方使用指南说明配置加入后可在主页切换配置,并在 Proxies 页面查看条目;确认目标配置中已经出现条目,再使用自动选择或手动选一个节点。
  3. 按官方指南从主页启动连接,并按系统提示授予 VPN 权限;同一时间只运行一款代理客户端。
  4. 打开普通 HTTPS 网页,再用IP检测比较连接前后的出口。
  5. 关闭连接,确认系统 VPN 状态消失、普通网络能够恢复。

“网页可访问、出口按预期变化、关闭后网络恢复”都通过,才算完成一次基础验证。延迟出现数字不能单独证明网页可用。

自动选择与手动节点

官方使用指南说明应用可以按测试自动选择代理,也允许手动选择,并在代理页面显示和测试延迟。第一次使用先保留自动选择,建立能否连接的基线;需要固定地区时再手选节点。只在同一客户端、同一测试方式下比较延迟,不能把不同后端、运营商或测试方法的数字直接排名。

自动更新与手动更新

  • 首次导入先手动更新一次,确认内容被解析,再考虑自动更新。
  • 官方 URL Scheme 说明来源可以通过 profile-update-interval 建议更新间隔;这是来源建议,不是高频刷新的理由。
  • 遇到 429、群组冷却或来源频率限制时停止刷新,不使用多个账号绕过限制。
  • 更新前保留旧配置;更新后节点为空时,不要先删除旧配置或清空应用数据。
  • 配置 URL 曾公开时,应在来源方重置凭证;删除截图不能让旧令牌失效。

Linux 桌面版若在 VPN/TUN 授权后出现 Bad state: exit status 127,先按Hiddify Linux 启动阶段专项排查核对帮助进程和安装包;这与订阅更新后列表为空是不同阶段。

常见问题对照

现象先检查什么对应页面
配置保存了但没有节点来源返回内容、格式和当前使用配置更新后没有节点
节点存在但全部超时来源时效、当前网络与节点连通性免费节点失效排查
显示连接但网页打不开基础网络、接管范围与错误日志连接检查表
浏览器能用、其他应用不能用系统代理与 VPN/TUN 的接管差异系统代理与TUN
退出后仍不能直连系统 VPN 状态、按需连接和其他客户端下方“断开与恢复”

更新后没有节点怎么查

先保留错误文字和旧配置,按“地址获取、响应内容、格式解析、当前配置、连接启动”依次缩小范围。这个顺序是本站整理的诊断框架,不是官方界面流程。完整步骤见Hiddify订阅更新后没有节点专项排查。

连接后所有网站都打不开

先断开连接,确认不使用代理时基础网络正常;然后只选一个节点重新测试,避免同时改 DNS、规则和接管模式。仍失败时记录最早错误,并使用连接检查表继续排查。不要关闭 TLS 校验或安装未知根证书。

断开与恢复普通网络

  1. 在 Hiddify 中停止连接。
  2. 确认系统 VPN 状态已经消失,再退出应用。
  3. 检查是否还有另一款代理客户端、始终开启 VPN、按需连接或桌面系统代理在接管。
  4. 测试普通 HTTPS 与 DNS 是否恢复。
  5. 只删除确认来自本次测试且不再需要的配置;不要把清空全部应用数据当作第一步。

诊断记录与隐私

排查时记录系统、Hiddify 版本、测试时间和时区、基础网络、配置类型、更新结果、节点数量、最早错误以及断开后直连是否恢复。公开求助前遮盖完整订阅 URL、UUID、密码、二维码和令牌。

图示与验证说明

页面中的操作图是本站绘制的任务路径示意,不是复制的软件截图。按钮名称可能随系统和版本变化。官方依据为 Hiddify 的安装指南、使用指南、GitHub README、Releases、HISTORY 与 URL Scheme;本站按新手完成任务的顺序重新整理,没有把未完成的设备实测写成亲测结论。

官方资料链接:

WARP 是单独的配置路径,不等同于普通节点

资料核验:北京时间 2026-11-03。Hiddify 官方 WARP 指南区分内置 WARP 功能和自定义 warp:// 配置;具体按钮位置以当前版本的官方界面为准。普通订阅即使能更新,也不能证明 WARP 已生成有效配置;WARP 报错也不能直接证明订阅节点失效。

测试结果 判断范围 下一步
普通节点正常,开启 WARP 后报错 WARP 生成、出站或绕行路径 关闭 WARP,保留普通节点基线,记录第一条错误
WARP 关闭后节点列表仍为空 订阅获取、解析或选中状态 查看更新后无节点排查
添加 WARP 时出现 netip.ParsePrefix("/24") 不完整的地址前缀被解析 查看Hiddify WARP 精确报错
WARP 与普通节点都连不上,直连也失败 基础网络或系统代理/VPN 未恢复 先恢复直连,不继续叠加配置

排查时只切换一个变量:先关闭 WARP,用原配置测试普通 HTTPS;再单独测试内置 WARP 或自己维护的自定义 WARP 配置。记录客户端版本、操作系统、WARP 模式及错误发生的动作。日志中的密钥、订阅 URL、节点地址和公网 IP 必须脱敏。

Hiddify Issue #930 与 Issue #1389 曾记录类似 WARP 地址前缀错误,跨越旧版 Linux 与 Windows。它们不能证明当前版本的所有同名错误由同一原因造成。不要把重装或删除应用数据当作通用步骤;先保存可恢复的配置,再考虑版本更新或向官方提交脱敏复现信息。

WARP 关闭后普通节点恢复,还要继续改订阅吗?

不需要立刻改。这个对照只说明普通节点路径和 WARP 路径表现不同;保留可用配置,专门检查 WARP 的生成与绕行设置。

为什么不直接导入别人提供的 WARP 配置?

自定义配置可能包含密钥和地址字段。来源不明的配置无法证明适配当前版本,也可能覆盖原有可恢复状态。先按官方指南核对自己使用的模式与字段。

可以凭一个错误就判断机场坏了吗?

不能。先在关闭 WARP 后单独测试同一普通节点;机场资料另见公开评级与核验页。

本章是否适用于所有 Hiddify 版本?

本章提供阶段判断,不承诺界面位置一致。官方当前指南和旧版 Issue 的版本不同;以设备上的实际版本及官方发布说明为准。

验证状态

2026-10-21完成官方资料核对;未完成本站跨平台实际连接测试。速度、稳定性、耗电、资源占用和流媒体能力均不作结论。

内链与意图分工

  • 本页承担 Hiddify 安装、导入、连接、更新和安全退出的完整使用路径。
  • /articles/free-nodes-import-hiddify/ 承担免费节点首次导入。
  • /articles/hiddify-subscription-updated-no-nodes/ 专门解决更新后节点为空。
  • /free-nodes/ 是免费节点核心页,不由工具教程替代。

订阅要先转格式?把 vmess / ss / trojan / vless 分享链接或 Base64 订阅贴进订阅链接转换器,在浏览器本地生成 Clash Meta 可用的 YAML,链接不上传、不需要注册。

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