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 并保存。菜单语言可能不同，可按功能识别。
- 导入后确认配置出现在列表中，再选择它作为当前配置。多个订阅分别命名，避免更新或切换时弄错来源。
- 检查节点数量、更新时间以及应用显示的订阅信息；缺少到期日或流量信息时，可能是来源没有提供对应字段。
Hiddify 支持 sing-box、V2Ray、Clash 等配置形式，但格式能被解析不代表每一条自定义规则都完全等价。单节点与完整订阅也有区别：单节点导入不会自动取得后续节点更新。具体操作见 官方使用指南。
连接、选择节点，再按需启用 TUN
选择配置后使用主页连接按钮。官方指南描述了按测试延迟自动选择节点的方式，也可以进入代理列表手动选择。初次排查建议固定一个节点：这样重复请求时更容易比较结果，避免自动切换让错误原因混在一起。
手机连接通过系统 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。
Hiddify 支持 Clash 配置，是否可以直接照搬所有规则？
支持格式导入不代表所有自定义规则和扩展参数行为完全相同。迁移后检查局域网、应直连目标和应代理目标的实际路径；特殊规则应结合当前版本的解析日志确认。
为什么订阅卡片没有显示剩余流量或到期时间？
这类信息需要订阅来源提供相应字段。缺失显示并不能单独证明订阅过期，先检查节点是否导入成功、更新时间与来源账户信息。
自动选择低延迟节点，是否就一定能访问目标网站？
自动选择依据测试结果，目标网站可能有不同的路由、协议或访问条件。排查时固定节点，执行真实请求并查看日志，比只比较延迟值更有意义。
Windows ARM 或 Linux ARM 可以直接用当前 x64 安装包吗？
先核对官方 Assets 和设备支持情况。当前稳定发布页的 Windows/Linux 桌面包标记为 x64，不能据此推断存在原生 ARM 包或保证兼容层可用。
官方来源与核对
本文依据以下官方项目与文档整理，资料核对日期为 2026.10.02。安装包、界面和配置字段会随版本变化，可通过原始资料确认当前要求。