Hiddify GitHub 官方仓库、下载安装与配置导入指南
简答：如果你搜索的是 Hiddify GitHub，普通用户优先看官方组织下的 hiddify-app 仓库，不要把 Hiddify-Manager 当成客户端。当前官方安装文档标注的稳定版本为 v4.1.1，但 GitHub 文件不会自动更新，下载前仍应以官方 Releases 或应用商店页面为准。具体配置链接需要由订阅提供方或服务器管理员提供，本文不提供未经核实的服务入口。
定义：Hiddify App 是基于 sing-box 的多平台客户端，用于导入配置或订阅链接并建立网络连接；Hiddify-Manager 则是用于部署和管理服务端的项目。
先确认：Hiddify GitHub 应该打开哪一个仓库
搜索结果中最容易混淆的是“官方组织页”“客户端仓库”和“服务端管理项目”。Hiddify 官方 GitHub 组织页列出了多个公开仓库，其中普通用户下载客户端时，重点查看 hiddify/hiddify-app；需要自己部署和管理服务端时，才进一步查看组织下的 Hiddify-Manager 项目。
| 项目 | 适合谁 | 主要用途 | 普通用户是否优先下载 |
|---|---|---|---|
hiddify-app | 需要在手机或电脑上使用客户端的人 | 导入配置或订阅链接，建立连接，进行节点和配置管理 | 是 |
Hiddify-Manager | 需要部署服务端或管理多用户配置的人 | 服务端管理、用户配置和协议相关设置 | 否 |
| 官方组织页 | 想核对项目归属的人 | 查看仓库名称、代码、文档、Issue 和 Releases 入口 | 用于核验 |
识别仓库时，先看地址是否为 github.com/hiddify/，再核对仓库名是否为 hiddify-app。仅有相似名称、重新打包或第三方下载页，不能直接视为官方版本。仓库的星标、Fork 数量只能作为页面信息，不能替代来源核验，也不能证明某个配置服务的稳定性。
按设备选择下载方式：商店版、GitHub 文件与系统限制
官方安装文档当前列出的稳定版本是 v4.1.1，并给出了不同系统的要求。文档同时提醒，应用商店版本会自行更新，而从 GitHub 下载的安装文件不会自动更新，因此安装后应定期回到官方仓库或应用商店核对版本。
| 系统 | 官方文档列出的要求 | 优先选择 | 需要注意 |
|---|---|---|---|
| Android | Android 7.0 或更高 | Google Play；无法使用时再考虑 APK | APK 安装前核对来源和文件架构 |
| iPhone / iPad | iOS 15 或更高 | App Store | 商店是否显示可能受 Apple ID 所在地区影响 |
| Windows | Windows 10 1809 或 Windows 11，64 位 | 安装程序、Microsoft Store 或官方列出的替代包 | Windows 7 和 Windows 8 不在官方支持范围内 |
| macOS | macOS 10.15 或更高，支持 Intel 和 Apple Silicon | DMG、PKG 或 App Store | 根据芯片和系统版本选择安装方式 |
| Linux | 64 位 Linux，Debian/Ubuntu 系统支持较好 | AppImage；Debian、Ubuntu、Mint 可考虑 DEB | 官方文档说明 RPM 包已移除，Fedora 等系统使用 AppImage |
如果你要下载 GitHub 文件，建议进入仓库的 Releases 页面或安装文档中的对应文件入口，而不是点击搜索引擎广告、网盘转存包或不明镜像。文件扩展名本身不能证明安全性，下载后还应核对文件名、发布版本和仓库归属。
安装后怎么导入配置：先准备链接，再完成验证闭环
Hiddify App 本身不是订阅服务，也不会凭空生成可用配置。官方安装说明写明，使用前需要已有的配置或订阅链接；官方仓库介绍则列出其可处理的配置格式包括 sing-box、V2Ray、Clash 和 Clash Meta，支持的协议包含 VLESS、VMess、Reality、TUIC、Hysteria、WireGuard、SSH 等，实际能否连接取决于配置内容、网络环境和服务端状态。
- 编辑或准备配置：从你已经确认的订阅来源复制配置链接。不要在公开 Issue、截图或文章中粘贴包含令牌、账号或私密参数的完整链接。
- 打开 Hiddify App：进入配置、Profiles、添加配置或类似入口。不同版本的菜单名称可能变化，可在应用内搜索“添加配置”“导入链接”或“远程配置”。
- 粘贴并保存：使用订阅链接或本地配置文件导入。保存后检查配置名称、更新时间和节点数量是否正常显示。
- 重新载入：手动更新一次配置，等待应用完成拉取。若提示超时，先确认设备能打开配置来源，再检查 DNS、代理模式和网络切换情况。
- 查看日志：连接前打开日志，重点看 DNS 解析失败、TLS 握手失败、超时、认证失败或配置格式错误等关键词。
- 验证业务：先用一个普通网页或办公服务进行测试，再观察延迟、丢包和断线情况。不要只看“已连接”状态，因为隧道建立并不等于所有业务都能正常访问。
如果导入成功但无法连接，先关闭其他代理客户端，避免多个 TUN 或系统代理同时接管；随后切换 Wi-Fi 与移动网络进行对照。若只有某个节点失败，优先更换节点并查看日志；若所有节点都失败，再检查系统时间、DNS、网络权限和订阅是否过期。Hiddify App 的客户端文档不能证明某个服务商的价格、设备数、线路质量或长期稳定性，这些信息应向配置提供方核实。
下载失败、打不开或版本不对时怎么排查
遇到安装包打不开、应用商店搜不到或安装后无法使用，可以按下面顺序缩小范围：
- 先核对平台：Windows 7/8、RPM Linux 等情况不符合当前安装文档列出的支持方式，应更换受支持系统或使用文档列出的替代文件。
- 再核对来源：回到 官方 hiddify-app 仓库或安装文档，不要从名称相近的仓库下载。
- 检查文件类型：Windows 通常选择 EXE、MSIX 或 ZIP；macOS 选择 DMG 或 PKG；Linux 根据发行版选择 AppImage 或 DEB；Android 选择商店版或官方列出的 APK。
- 检查权限：Windows 安装程序可能需要管理员确认；Android 通过 APK 安装时，系统可能要求允许当前来源安装应用；macOS 可能需要在系统安全设置中确认来源。
- 检查网络：如果 GitHub 页面或 Releases 加载失败，可先切换网络、检查 DNS 解析和系统代理状态。不要把“下载失败”直接判断为仓库失效。
- 检查更新方式：商店安装通常由商店管理更新，GitHub 安装包不会自动更新。升级前保留订阅来源和必要配置，升级后重新查看配置、日志和系统代理权限。
当前版本号、发布日期和文件列表属于会变化的信息，发布前应再次打开官方安装文档、仓库 Releases 和应用商店页面核对。本文只能确认检索到的官方资料，不能确认某个第三方下载页、订阅入口或服务状态。
本文的核验边界
本站是第三方使用指南站，不是 Hiddify 官方站点，也不冒充官方下载安装页面。本文只根据公开的 GitHub 组织页、客户端仓库和安装文档整理操作路径；关于具体服务入口、订阅可用性、节点质量、价格和售后，本文未核实，具体信息应以配置提供方或官方页面为准。
常见问题
Hiddify GitHub 的官方客户端仓库是哪一个？
普通用户应优先核对 github.com/hiddify/hiddify-app，也可以先进入 hiddify 官方组织页，再从仓库列表打开 hiddify-app。不要仅凭搜索结果中的相似名称判断归属。
Hiddify App 和 Hiddify-Manager 有什么区别？
Hiddify App 是安装在 Android、iOS、Windows、macOS 或 Linux 上的客户端，用于导入配置并连接；Hiddify-Manager 面向服务端部署和多用户管理。只想在电脑或手机上使用配置时，通常先看 App。
当前 Hiddify App 版本是多少？
本次核对的官方安装文档当前标注稳定版本为 v4.1.1。由于仓库和商店会继续更新，下载前应再次打开官方安装文档或 Releases 页面核对。
Windows 7 或 Windows 8 能安装 Hiddify App 吗？
当前官方安装文档明确列出 Windows 10 版本 1809 或 Windows 11、64 位作为要求，并说明 Windows 7 和 Windows 8 不受支持。不要通过不明修改版安装包绕过系统限制。
没有订阅链接，可以直接使用 Hiddify App 吗？
客户端需要配置或订阅链接才能建立连接。配置应来自你已核实的服务或服务器管理员；不要在公开页面粘贴包含令牌、账号或私密参数的链接。
导入订阅后显示已连接，但业务仍打不开怎么办？
先查看日志，再关闭其他代理客户端，检查 DNS、系统代理、TUN 权限和配置更新时间；随后切换网络或更换节点进行对照。如果所有节点都失败，应向配置提供方核实订阅状态和服务端情况。