1.9.0-ohos

NekoBox for Harmony 1.9.0

内核

• sing-box 内核由 1.11.9 升级到 1.14.0（core/sing-box-1.14 源码与成品 libsingbox.so 随仓库分发，OHOS 补丁全部移植并新增补丁 5）
• 修复 1.14 下真机启动失败：
  • ArkTS 层：DNS local 服务器不再 detour: "direct"（1.12+ 新式 DNS server 禁止 detour 到空 direct outbound，不写 detour 即默认直连，语义不变）
  • 内核层：direct 出站 fetchMyAddresses() 增加 nil InterfaceMonitor 守卫（修复真机启动后 ~70ms 的 SIGSEGV 崩溃，构建脚本 fail-closed 校验）
• 构建链升级为双工具链：go1.24.5 OHOS fork（含 sync.WaitGroup.Go 回植，模板在 core/patches/）+ go≥1.25.5 主机工具链（GO126，仅用于模块解析/tidy/vendor），llvm-readelf 校验 CGo 导出

测速

• 新增 URL Test 真连接测速（本版默认）：经代理隧道完整链路（TCP→TLS→HTTP 探活测试网址），绿色 = 节点真实可用；失效/假节点不再"假绿"
• 设置页「测速方式」可切换 URL Test / TCPing（TCPing 仅测服务器端口 TCP 握手，快但会假绿——这正是"订阅一片绿但都不能用"的原因）
• 测试网址可自定义，默认 https://www.gstatic.com/generate_204（旧默认 cloudflare 自动迁移）；内核测速会话启动失败自动回退 TCPing
• 提示：VPN 已连接时测速流量同样经过隧道，延迟包含隧道开销；挑节点建议在断开状态测

其他

• versionCode 1001926 / versionName 1.9.0（关于页、检查更新同步生效）
• 安装包为未签名 HAP，安装前请在 DevEco 里签名
• SHA256: CD5628C887DF9E45D0FC2441D392C55B966CBCEFC4FFB84B56DA79763BA29614

1.8.0-ohos

NekoBox4Harmony 1.8.0 unsigned HAP.

v1.7.3-ohos

NekoBox4Harmony v1.7.3(versionCode 1001920)

对审修复轮:修复订阅解析与设置项失效问题。

修复

• Clash 订阅补全:hysteria2 / tuic 节点此前被直接跳过,现已正确导入(含端口跳跃、拥塞控制、0-RTT 等);修复 gRPC 节点 serviceName 丢失;补 ws 早期数据与 h2 传输映射
• 订阅请求放行不安全 TLS:设置项生效(自签证书订阅可下载)
• 解析目标地址:设置项生效(规则模式下 IP 类规则可匹配域名流量)
• 通知显示分组名:设置项生效,通知副标题显示 [组名] 节点 · 延迟
• 设置页新增「解析目标地址」开关与「全局自定义配置 JSON」入口

已知限制

• 内核冻结(sing-box 1.11.9):anytls / mieru / naive / trojan-go 不支持

完整变更见 CHANGES.md。未签名 HAP 需在 DevEco Studio 中签名后安装;仅支持真机。

v1.7.2-ohos

NekoBox4Harmony v1.7.2(versionCode 1001919)

以 NekoBoxForAndroid 为基准的 1:1 功能对齐版本。未签名 HAP,需在 DevEco Studio 中签名后安装;仅支持真机(模拟器无 VPN 扩展)。

1.7.0(P 轮:对齐安卓)

• 协议 14 种:新增 SSH / ShadowTLS / 自定义出站 JSON / 链式代理;补齐 uTLS/REALITY/ECH/证书、Mux 细化、hysteria2 端口跳跃、TUIC 0-RTT、SS 插件等全部高级字段
• 设置页新增 常规/路由/DNS/入站 四组:嗅探、绕过局域网、FakeDNS、DNS 域名策略、混合端口、日志级别、测试 URL 等全部接入内核配置
• 新增分组管理页(订阅流量徽标/更新全部/导出全部节点链接)、工具页(STUN NAT 探测 + 恢复出厂)、关于页(检查更新)
• 链接解析扩展:ssh://、socks4/4a、SS 插件参数;链接导出新增 ssh

1.7.1

• 抽屉各驻留页常驻返回入口;FAB 圆形容器化(半透明、放大、阴影跟随圆角)
• 修复长时间闲置后 VPN 无法启动:扩展重播已连接状态、120s 启动终态判定、teardown 超时兜底、前台 clash API 状态核对

1.7.2

• 设置页去重(备份迁至工具页);移除面板功能
• 配置页节点列表卡片化,抽屉头部加应用图标与版本号,UI 对齐安卓观感

已知限制

• 内核冻结(sing-box 1.11.9):anytls / mieru / naive / trojan-go 不支持

v1.6.0-ohos (G phase complete)

NekoBox for Harmony v1.6.0(G 阶段收官)

基于冻结内核 sing-box 1.11.9(c-shared 进程内运行)。未签名 HAP,下载后在 DevEco Studio 中签名安装(签名自理)。

相对 v1.5.8-ohos 的主要更新:

• 节点手动排序:长按上移/下移;排序模式(手动/按延迟/按名称)可切换
• 分组测速汇总:组头最低延迟徽标、"n 未测"提示、测速本组按钮
• 分享二维码:节点/订阅分享 URI 二维码弹窗(白底黑码;不支持时自动降级纯文本+复制)
• 远程规则集订阅:规则页管理 .srs 源(site/ip/出站/开关),sing-box 1.11 route.rule_set,下载失败跳过不影响启动,备份兼容 v3
• 连接统计:experimental.clash_api(127.0.0.1,随机 secret 鉴权),连接页实时速率/活跃连接列表/关闭单条
• 切换可靠性与模式语义:节点/模式切换串行重启内核(forceRestart);global 模式 = 除 DNS 劫持外全走代理(国内地址也走代理),私网/自定义/geo 仅 rule 模式参与
• 通知栏:全资源化(中英),副标题"节点名 · 延迟",未测速"节点名 · --"

已知风险点(建议装机后重点验证):

• G4 远程规则集:首次连接时内核在线下载 .srs(download_detour=direct),网络受限环境可能拉取失败(失败自动跳过,不影响其他分流)
• G5 连接统计:clash_api 在 c-shared 模式下的可用性依真机环境而定;不可用时连接页自动回退总速率展示

说明:

• versionCode 1001900;HAP sha256 e4208f48017dd786c42b65d46c78705e6100f9854fe2091abcfa03037ff38180
• 完整变更史见仓库 CHANGES.md

v1.5.8-ohos (F-phase complete)

NekoBox for Harmony v1.5.8(F 阶段收官)

基于冻结内核 sing-box 1.11.9(c-shared 进程内运行)。未签名 HAP,下载后在 DevEco Studio 中签名安装(签名自理)。

相对 v1.5.7-ohos 的主要更新:

• 通知栏增强:常驻通知显示当前节点测速延迟,支持通知栏一键断开
• 订阅后台更新:到期订阅在应用退后台/熄屏后自动更新(后台连续任务)
• per-app 图形化应用选择器(列表 + 搜索 + 勾选,失败自动降级手输包名)
• 备份文件化:DocumentViewPicker 导出/导入 .json 备份(schema v3,剪贴板方式保留)
• 中英双语:跟随系统语言,264 项界面文案全量资源化
• HarmonyOS 原生观感:统一 16vp 页边距与卡片圆角、分段控件等分、色值全部语义令牌化(深浅色双份)、状态栏前景色跟随深浅色主题

说明:

• versionCode 1001800;HAP sha256 653d64cde814332baed96826a8af40983e1fae0318ba42cdbf8902a1eccb5a25
• 后台任务/应用枚举/文件选择器依赖真机权限,建议装机后按仓库 CHANGES.md 清单逐项复核

NekoBox for Harmony v1.5.7 (sing-box 1.11.9)

v1.5.7(versionCode 1001711)

未签名 HAP:下载附件后请在 DevEco Studio 中完成签名再安装(签名由用户自理)。versionCode 1001711 高于此前所有版本,可直接覆盖升级安装。

本版新功能

• 节点分组:分组管理、首页分组显示与节点移动
• ProfileEdit 实时校验:服务器 / 端口范围 / UUID / 协议凭据 / REALITY 公钥与 short ID / 可选 JSON
• 外观设置:跟随系统 / 浅色 / 深色、触感反馈、液态玻璃偏好;深色主题资源全量接入,切换即时生效
• 批量延迟测试集成首页节点列表,结果保存并按延迟着色
• per-app 分流:包含 / 排除模式(手动输入包名)
• 自定义分流规则:域名 / IP CIDR / GeoIP / GeoSite,接入 sing-box 路由(位于 DNS 与私网安全规则之后、最终出站之前)
• 订阅更新调度:更新间隔、下次 / 上次更新时间与错误元数据,应用启动时自动更新到期订阅
• 备份 / 恢复 schema v3:设置、节点、分组、订阅、自定义分流规则;剪贴板导入导出
• 分享链接导入:ss://、vmess://、vless://、trojan://、hysteria2://、tuic://

内核与构建

• sing-box 1.11.9(含 OHOS 网络监视器补丁)冻结成品 libsingbox.so 随仓库分发
• 克隆本仓库即可构建未签名 HAP,零额外步骤;hvigorw.js 已内置 Node ≥ 18.20 的 .cmd spawn 补丁
• 构建命令见 README「从源码构建」一节

已知限制

• per-app 应用选择为手输包名,图形化选择器、订阅后台定时更新、通知栏延迟显示将在后续版本(见 DEVPLAN.md F2~F6)
• 部分页面文案仍为中文(国际化收尾在 F6)
• 主题切换在个别页面可能仍需重进刷新(真机验收项)

NekoBox for Harmony v1.5.6 (sing-box 1.11.9)

真机验证可用版本。基于 v1.5.4 基线 + 生命周期竞态修复(外部静态审查 8 项)+ 远程 DNS 改 TCP(ss 等不支持 UDP 转发的节点不再整机断网)。

变更

• fix: native cancel loop —— 启动期间断开/超时/切换,内核必然被回滚(不再残留带失效 TUN fd 的后台内核)
• fix: Starting 态 stop 等待真实回滚完成(不再假装成功后销毁 TUN)
• fix: 启动期间切换节点排队重试(不再丢失请求)
• fix: 看门狗只依赖运行状态,不再依赖状态文案
• fix: teardown 各步 15s 超时;NAPI 参数校验
• fix: 远程 DNS 默认 tcp://8.8.8.8(关键:ss 节点常不支持 UDP 转发,UDP DNS 全挂会整机断网);旧值自动迁移

安装

1. 下载 HAP 用 DevEco Studio 签名后安装(versionCode 1001607,可直接覆盖)
2. 已导入节点无需重新添加

注意

• Shadowsocks 节点若不支持 UDP 转发,QUIC/UDP 类流量仍不通(节点能力限制),但 DNS/TCP 正常上网

NekBox v1.5.5-ohos

NekBox HarmonyOS build with sing-box v1.5.5. Includes VPN lifecycle improvements, startup cancellation/timeout and TUN rollback, protectProcessNet fail-fast handling, MTU safety limits, IPv6 latency testing, Shadowsocks SIP002 parsing fixes, nested subscription YAML parsing, and node selection fixes.