Repository navigation
Releases: htoay/Bettbox
Release list
ohos-v1.19.5
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,鸿蒙端做了对应适配。 - 依赖升级:
riverpod3.4、freezed4、flutter_rust_bridge2.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 状态栏托盘等)可能不可用。
安装(未签名包需自行签名)
-
准备签名材料:用 DevEco Studio 的自动签名(需登录华为开发者账号并把你的设备 UDID 加入调试证书),
或自行申请证书与 Profile。 -
签名:用 DevEco Studio 打开工程 →
Build > Generate Signed HAP/APP,选中下载的 HAP;
或用你自己的签名工具(hapsigner 等)签名。 -
安装:
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-configdeep 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.