下载 Hiddify App 客户端
从 Hiddify App 官方项目 进入下载渠道。Hiddify 还维护服务器管理项目,本文讲的是安装在个人设备上的客户端。Android 和桌面包见 稳定版 Releases,iPhone/iPad 从项目链接进入 App Store。
| 设备 | 安装选择 |
|---|---|
| Android | 按架构选择 APK;不能确认时查看当前是否提供 universal 包。 |
| iPhone / iPad | App Store;当前商店页要求 iOS/iPadOS 15.5 及以上。 |
| Windows | 安装版 EXE、便携 ZIP 或 MSIX;当前稳定页提供 x64 包。 |
| macOS | 桌面 DMG 或 PKG,核对该版本的系统要求。 |
| Linux | 当前提供 x64 的 Debian 包与 AppImage;核对发行版依赖。 |
“支持 Windows/Linux”不代表当前发布了每一种 CPU 架构。桌面 ARM 用户先检查 Assets,商店版与 GitHub 桌面版的兼容要求也应分别阅读。
2026 年 11 月 5 日核查,GitHub 正式版为 5.5.5。Assets 提供 Android arm64、arm7、x86_64 和 universal APK,Windows x64 EXE、MSIX 与便携 ZIP,macOS DMG/PKG,以及 Linux x64 DEB/AppImage。本次也有带 AppStore 标记的 macOS 文件,选择渠道前先看对应安装说明,不能只按扩展名互换。
2026 年 11 月 6 日,美国区 iPhone/iPad App Store 已从 4.0 更新为 5.5.5,最低要求为 iOS/iPadOS 15.5。其他地区的可用版本以当地商店为准;GitHub 与商店仍是不同发布渠道,版本号相同不代表每个平台的功能与安装要求完全一致。GitHub 列出的 IPA 被发布说明标注为越狱渠道,不是普通 iPhone 用户的 App Store 更新入口;日常安装继续使用官方商店。
安装与系统授权
- Android 安装官方 APK;iOS 使用 Hiddify 官方 App Store 入口。首次连接时确认系统 VPN 授权,不要把安装成功当作授权完成。
- Windows 运行安装程序,便携版则完整解压;macOS 按 DMG/PKG 的安装流程完成,不从压缩包临时位置长期运行。
- Linux 的 DEB 通过包管理器安装,AppImage 下载后赋予执行权限。启动报依赖错误时根据实际报错和发行版处理。
- 首次启动选择语言和区域,查看应用提供的隐私与统计选项,然后确认主界面能够正常打开。
官方安装教程 提供了各平台流程。教程中的旧文件名可能与新版本不同,以已下载文件为准;不需要为了普通安装自行编译项目。
添加订阅或单节点链接
远程订阅 URL
- 复制你已有的订阅 URL,打开主页的添加配置入口。
- 使用“从剪贴板添加”,或选择手动添加,为配置填写名称与 URL 并保存。菜单语言可能不同,可按功能识别。
- 导入后确认配置出现在列表中,再选择它作为当前配置。多个订阅分别命名,避免更新或切换时弄错来源。
- 检查节点数量、更新时间以及应用显示的订阅信息;缺少到期日或流量信息时,可能是来源没有提供对应字段。
单节点分享链接
复制完整的 vless://、vmess:// 等已有分享链接,打开首页的“+”添加入口,选择“从剪贴板添加”(Add from clipboard)。导入后选择该配置并验证连接;不要把这类分享链接填成需要下载配置的远程订阅 URL。单节点导入不会自动取得来源的后续节点更新。
Hiddify 支持 sing-box、V2Ray、Clash 等配置形式,但格式能被解析不代表每一条自定义规则都完全等价。具体操作见 官方使用指南。
连接和手动选择节点
选择刚导入的配置,点击主页连接按钮。排查时先手动固定一个节点,再重复同一请求;确认可用后,可按需要启用自动选择。
手机连接通过系统 VPN 机制工作;如果另一个 VPN 正在运行,先确认当前活动连接。桌面则核对自己选择的代理接管方式。需要 TUN 时,按当前版本的权限提示操作;Windows 官方教程要求在管理员权限下开启,普通权限启动的进程需要先完全退出再重新启动。
区域选项、DNS 和分流配置会影响访问路径。迁移已有 Clash 配置后,至少检查局域网、直连目标和代理目标的实际行为。不要一开始同时修改 DNS、分流、TUN 与节点,出现问题时会失去可比较的基线。
检查目标应用与网络切换
- 确认主页显示连接状态,再进入节点列表做延迟测试,记下实际使用的节点。
- 打开目标网站,同时查看日志中的域名、路由或错误。需要登录、下载或播放的应用应分别操作,网页首页成功不能代表全部功能可用。
- 桌面如果启用了本地代理入口,读取实际端口,用 首页验证命令 生成显式请求;未启用本地入口时,不拿别人的端口照抄。
- 手机分别在 Wi-Fi 与移动网络上测试,并检查锁屏后连接是否持续;切换网络后重新做一次真实请求。
自动选择依据是测试结果,不能保证任何服务都可用。DNS 查询失败、节点握手失败与网站返回 HTTP 错误属于不同阶段,记录原始错误能更快决定应改解析、节点还是目标应用设置。
导入、兼容和连接问题
- 剪贴板添加无反应:改用手动输入完整 URL,确认剪贴板内容没有被替换,并检查地址是否指向配置而非网页登录页。
- 导入成功但无节点:检查来源返回的配置格式、当前选中的配置和解析日志;不要只根据文件扩展名判断内容。
- 有延迟但网站失败:固定节点后重试,查看 DNS、规则匹配与握手错误;跨格式迁移时尤其要复查自定义路由。
- TUN 无法启动:检查授权、服务状态与其他 VPN 的冲突,先恢复此前能工作的接管方式。
- 手机后台断开:先检查系统 VPN 状态与电池限制,再检查网络切换和节点日志。
URL scheme 一键导入受浏览器和系统关联影响。按钮未唤起应用时,可以使用剪贴板或手动导入,规则格式参见 官方 URL scheme 说明。
更新与设备迁移
迁移前保存原始配置、订阅地址和自定义设置。截图适合记住菜单选项,但不能重建完整配置;本地导入的文件要另留副本。
把订阅 URL、二维码和导出文件当作敏感资料保管。迁移到新设备时先导入一份配置,确认系统授权与实际请求都成功,再导入其余配置。手机与桌面版的更新节奏、权限和功能可能不同,不必要求版本号完全一致。
按原官方渠道更新,阅读发布说明后重复节点、真实目标和网络恢复检查。发现升级问题时保留版本号和脱敏日志,区分客户端变化与订阅同步更新;更多分层检查见 首页故障排查。
从 4.x 迁移到 5.5 系列
5.5.5 发行页沿用了“5.5.0”系列介绍,列出新版主页与节点列表、节点失败原因、内置更新和新的 macOS VPN 系统扩展。这里将它们作为该系列的官方迁移提示,不声称全部是 5.5.5 首次新增,也不把官方性能描述当作本站实测。
iPhone/iPad 的 5.5.5 商店说明也列出主页、节点列表及连接状态展示调整。更新前先确认系统达到 iOS/iPadOS 15.5,并保留配置副本;从 App Store 更新后,先用原配置核对 VPN 授权、连接状态和实际访问,不将桌面端系统扩展步骤套到手机。
- 升级前另存原始配置文件和订阅地址,记录路由、DNS、接管方式及当前版本,保留原官方安装渠道。
- 通过应用提供的更新入口或同一官方渠道升级;先不要同时更新订阅、切换节点策略或启用新增功能。新主页布局与旧版截图不同,按配置、连接状态和节点详情等功能识别入口。
- 先用一份已有配置、一个固定节点测试直连与代理目标,再查看节点详情中的失败原因。列表测速结果不等于目标应用可用,也不代表订阅套餐速度保证。
- macOS 若提示新的 VPN 系统扩展授权,核对来源与官方安装说明,再完成该组件所需授权;不要通过关闭系统安全校验来消除安装提示。授权后验证实际请求,不只看界面连接标识。
- 出现回归时先停止本次接管并恢复原代理设置,保存脱敏日志;需要回退时按官方兼容说明使用原渠道安装包和升级前副本,不假定旧版能读取新版生成的数据。
发行页提到内核调整,但没有给出可直接当作独立 sing-box 正式版的版本号;不要将本站 sing-box 工具页版本套给 Hiddify。以上步骤未宣称在各平台安装实测。
常见问题
Hiddify 和 Hiddify Manager 应该下载哪个?
个人手机或电脑连接已有配置,使用 Hiddify App 客户端。Hiddify Manager 用于服务器端管理;下载客户端并不需要先在个人电脑上安装 Manager。
为什么订阅卡片没有显示剩余流量或到期时间?
这类信息需要订阅来源提供相应字段。缺失显示并不能单独证明订阅过期,先检查节点是否导入成功、更新时间与来源账户信息。
Windows ARM 或 Linux ARM 可以直接用当前 x64 安装包吗?
先核对官方 Assets 和设备支持情况。当前稳定发布页的 Windows/Linux 桌面包标记为 x64,不能据此推断存在原生 ARM 包或保证兼容层可用。
参考资料
下载、系统要求和配置字段以对应版本的官方说明为准。文中的流程图由 AFQKit 绘制。