Hey Hey

Hey 为 HarmonyOS NEXT
打造网络隧道与协议调试客户端

原生 ArkTS 编写,集成 Xray 与 sing-box,支持订阅导入、二维码扫描、VPN 与仅代理模式。下载、配置、使用,从这里开始。

支持的设备

Hey 面向 HarmonyOS NEXT 原生环境。已核实平台如下,更多详情

HarmonyOS NEXT 真机
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,只需几步。完整指南见入门教程页。

1

准备构建环境

根据仓库说明准备 HarmonyOS NEXT 构建与签名环境,运行构建脚本生成 HAP。

2

导入或配置节点

支持订阅 URL、二维码、v2rayN 文本等,应用会要求明确确认后导入。

3

选择运行内核

在设置中选择 Xray 或 sing-box。Xray 是主运行路径,支持 VPN 与仅代理模式。

4

启动连接

根据需要生成运行时配置并启动 HarmonyOS VPN Extension,开始使用网络隧道。

常见问题

了解使用中的常见疑问,详见帮助页。

Hey 是否提供预编译安装包?不提供,使用者需要自行构建并签名。
sing-box 支持哪些协议转换?转换器接受 VLESS、VMess、Trojan、Shadowsocks、AnyTLS 和 TUIC。
已知限制有哪些?需要更多 HarmonyOS NEXT 真机覆盖,部分模拟器或系统镜像缺少 VPN 授权组件。

文章

精选使用与配置笔记。

理解 Xray 运行路径

Hey 如何生成运行时配置并控制 VPN Extension。

sing-box 集成范围

目前支持的功能边界与转换器说明。

从构建到签名

一步步完成 HAP 构建与真机部署。

机场推荐

适合 Hey 的网络服务选择参考,详见机场推荐页。

查看机场推荐

开始使用 Hey

下载构建,导入配置,在 HarmonyOS NEXT 上体验原生网络隧道客户端。