ARTICLE · 1391301
鸿蒙手机上,哪些 App 走代理由你定
鸿蒙手机上,哪些 App 走代理由你定
装完之后,手机上哪个 App 走隧道、哪个直连,可以自己挑;订阅也能导进去。纯血鸿蒙上这类客户端不多,这篇讲装完是什么样、以及怎么把它装进去。
先说装完能变成什么样
NekoBox4Harmony(github.com/xiaoli8571/NekoBox4Harmony)底层是 sing-box 内核——一个 Go 写的代理引擎,一个内核就能处理多种入站/出站协议和统一的分流规则。装到手机上之后:
- 按应用分流
:per-app 代理,哪些 App 走隧道、哪些直连,自己勾; - 订阅直接导
:把订阅转成 sing-box 配置导进去,不用一条条手填节点; - 看得见状态
:VPN 连接状态、通知、流量这些在界面里能看; - 和「连回内网」互不打架
:TailMesh 负责连回家里,NekoBox 负责手机出网走代理,两件事目的不同。
上面是这套客户端具备的能力,依据技能文档整理,不是实测截图;具体能不能用、表现如何,取决于你的设备、系统版本和网络环境。
先厘清:它和 TailMesh 不是一回事
一句话: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的 wantAgentbundleName:不匹配 →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://<本机局域网IP>: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-skillgithub.com/hummingg/nas-ssh-ops-skillgithub.com/hummingg/tailmesh-harmony-install-skillgithub.com/hummingg/nekobox-harmony-install-skill















































































