Hiddify 教程:从下载安装到成功连接
简答:Hiddify 是一款跨平台代理客户端,本身不提供节点或订阅。最快上手路径是:从项目官方页面选择对应系统安装包,首次打开后点击“+”导入以 https:// 开头的订阅链接,再连接并用实际网页或应用验证。本文核验于 2026-11-01,版本与商店状态变化时应以项目页面实时显示为准。
定义:Hiddify 是基于 sing-box 的跨平台代理客户端,用于导入订阅或单个配置并建立本地代理、系统代理或 VPN 连接。
先看这三步:安装、导入、验证
如果你只想先完成一次连接,不必一开始修改 DNS、路由或其他高级选项。先确认设备系统符合要求,再导入订阅,最后区分“客户端显示已连接”和“实际应用可以使用”这两个结果。
| 设备 | 官方资料列出的要求 | 优先选择 | 核验边界 |
|---|---|---|---|
| Android | Android 7.0 或更高 | Google Play;无法使用商店时再看 Universal APK | APK 文件名和商店可见性可能变化 |
| iPhone、iPad | iOS 15 或更高 | App Store | 是否显示取决于 Apple 账号地区 |
| Windows | Windows 10 1809 或 Windows 11,64 位 | Setup EXE 或 Microsoft Store | Windows 7、8 不在官方支持范围内 |
| macOS | macOS 10.15 或更高,支持 Intel 与 Apple Silicon | DMG;Apple Silicon 设备也可查看 App Store | 首次打开可能需要在“隐私与安全性”中允许 |
| Linux | 64 位 Linux,Debian/Ubuntu 系列支持较好 | AppImage;Debian、Ubuntu、Mint 可看 DEB | 官方安装文档与项目 README 对 RPM 支持存在差异,需以当前发布页核实 |
- 打开项目的应用教程页或官方安装文档,按系统选择安装方式,不要把第三方下载站的文件名当成固定版本。
- 首次启动后,在主页点击“+”,使用剪贴板、手动输入或二维码添加配置;订阅链接应完整复制,并优先检查是否以
https://开头。 - 点击主页连接按钮。看到“Connected”只代表客户端建立了连接,随后还要打开实际网页或应用确认代理出站正常。
官方安装文档当前显示的稳定版本为 v4.1.1,本文只把它作为 2026-11-01 的核验结果,不把版本号写成永久结论。官方安装文档同时说明,GitHub 文件不会像应用商店版本那样自动更新。
Hiddify、Hiddify Next 与 Hiddify Manager 有什么区别
Hiddify App是安装在手机或电脑上的客户端,负责导入订阅、选择节点并建立连接;Hiddify Next是旧名称,官方安装文档说明,Windows 的 winget install Hiddify.Next 仍用于安装当前 Hiddify App;Hiddify Manager则是用于管理服务器、用户和配置的另一类项目,不等于桌面或手机客户端。
因此,普通用户搜索“Hiddify 教程”时,通常需要的是 Hiddify App 的安装与使用说明,而不是 Manager 部署教程。项目官方 README 将 Hiddify App 描述为基于 sing-box 的多平台客户端,并列出 Android、iOS、Windows、macOS 和 Linux 等平台。官方中文 README
Hiddify 本身不等于订阅服务。你需要从自己的服务提供方、面板管理员或自建服务获得订阅链接或单个配置;没有链接时,即使客户端安装成功,也不会自动出现可用节点。
按设备完成安装与首次启动
Windows
- 在官方安装文档列出的入口中选择 Setup EXE、Microsoft Store、MSIX 或便携 ZIP。
- 使用 EXE 时双击安装包,按系统提示完成安装;如果出现 SmartScreen 提示,先确认文件来源和数字签名,再决定是否继续,不要把来源不明的安装包加入例外。
- 打开 Hiddify,首次设置时确认语言、地区和匿名分析选项。Windows 电脑通常可先使用默认的 System proxy 模式。
macOS
- Intel 和 Apple Silicon Mac 都可先查看 DMG;Apple Silicon 设备还可核对 App Store 版本。
- 打开 DMG,将 Hiddify 拖入 Applications,再从“应用程序”启动。
- 若 macOS 首次阻止打开,进入“系统设置—隐私与安全性”,仅对已核验来源的应用执行“仍要打开”。
Android、iPhone 与 iPad
- 优先从 Google Play 或 App Store 安装。官方文档说明,iPhone 或 iPad 第一次连接时,系统会请求添加 VPN 配置,需要由用户确认。
- Android 无法使用商店时,再从官方发布页核对 Universal、arm64、arm7 或 x86_64 包;不确定架构时,Universal 是官方文档列出的通用选择。
- 打开应用后先不要改高级设置,直接进入主页准备添加配置。
Linux
- 64 位 Linux 可优先尝试 AppImage;Debian、Ubuntu、Mint 可查看 DEB 包。
- AppImage 不能运行时,先检查文件是否有执行权限,以及系统是否缺少 AppImage 所需组件。
- 官方安装文档称 v4 不再提供 RPM 包,但项目中文 README 仍列出 RPM 下载项;这是资料之间的冲突,不能直接据此判断当前 RPM 包有效,Linux 用户应以当前发布页为准。
停止条件:如果安装包来源、文件签名、系统架构或版本信息无法核对,不要继续安装,先回到项目官方教程页或发布页确认。
导入订阅、选择节点并确认连接
- 打开你获得的用户页面或订阅页面,复制完整链接。官方使用文档将订阅链接定义为可返回服务器列表并支持更新的链接,当前文档要求订阅链接以
https://开头。 - 打开 Hiddify 主页,点击顶部“+”。如果链接已经复制,选择 Clipboard;也可以选择 Manually,填写名称并把链接粘贴到 URL;如果服务页面提供二维码,则使用 Scan QR。
- 导入成功后,主页应出现配置或 profile。点击更新按钮可以重新拉取服务器列表;这一步只说明订阅被读取,不代表每个节点都能连接。
- 进入 Proxies 页面查看节点延迟。延迟是节点响应所需的时间,官方文档建议可重新测试并按延迟排序;单次延迟不能代表持续速度或长期稳定性。
- 点击主页连接按钮。手机首次连接时允许 VPN 配置;电脑可先保持 System proxy,只有在需要接管更多应用或排查系统代理不生效时,再考虑 VPN 模式。
| 模式 | 适合场景 | 验证方式 |
|---|---|---|
| Proxy | 只提供本地代理端口,需要应用自行填写代理 | 检查目标应用是否真的使用了该代理 |
| System proxy | 电脑上的浏览器和多数支持系统代理的应用 | 检查系统代理状态,再打开目标网页 |
| VPN | 手机或需要接管设备流量的场景 | 确认系统 VPN 图标或授权状态,并测试实际应用 |
官方使用文档明确区分了 Proxy、System proxy 和 VPN;不要因为端口监听、系统出现 VPN 图标或客户端显示 Connected,就直接断定所有应用都已通过代理。官方使用 Hiddify App 文档
四类常见问题:按现象排查,不要一次改很多项
1. 提示 Invalid URL 或 Failed to add profile
- 重新复制完整链接,确认没有漏掉开头、结尾或换行。
- 确认链接使用
https://,而不是文档当前不接受的普通http://。 - 如果是二维码,改用手动粘贴测试;如果手动也失败,优先向链接提供方确认订阅地址是否仍有效。
2. 导入成功但节点为空
- 先点击 profile 的更新按钮,观察是否出现错误提示。
- 检查当前网络是否能打开订阅地址;浏览器能打开订阅页面不等于客户端能解析其中的配置。
- 确认提供方给的是订阅链接还是单个节点配置,二者导入方式不同。
3. 一直停在 Connecting 或连接失败
- 进入 Proxies 页面换一个节点并重新测试延迟。
- 更新 profile 后再次连接,排除服务器列表过期的可能。
- 先恢复默认 DNS、Routing 等高级设置,不要同时修改多个参数;官方文档建议没有明确需求时保留默认值。
- 如果所有节点都失败,记录错误文字、设备系统、Hiddify 版本和发生时间,再向订阅提供方反馈,避免只说“连不上”。
4. 显示 Connected,但网页或应用仍无法使用
- 确认当前使用的是 System proxy、VPN 还是仅本地 Proxy;仅 Proxy 模式不会自动接管所有应用。
- 先用一个支持系统代理的浏览器测试,再检查目标应用是否有独立代理设置。
- 暂时关闭其他 VPN、代理工具或系统网络过滤软件,避免多个程序争抢代理设置。
- 如果只有某个应用失败,不要立刻判断节点失效;可能是该应用不读取系统代理,或自身网络设置不同。
回滚规则:每次只改一个设置,记录原值;修改后无法验证时,恢复默认值,重新连接并做一次网页和目标应用的分层测试。
下载与更新的安全核验清单
- 优先从项目官方教程、官方 GitHub 仓库、GitHub Releases 或应用商店进入下载,不把搜索结果中的广告页、网盘包或改名安装包当成官方来源。
- 不要根据固定文件名判断最新版。官方资料明确区分商店版本与 GitHub 文件,发布页中的文件名可能调整。
- 安装前核对操作系统、CPU 架构、文件扩展名和下载来源;Android APK 尤其要避免从无法说明来源的页面获取。
- 不要把 Hiddify 客户端、订阅服务和 Hiddify Manager 混为一谈。客户端能否连接,取决于导入的配置和节点状态,不能仅凭安装成功得出结论。
- 本文核验日期为 2026-11-01。官方安装文档当前写明稳定版本为 v4.1.1,但如果你看到不同版本,应以发布页或应用商店当前显示为准。
这是一篇第三方使用指南,不是 Hiddify 项目官方页面;品牌名称、版本和平台能力均按已检索到的官方公开资料表述,未核实的下载状态不作保证。
常见问题
Hiddify 需要订阅吗?
需要配置或订阅才能连接到具体服务器。Hiddify 是客户端,不会自动提供节点;你需要从服务提供方、面板管理员或自己的服务器获得订阅链接或单个配置。
Hiddify 和 Hiddify Next 是两个软件吗?
当前官方安装文档把 Hiddify Next 说明为旧名称,Windows 的 Hiddify.Next 安装命令仍用于安装当前 Hiddify App。下载时应以当前官方教程和发布页显示为准。
订阅链接导入失败怎么办?
先确认是否复制完整、是否以 https:// 开头,再分别尝试 Clipboard、Manually 或 Scan QR。若仍提示 Invalid URL 或 Failed to add profile,应向链接提供方确认地址是否有效。
Hiddify 显示已连接但网页打不开,问题一定在节点吗?
不一定。先确认使用的是 VPN、System proxy 还是仅 Proxy 模式,再关闭其他代理工具,分别测试浏览器和目标应用;单个应用失败不等于所有节点失效。
Hiddify 的 TUN 或 VPN 模式要不要一开始就打开?
不建议为了“更强”而一开始修改高级设置。先用默认模式完成导入和基础验证,只有在应用不读取系统代理或确实需要接管设备流量时,再按系统权限启用 VPN 类模式。
相关阅读
参考资料
- Hiddify 官方应用教程总页(hiddify.com)
- Hiddify 官方安装文档(hiddify.com)
- Hiddify 官方使用与连接文档(hiddify.com)
- Hiddify App 官方中文 README
- github.com