v2rayH 0.3.0

v2rayH 0.3.0

双内核：sing-box 加入（重点）

• 引入 sing-box v1.14.4 内核，与 Xray 合并进同一个 libxray.a，
  单 App、单一 Go runtime，安装包结构不变

• 链式架构：Xray 永远接管 tun 与路由；
  hy2 / tuic 等协议由 sing-box 经本机 socks 链式转发承载：

  tun ──► Xray ──► socks(127.0.0.1:10810) ──► sing-box ──► Hysteria2/TUIC ──► 互联网
  

• Xray 系节点（vless / vmess / trojan / ss）路径完全不变，零回归

新协议

• Hysteria2（hy2:// 与 hysteria2:// 分享链接解析与分享）：
  支持 sni / insecure / salamander 混淆 / alpn / 端口跳跃（mport）
• TUIC（tuic://）：uuid+password、sni、alpn，拥塞控制 bbr

内核自选

• 每节点可在「编辑节点」中选择运行内核：自动 / Xray / sing-box
  （hy2、tuic 始终由 sing-box 承载，其余协议可手动指定）
• 节点列表与配置页为 sing-box 系节点显示 SB 徽标
• 设置页「关于」显示双内核版本（Xray v1.261029.0 / sing-box v1.14.4）

测速与故障转移

• sing-box 系节点延迟测试走完整链式 HTTP 往返（UDP 端口 TCP ping 无意义），
  Xray 系节点保持 TCP Ping 并行
• 下载测速、故障转移探活同步适配双内核链路

下载与备份体验

• 资源文件与订阅更新默认走代理下载：VPN 已连接时，
  geosite / geoip 更新与订阅拉取经本机代理（127.0.0.1:10809）发出，
  境外资源不再直连超时；未连接时提示后直连
• 备份还原、本地快照还原、清空节点等危险操作增加确认弹窗，
  完成后以气泡提示结果
• 修复旧版本（0.2.x）持久化数据在编辑节点时可能闪退的问题

许可证

• 项目以 GPL-3.0 发布（随本版本加入 LICENSE），
  与 Xray-core、sing-box 内核许可证保持一致

安装包为未签名 HAP，用「小白调试助手」或 DevEco Studio 自行签名安装，
见 README「安装」一节。系统要求 HarmonyOS 6.1 及以上。

v2rayH 0.2.5

v2rayH 0.2.5

内核

• Xray 内核升级至 v26.10.29（含 v26.10.21 起的根证书安全修复）
• 移除 gVisor：新版内核自带轻量用户态 TCP/IP 栈，体积更小、路径更短

下载测速（重点修复）

• 修复测速结果只有真实带宽约五分之一的问题：改用 Speedtest 方法论 ——
  4 并发连接 + 预热段排除 TCP 慢启动 + 20 秒稳态计时段
• 测试数据量提升至每节点最多 100MB，点击时弹窗确认并提示流量消耗
• 支持多选 / 全部分组节点批量测速，逐个节点测试并显示进度
• 测速完成后可选择「按速率从高到低」排序节点

延迟测速

• TCP Ping 延迟测速，测速完成后可选择「按延迟从低到高」排序节点
• 节点列表同时展示延迟与速率：延迟在上、速率在下

其他

• 节点测速面板默认折叠，点击展开后才显示测速按钮与多选圈
• 故障转移：当前节点不可达时自动切换到下一个节点
• 分应用代理：全部应用 / 仅代理选中 / 排除选中
• 多选节点批量测速与操作；扫码 / 剪贴板 / 手动添加节点；节点分享

安装包为未签名 HAP，用「小白调试助手」或 DevEco Studio 自行签名安装，
见 README「安装」一节。系统要求 HarmonyOS 6.1 及以上。

v2rayH 0.2.2

安装

Release 里的 HAP 未签名，无法直接安装。签名绑定开发者证书和设备，所以按社区惯例
（ClashBox 同样）只发未签名包，由使用者自行签名。

1. 用你自己的证书给 v2rayH-0.2.2-unsigned.hap 签名
   （DevEco Studio 的「自动生成签名」，或用 hap-sign-tool）。
2. 安装：hdc install v2rayH-0.2.2-signed.hap
3. 首次连接时在系统弹窗里授予 VPN 权限。

校验下载：

sha256sum -c v2rayH-0.2.2.sha256

这个版本改了什么

最低系统要求提升至 HarmonyOS 6.1

• compatibleSdkVersion 升到 6.1.0(23)，需要 HarmonyOS 6.1 及以上

底部页签沉浸光感

• 底部导航改用 HdsTabs 悬浮样式，通过 barFloatingStyle.systemMaterialEffect
  开启沉浸光感材质（ADAPTIVE 类型 + ADAPTIVE 等级，随设备算力自适应）
• 移除旧的整条底栏背景色 + 毛玻璃实现，避免遮挡材质效果

订阅分组更新

• 新增按分组拉取订阅（updateGroupSubscription），每组独立更新并显示状态
• 首页节点计数旁新增刷新按钮，点击更新当前分组
• 更新失败时给出具体原因（订阅链接为空 / 拉取失败 / 解析失败）

剪贴板导入

• 导入前动态申请 ohos.permission.READ_PASTEBOARD 权限（含权限说明文案）
• 读取剪贴板的各类失败场景（空剪贴板 / 非文本 / 读取异常）均有明确提示

已知限制

• 分应用代理未实现：鸿蒙不支持三方应用枚举已安装应用，也没有系统级应用选择器
• 沉浸光感材质依赖设备算力，低端设备由系统自动降级显示
• 上架 AppGallery 需要 release 证书签名，本包用的是本地调试签名

Full Changelog: v0.2.1...v0.2.2

v2rayH 0.2.1

安装

Release 里的 HAP 未签名，无法直接安装。签名绑定开发者证书和设备，所以按社区惯例
（ClashBox 同样）只发未签名包，由使用者自行签名。

1. 用你自己的证书给 v2rayH-0.2.1-unsigned.hap 签名
   （DevEco Studio 的「自动生成签名」，或用 hap-sign-tool）。
2. 安装：hdc install v2rayH-0.2.1-signed.hap
3. 首次连接时在系统弹窗里授予 VPN 权限。

校验下载：

sha256sum -c v2rayH-0.2.1.sha256

这个版本改了什么

鸿蒙 6.0+ 兼容

• compatibleSdkVersion 降到 6.0.0(20)，HarmonyOS 6.0 及以上可安装
• 移除 API 26 专属的沉浸光感 tabBar 与 Circle.fill，改用 6.0 可用的实现
• protectProcessNet（API 22+）在 6.0 上自动跳过，仍通过 blockedApplications 防止路由回环

首页测速

• 新增「节点测速」卡片：延迟测速（全部节点）+ 下载测速（当前选中节点）
• 下载测速默认使用 Cloudflare 20MB HTTP 测速文件，失败回退 CacheFly 10MB
• 结果同时显示 Mbps 与 MB/s；测速通过临时 Xray 实例走当前节点，不影响已建立的 VPN

CI / 发布

• GitHub Actions 使用 devecocli + 华为 Command Line Tools 直接构建未签名 HAP
• CLT 超过 2GB 时支持分卷上传，workflow 自动合并
• 原生代码变化时默认从源码重建 libxray，确保下载测速接口与 App 一致

已知限制

• 分应用代理未实现：鸿蒙不支持三方应用枚举已安装应用，也没有系统级应用选择器
• 下载测速每次消耗约 20MB 流量；慢速节点会在超时后给出部分结果
• 内核版本 v1.260327.0 在编译期写入，升级 libxray 时需同步
• 上架 AppGallery 需要 release 证书签名，本包用的是本地调试签名

Full Changelog: v0.2.0...v0.2.1

Command Line Tools 26.0.0

HarmonyOS Command Line Tools for CI. Split into <2 GB parts; build-hap.yml reassembles them.

v2rayH 0.2.0

安装

Release 里的 HAP 未签名，无法直接安装。签名绑定开发者证书和设备，所以按社区惯例
（ClashBox 同样）只发未签名包，由使用者自行签名。

1. 用你自己的证书给 v2rayH-0.2.0-unsigned.hap 签名
   （DevEco Studio 的「自动生成签名」，或用 hap-sign-tool）。
   也可以直接使用小白调试助手安装。
2. 安装：hdc install v2rayH-0.2.0-signed.hap
3. 首次连接时在系统弹窗里授予 VPN 权限。

校验下载：

sha256sum -c v2rayH-0.2.0.sha256

这个版本改了什么

界面重整为三个页签（主页 / 配置 / 设置），底部是沉浸光感的悬浮导航。

主页

• 上部订阅节点列表，可下拉切换订阅分组，选中节点后点底部按钮连接
• 右上角状态胶囊下显示代理出口 IP（连接后自动获取）
• 已连接时点另一个节点会直接热切换并重新取 IP，不用手动断开

配置

• 订阅分组：新建 / 切换 / 删除，分组独立保存，更新订阅只覆盖当前分组
• 订阅入口：扫码导入、剪贴板导入、手动添加（VLESS / VMess / Trojan / Shadowsocks，
  可选 TCP / WebSocket / gRPC，TLS / REALITY）
• 本机导入的节点统一进入「本机节点」分组，不会被更新订阅冲掉
• 路由设置：CN 直连、广告拦截、自定义直连域名与强制代理域名
• 资源文件：常见 geo 来源一键切换、剪贴板粘贴直链、本地 .dat 导入，
  资源列表显示文件名 / 大小 / 更新时间，带「立即更新」

设置

• 外观：深色模式（跟随系统 / 浅色 / 深色）+ 五种主题色，即时生效
• 备份与还原：导出 / 导入 JSON，另有本地快照可还原
• 关于：应用版本、libxray 内核与 xray-core 版本

优化

• 去掉后台常驻长任务，退到后台后由系统正常冻结 UI 进程（VPN 扩展照常工作）
• 关闭 Xray 访问日志、日志级别降到 error，减少空闲期写盘

已知限制

• 分应用代理未实现：鸿蒙不支持三方应用枚举已安装应用，也没有系统级应用选择器
• 内核版本 v1.260327.0 在编译期写入，升级 libxray 时需同步
• 上架 AppGallery 需要 release 证书签名，本包用的是本地调试签名

Full Changelog: v0.1.0...v0.2.0

v2rayH 0.1.0

安装

Release 里的 HAP 未签名，无法直接安装。签名绑定开发者证书和设备，所以按社区惯例
（ClashBox 同样）只发未签名包，由使用者自行签名。

1. 用你自己的证书给 v2rayH-0.1.0-unsigned.hap 签名
   （DevEco Studio 的「自动生成签名」，或用 hap-sign-tool）。
2. 安装：hdc install v2rayH-0.1.0-signed.hap
3. 首次连接时在系统弹窗里授予 VPN 权限。

校验下载：

sha256sum -c v2rayH-0.1.0.sha256

这个包是什么

HarmonyOS / OpenHarmony 上的 VLESS / VMess / Trojan / Shadowsocks 客户端，内核是
Xray-core。流量路径：

应用 ──► vpn-tun (VpnExtensionAbility) ──► gVisor netstack (L3→L4)
     ──► Xray VLESS+REALITY 出站 ──► 外网

已支持：订阅解析、服务器列表、真实延迟测试、geoip/geosite 分流（cn 直连、其余走代理）。

Full Changelog: https://github.com/JuckyLee668/v2rayH/commits/v0.1.0