Hey 入门教程
从构建到连接的四步

下载与安装

Hey 是面向 HarmonyOS NEXT 的原生网络隧道与协议调试客户端，项目以 GNU GPL-3.0 开源，仓库不提供预编译安装包。请从官方 GitHub 仓库获取源码，然后在本地构建并签名。

• 将 build-profile.example.json5 复制为 build-profile.json5，并在 DevEco Studio 中配置调试或发布签名。
• 使用 ./scripts/device_vpn_smoke_test.sh build 构建签名 HAP。
• 构建产物位于 entry/build/default/outputs/default/entry-default-signed.hap。
• 构建配置的 target SDK 为 6.0.1(21)，compatible SDK 为 5.1.1(19)；其余环境要求与具体菜单名称以官方文档为准。

查看官方构建与安装说明

导入订阅或配置

在应用中导入已有的订阅或配置。导入入口包括订阅 URL、v2rayN 文本、Xray JSON、Clash 风格 YAML、WireGuard 配置文件和二维码。

• 应用还支持通过 hey:// 深链、系统分享文本和二维码扫描导入外部内容，并要求明确确认后才生效。
• Xray 是仓库当前的主运行路径，支持 VPN 模式和仅代理模式；sing-box 已随包并可在设置中选择，但应用集成范围比 Xray 窄。
• sing-box 路径目前支持 VPN 模式下的单个转换后 outbound；sing-box 转换器接受 VLESS、VMess、Trojan、Shadowsocks、AnyTLS 和 TUIC。
• 具体菜单与按钮名称以官方文档为准。

发起连接

选定配置并启动连接。Xray 路径会根据选定配置生成运行时配置，并启动或停止 HarmonyOS VPN Extension。

• 项目采用 HarmonyOS Stage 模型，并包含 VPN Extension Ability。
• 选择 VPN 模式或仅代理模式的入口与名称以官方文档为准。
• 仓库提供服务器列表、节点详情编辑、订阅、路由、日志、扫描、备份、导出等页面，可在其中查看与调整已有条目。

检查是否生效

确认连接状态与运行日志，必要时回到前面的步骤调整配置。

• 仓库提供的日志页面可用于查看运行信息，具体名称与筛选方式以官方文档为准。
• 已知限制：需要更多 HarmonyOS NEXT 真机覆盖，部分模拟器或系统镜像缺少 VPN 授权组件；如遇此类情况，请改用真机并参考官方文档。
• 应用提供服务卡片、WorkScheduler、ScanKit 二维码扫描和桌面快捷方式，可辅助查看与触发状态，具体行为