Skip to content

Releases: htoay/Bettbox

Release list

ohos-v1.19.5

Choose a tag to compare

@htoay htoay released this 15 Oct 19:59

Bettbox for HarmonyOS NEXT v1.19.5(非官方移植版)

基于上游 appshubcc/Bettbox v1.19.5(111c5d91)的鸿蒙移植发行版。
本分支只维护鸿蒙端适配;与上游作者、华为及任何服务提供商无关联、无背书(见 DISCLAIMER)。
对应本仓提交:1157ac6e。

适用环境:HarmonyOS NEXT / OpenHarmony,arm64-v8a,设备类型 phone / tablet / 2in1。


⬇️ 下载

文件 大小 说明
bettbox-1.19.5-ohos-vc2026101301-unsigned.hap 56.3 MiB 未签名 HAP,arm64-v8a
bettbox-1.19.5-ohos-vc2026101301-unsigned.hap.sha256 112 B 上面文件的 SHA-256
版本:versionName 1.19.5 / versionCode 2026101301 / bundleName com.appshub.bettbox
SHA-256:9322b52f5e512838fefb36f956f7782f6c982f156ae73c31e9c8d62699c9e731
校验:  sha256sum -c bettbox-1.19.5-ohos-vc2026101301-unsigned.hap.sha256

请用你自己的证书/Profile 签名后安装(步骤见文末)。


鸿蒙端功能一览

🆕 = 相对上一版 ohos-v1.19.4 新增或本次才可用

代理与网络

  • VPN(TUN)模式启动/停止;混合端口提供 HTTP / SOCKS5 代理;规则 / 全局 / 直连三种模式。
  • 局域网连接(allow-lan):同一局域网内的其它设备可经本机代理上网。
  • 设备 DNS 下推:把物理网络的真实 DNS 下发给核心,避免回退到内置公共 DNS 造成解析污染。
  • 系统级 DNS 覆写开关:鸿蒙不开放系统 DNS 接口,按 vNIC DNS 语义生效(见「已知限制」)。
  • 🆕 「网络变化时清空 DNS 缓存」开关:切换 Wi-Fi / 移动网络后,不再出现已缓存域名仍指向
    旧网络、短时间内打不开的情况。
  • 🆕 MTU 取值范围与鸿蒙 VPN 对齐(576–1500,预设 1500/1400),设置值与实际生效值一致。
  • 正式(release)构建下,VPN 扩展进程与主进程通过抽象命名空间 socket 交接 TUN fd,
    release 包与 debug 包同样可用。

后台与保活

  • 长时任务保活,可选模式:数据传输 / 音频播放 / 计算任务(设置项与系统通知文案一致)。
  • 取消自愈:长时任务被系统取消后秒级重申请,并有 30s 看门狗兜底,后台长时间运行不被冻结。

交互与功能

  • 🆕 深链 clash://install-config?url=…:从浏览器或二维码一键导入订阅。
  • 🆕 脚本覆写(Script)随包可用:由 Rust 引擎(rquickjs)执行;上一版因缺少 JS 引擎库,
    该功能不可用。
  • 🆕 仪表盘「更多 IP 信息」:网络类型、内网 IP、默认网关、系统 DNS。
  • 订阅 / 配置 / 规则 / 代理组 / 连接 / 日志 / 备份与恢复等全部界面功能可用。

界面与显示

  • 🆕 应用图标为上游正式图标(含启动页图标),桌面名称显示为 Bettbox。
  • 弹窗与对话框、页面生命周期渲染正常(打开即用,不会黑屏/卡死)。
  • 🆕 中文与英文混排、数字与空格的字距正常,不再出现被系统 emoji 字体接管导致的异常字距。

打包

  • 仅打包 arm64-v8a(不含模拟器用的 x86_64 库)。

本次更新(相对 ohos-v1.19.4)

同步上游 v1.19.5

  • UI 层迁移到官方拆分包 material_ui / cupertino_ui,鸿蒙端做了对应适配。
  • 依赖升级:riverpod 3.4、freezed 4、flutter_rust_bridge 2.13。
  • 脚本引擎换代:由 flutter_qjs 改为 Rust 实现(rquickjs),脚本覆写功能随之可用。

新增(即上节标 🆕 的条目)

  • 深链 clash://install-config?url=… 一键导入订阅。
  • 仪表盘「更多 IP 信息」:网络类型 / 内网 IP / 默认网关 / 系统 DNS。
  • 「网络变化时清空 DNS 缓存」开关。
  • MTU 取值范围与鸿蒙 VPN 对齐(576–1500,预设 1500/1400)。
  • 上游正式应用图标(含启动页图标),应用名称改为 Bettbox。
  • 脚本覆写功能随包可用。

修复

  • 正式包右上角不再出现 PRE 角标,同时恢复更新检查 —— 此前正式包不会提示新版本。
  • 中英混排字距恢复正常:此前数字与空格会被系统 emoji 字体接管,显示成字距异常的文字。

优化

  • 安装包体积 61.7 → 56.3 MiB(地理数据库改为压缩随包,首次启动时自动解压)。
  • 仪表盘「活跃连接」的刷新开销降低,长时间停留在首页更省电。

已知限制

  • 按应用分流暂不可用:PROCESS-NAME / PROCESS-PATH 规则在鸿蒙上不会命中,
    连接列表也不显示应用名与图标。
  • 系统 HTTP 代理:鸿蒙未提供对应系统能力,「系统代理 / 绕过域名」两项在鸿蒙端已隐藏;
    需要走代理的程序请手动指向 127.0.0.1:<混合端口>。
  • 常驻通知速率、桌面快捷方式、电池优化白名单:鸿蒙无对应能力,相关入口保持隐藏。
  • 智能停机在鸿蒙上为整机停止/启动(功能可用,但恢复时需重新建立 VPN)。
  • 低版本系统上,部分依赖较新 API 的能力(防回环保护、PC 状态栏托盘等)可能不可用。

安装(未签名包需自行签名)

  1. 准备签名材料:用 DevEco Studio 的自动签名(需登录华为开发者账号并把你的设备 UDID 加入调试证书),
    或自行申请证书与 Profile。

  2. 签名:用 DevEco Studio 打开工程 → Build > Generate Signed HAP/APP,选中下载的 HAP;
    或用你自己的签名工具(hapsigner 等)签名。

  3. 安装:

    hdc install -r <已签名的>.hap

English summary

Unofficial HarmonyOS NEXT port of Bettbox, based on upstream v1.19.5 (111c5d91), commit 1157ac6e.
Requires HarmonyOS NEXT / OpenHarmony on arm64-v8a (phone / tablet / 2in1).
Items marked 🆕 below are new (or newly usable) compared with the previous ohos-v1.19.4 release.

Already available

  • TUN-based VPN with an HTTP/SOCKS5 mixed port; rule / global / direct modes; LAN sharing (allow-lan).
  • Real device DNS pushed to the core; system DNS override switch (vNIC DNS semantics).
  • Background keep-alive via a continuous task (data transfer / audio playback / computing) with automatic
    re-request after cancellation; release builds hand the TUN fd over an abstract socket.
  • Upstream UI features: profiles, rules, proxy groups, connections, logs, backup & restore.

🆕 New in this release

  • One-tap subscription import via the clash://install-config deep link.
  • Script overrides now work out of the box (bundled Rust/rquickjs engine).
  • Dashboard network info (type / internal IP / gateway / system DNS).
  • Flush-DNS-on-network-change switch.
  • MTU range aligned with the HarmonyOS VPN (576–1500, presets 1500/1400).
  • Upstream app icon (including a launch icon) and the launcher label Bettbox.
  • Fixed: the PRE ribbon on release builds (update checks work again) and CJK/Latin spacing issues.
  • HAP size 61.7 → 56.3 MiB; arm64-v8a only.

Known gaps: per-app routing (PROCESS-NAME / PROCESS-PATH) is not available on HarmonyOS yet;
the system HTTP proxy is not exposed by HarmonyOS (the corresponding settings are hidden).

Artifact: unsigned HAP (56.3 MiB) + .sha256 (9322b52f…e731). Sign it with your own
certificate/profile before installing.