当前版本 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 中“添加了配置”“配置解析出节点”“该配置正在使用”不是同一件事:
- 配置已添加:列表里出现名称,只能说明保存了一个配置入口。
- 内容已解析:打开配置后出现可选择条目,才说明当前版本识别了返回内容。
- 配置正在使用:连接时实际选择的是这份配置,而不是另一份旧配置。
如果更新后只有配置名称、仍看不到节点,转到Hiddify订阅更新后没有节点专项排查。
添加配置而不是普通网页
官方使用指南说明可以在主页通过“+”添加配置,支持“从剪贴板添加”,也可手动填写名称与 URL 后保存;官方 URL Scheme 还列出 Clash、sing-box、v2ray 订阅和单条分享链接等导入目标。不同版本的按钮文字可能变化,导入前先判断拿到的是配置入口还是普通网页:
| 拿到的内容 | 应该怎么做 | 不要怎么做 |
|---|---|---|
| 来源明确提供的远程配置 URL | 在 Hiddify 的添加配置入口保存并更新 | 公开完整 URL 求助 |
| 单条分享链接 | 使用当前版本提供的链接导入方式 | 截掉问号后的参数 |
| Clash 或 sing-box 配置 | 使用来源明确标注兼容的入口 | 只改扩展名冒充另一种格式 |
| 登录页、套餐页或验证页 | 回来源复制真正配置地址 | 把 HTTP 200 当作配置有效 |
需要公开临时配置时,从近期免费节点页查看各期明确标注的测试方法与证据;候选来源可访问不等于节点可连接。
第一次连接的最短路径
- 先保持默认路由和 DNS,不同时改多个高级选项。
- 官方使用指南说明配置加入后可在主页切换配置,并在 Proxies 页面查看条目;确认目标配置中已经出现条目,再使用自动选择或手动选一个节点。
- 按官方指南从主页启动连接,并按系统提示授予 VPN 权限;同一时间只运行一款代理客户端。
- 打开普通 HTTPS 网页,再用IP检测比较连接前后的出口。
- 关闭连接,确认系统 VPN 状态消失、普通网络能够恢复。
“网页可访问、出口按预期变化、关闭后网络恢复”都通过,才算完成一次基础验证。延迟出现数字不能单独证明网页可用。
自动选择与手动节点
官方使用指南说明应用可以按测试自动选择代理,也允许手动选择,并在代理页面显示和测试延迟。第一次使用先保留自动选择,建立能否连接的基线;需要固定地区时再手选节点。只在同一客户端、同一测试方式下比较延迟,不能把不同后端、运营商或测试方法的数字直接排名。
自动更新与手动更新
- 首次导入先手动更新一次,确认内容被解析,再考虑自动更新。
- 官方 URL Scheme 说明来源可以通过
profile-update-interval建议更新间隔;这是来源建议,不是高频刷新的理由。 - 遇到 429、群组冷却或来源频率限制时停止刷新,不使用多个账号绕过限制。
- 更新前保留旧配置;更新后节点为空时,不要先删除旧配置或清空应用数据。
- 配置 URL 曾公开时,应在来源方重置凭证;删除截图不能让旧令牌失效。
Linux 桌面版若在 VPN/TUN 授权后出现 Bad state: exit status 127,先按Hiddify Linux 启动阶段专项排查核对帮助进程和安装包;这与订阅更新后列表为空是不同阶段。
常见问题对照
更新后没有节点怎么查
先保留错误文字和旧配置,按“地址获取、响应内容、格式解析、当前配置、连接启动”依次缩小范围。这个顺序是本站整理的诊断框架,不是官方界面流程。完整步骤见Hiddify订阅更新后没有节点专项排查。
连接后所有网站都打不开
先断开连接,确认不使用代理时基础网络正常;然后只选一个节点重新测试,避免同时改 DNS、规则和接管模式。仍失败时记录最早错误,并使用连接检查表继续排查。不要关闭 TLS 校验或安装未知根证书。
断开与恢复普通网络
- 在 Hiddify 中停止连接。
- 确认系统 VPN 状态已经消失,再退出应用。
- 检查是否还有另一款代理客户端、始终开启 VPN、按需连接或桌面系统代理在接管。
- 测试普通 HTTPS 与 DNS 是否恢复。
- 只删除确认来自本次测试且不再需要的配置;不要把清空全部应用数据当作第一步。
诊断记录与隐私
排查时记录系统、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,链接不上传、不需要注册。