夜雨聆风学习资料网

ARTICLE · 1391301

鸿蒙手机上,哪些 App 走代理由你定

鸿蒙手机上,哪些 App 走代理由你定

鸿蒙手机上,哪些 App 走代理由你定

装完之后,手机上哪个 App 走隧道、哪个直连,可以自己挑;订阅也能导进去。纯血鸿蒙上这类客户端不多,这篇讲装完是什么样、以及怎么把它装进去。

先说装完能变成什么样

NekoBox4Harmony(github.com/xiaoli8571/NekoBox4Harmony)底层是 sing-box 内核——一个 Go 写的代理引擎,一个内核就能处理多种入站/出站协议和统一的分流规则。装到手机上之后:

  • 按应用分流
    :per-app 代理,哪些 App 走隧道、哪些直连,自己勾;
  • 订阅直接导
    :把订阅转成 sing-box 配置导进去,不用一条条手填节点;
  • 看得见状态
    :VPN 连接状态、通知、流量这些在界面里能看;
  • 和「连回内网」互不打架
    :TailMesh 负责连回家里,NekoBox 负责手机出网走代理,两件事目的不同。
上面是这套客户端具备的能力,依据技能文档整理,不是实测截图;具体能不能用、表现如何,取决于你的设备、系统版本和网络环境。

先厘清:它和 TailMesh 不是一回事

维度
TailMesh
NekoBox
本质
组网客户端(Tailscale 协议)
出网代理客户端(sing-box 内核)
内核
预编译 Rust .a 随仓库分发
预编译 Go .so 随仓库分发
签名方式
hap-sign-tool 手动签(明文密码)
hvigor 自动签(加密密码)
硬编码 bundleName
Index.ets 2 处 VPN Want
VpnIpc / VpnExtAbility / ConfigBuilder 3 处
需改权限
否
是(删 READ_PASTEBOARD)
订阅导入
不需要(填 Tailscale Auth Key)
需要(本机 HTTP 中转)
一句话:TailMesh 负责「进你家内网」,NekoBox 负责「手机出网走代理」。

装一次要填的 6 个坑

和 TailMesh 一样,NekoBox 也是源码分发,得自己编译、签名、装真机。而且它带订阅、带 per-app 代理、带通知,要改的硬编码更多。

1. 改 3 处硬编码 bundleName(com.nekobox.app.jynxen)——最致命

  • VpnIpc.ets:23
     的 APP_BUNDLE:commonEvent 发布的 bundleName,不匹配 → 主应用收不到 VPN 状态/流量事件;
  • VpnExtAbility.ets:1100
     的 wantAgent bundleName:不匹配 → Invalid wantAgent object → 通知发不出 → 系统回收扩展进程 → VPN 连上几分钟就断;
  • ConfigBuilder.ets:725
     的 REAL_APP_PREFIX:per-app 代理的沙箱路径前缀。

用 grep -rn "com.nekobox.app.jynxen" entry/src/main/ets/ 确认无遗漏。漏改任意一处,结果就是连接 120s 超时、或连上就断。

2. 移除个人调试 profile 拿不到的系统级权限

module.json5 的 requestPermissions 里删掉 ohos.permission.READ_PASTEBOARD(user_grant + 需 ACL,个人调试 profile 无授权 → 安装直接报 9568289)。代价只是「从剪贴板导入」会弹逐次确认框,功能仍可用。

3. 关闭「测速时绕过隧道」默认值

Profile.ets 的 testBypassTunnel: true → false。否则它会 SO_BINDTODEVICE 绑定物理网卡,鸿蒙三方应用无此权限,测速全红报「绑定物理网卡失败」。

4. 移除 macOS 隔离属性

xattr -rd com.apple.quarantine <command-line-tools>/

不解会导致 SDK 自带的 ninja / cmake 被 SIGKILL(exit 137),CMake 配置阶段直接 Subprocess killed。

5. 构建与签名

走 hvigorw assembleHap,用 ~/.ohos/config 里的加密格式密码自动签名,产物直接是 entry-default-signed.hap,再 hdc install。

6. 订阅导入(手机直连境外订阅会超时)

本机 curl 抓订阅 → 若是 clash yaml 转成 sing-box JSON → 本机起 python3 -m http.server 8000 托管 → 手机 NekoBox 加 http://&lt;本机局域网IP&gt;:8000/singbox-sub.json → 导完 pkill 关掉。

这 6 步连同每一步「为什么、漏了报什么错」,我固化成了技能 nekobox-harmony-install:对着 agent 说一句「把 NekoBox 装到我的鸿蒙手机」,它先逐项检测华为开发者账号、command-line-tools、JDK、调试签名材料、真机 USB 调试、手机 API 版本,缺什么报什么,再按标准流程跑完。原来一边查报错一边翻源码,现在是一条能重跑的流程。

必须坦诚的限制

  • 同样需要鸿蒙开发者调试签名环境,没有的人无法自助安装;
  • VPN 扩展授权若个别设备需 ACL,个人开发者可能拿不到;
  • 改了 bundleName / 权限 / 默认设置,与上游发布版有差异,只能自用,勿提交 AGC 审核。

四步到这儿闭环了:先把 Tailscale 网搭起来 → NAS 当锚点接进去 → 鸿蒙手机用 TailMesh 入网 → 手机自己用 NekoBox 出网。全程没把家里的服务暴露到公网,路由器上不用开任何端口。

这套折腾下来,你最想解决的是哪一件:在外面随时翻家里文件,还是手机按应用分流?留言告诉我,后面的内容可以往那个方向写。

🔗 四个技能仓库(安装流程与配置说明,非编译源码):

  • github.com/hummingg/tailscale-mac-nas-setup-skill
  • github.com/hummingg/nas-ssh-ops-skill
  • github.com/hummingg/tailmesh-harmony-install-skill
  • github.com/hummingg/nekobox-harmony-install-skill

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料