Hey 为 HarmonyOS NEXT
打造网络隧道与协议调试客户端
原生 ArkTS 编写,集成 Xray 与 sing-box,支持订阅导入、二维码扫描、VPN 与仅代理模式。下载、配置、使用,从这里开始。
支持的设备
Hey 面向 HarmonyOS NEXT 原生环境。已核实平台如下,更多详情
它能做什么
集成 Xray 与 sing-box,提供协议调试与网络隧道能力。
VPN 与仅代理模式
Xray 路径支持 VPN 模式和仅代理模式;sing-box 路径支持 VPN 模式下单个转换后 outbound。
多协议导入
支持订阅 URL、v2rayN 文本、Xray JSON、Clash 风格 YAML、WireGuard 配置文件和二维码扫描。
深链与分享
通过 hey:// 深链接、系统分享文本和二维码导入,并在明确确认后生效。
节点与路由
仓库提供服务器列表、节点详情编辑、订阅、路由、日志、扫描、备份、导出等页面。
原生 ArkTS 构建
项目采用 HarmonyOS Stage 模型并包含 VPN Extension Ability,使用 N-API 桥接传输内核。
开源与自构建
仓库以 GNU GPL-3.0 开源,需自行构建签名;构建脚本为 ./scripts/device_vpn_smoke_test.sh build。
快速上手
设置 Hey,只需几步。完整指南见入门教程页。
准备构建环境
根据仓库说明准备 HarmonyOS NEXT 构建与签名环境,运行构建脚本生成 HAP。
导入或配置节点
支持订阅 URL、二维码、v2rayN 文本等,应用会要求明确确认后导入。
选择运行内核
在设置中选择 Xray 或 sing-box。Xray 是主运行路径,支持 VPN 与仅代理模式。
启动连接
根据需要生成运行时配置并启动 HarmonyOS VPN Extension,开始使用网络隧道。
常见问题
了解使用中的常见疑问,详见帮助页。
文章
精选使用与配置笔记。
理解 Xray 运行路径
Hey 如何生成运行时配置并控制 VPN Extension。
sing-box 集成范围
目前支持的功能边界与转换器说明。
从构建到签名
一步步完成 HAP 构建与真机部署。
机场推荐
适合 Hey 的网络服务选择参考,详见机场推荐页。
开始使用 Hey
下载构建,导入配置,在 HarmonyOS NEXT 上体验原生网络隧道客户端。