Android
iOS
Windows
Linux下载 Hiddify App 客户端
从 Hiddify App 官方项目 进入下载渠道。Hiddify 还维护服务器管理项目，本文讲的是安装在个人设备上的客户端。Android 和桌面包见 稳定版 Releases，iPhone/iPad 从项目链接进入 App Store。
| 设备 | 安装选择 |
|---|---|
| Android | 按架构选择 APK；不能确认时查看当前是否提供 universal 包。 |
| iPhone / iPad | App Store；当前商店页要求 iOS/iPadOS 15.0 及以上。 |
| Windows | 安装版 EXE、便携 ZIP 或 MSIX；当前稳定页提供 x64 包。 |
| macOS | 桌面 DMG 或 PKG，核对该版本的系统要求。 |
| Linux | 当前提供 x64 的 Debian 包与 AppImage；核对发行版依赖。 |
“支持 Windows/Linux”不代表当前发布了每一种 CPU 架构。桌面 ARM 用户先检查 Assets，商店版与 GitHub 桌面版的兼容要求也应分别阅读。
安装与系统授权
- 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、二维码和导出文件当作敏感资料保管。迁移到新设备时先导入一份配置，确认系统授权与实际请求都成功，再导入其余配置。手机与桌面版的更新节奏、权限和功能可能不同，不必要求版本号完全一致。
按原官方渠道更新，阅读发布说明后重复节点、真实目标和网络恢复检查。发现升级问题时保留版本号和脱敏日志，区分客户端变化与订阅同步更新；更多分层检查见 首页故障排查。
常见问题
Hiddify 和 Hiddify Manager 应该下载哪个？
个人手机或电脑连接已有配置，使用 Hiddify App 客户端。Hiddify Manager 用于服务器端管理；下载客户端并不需要先在个人电脑上安装 Manager。
为什么订阅卡片没有显示剩余流量或到期时间？
这类信息需要订阅来源提供相应字段。缺失显示并不能单独证明订阅过期，先检查节点是否导入成功、更新时间与来源账户信息。
Windows ARM 或 Linux ARM 可以直接用当前 x64 安装包吗？
先核对官方 Assets 和设备支持情况。当前稳定发布页的 Windows/Linux 桌面包标记为 x64，不能据此推断存在原生 ARM 包或保证兼容层可用。
参考资料
下载、系统要求和配置字段以对应版本的官方说明为准。文中的流程图由 AFQKit 绘制。