把 .NET 8 项目塞进一台安卓手机:Termux + proot 全流程实录

0 阅读7分钟

一、为什么干这件事

起因很简单:我有一个跑在 .NET 8 上的前后端分离项目(下面统一叫它 web-demo)——一个 Vue3 前端站点 + 一个管理后台 + 两套 .NET 8 API + MySQL 数据库,日常想找个地方长期挂着测试。云服务器要花钱,家里电脑不能 24 小时开机,抽屉里正好躺着一台退役的安卓手机。

那么问题来了:能不能让它在抽屉里发挥余热,变成一台真正的 Web 服务器?

先说结论,这篇文章写完时,这台手机上跑着这些东西:

  • 两个 .NET 8 后端:前台 API(5201)+ 管理后台 API(5202),SqlSugar + CodeFirst 自动建表
  • 两套 Vue3 前端:nginx 托管静态文件并反向代理 API
  • MariaDB 10.11:完整数据库
  • Cloudflare 隧道 ×2:外网可以直接访问前台和后台,登录接口实测全链路通

全程不需要 root,手机还是原来的系统,微信该刷照刷。

02-架构图.png

二、选型:为什么是 Termux + proot

这条路上我实际试了三种方案,前两种都失败了,失败原因比成功经验更有价值。

方案一:UserLAnd(失败)。它同样基于 proot,但busybox 环境限制太多:自带 tar 不认识 --exclude 的通配模式、dropbear 没有 sftp、rootfs 解压路径各种坑。能跑通,但每一步都别扭,放弃。

方案二:刷机成 Linux / 装 Docker(不可行)。我把三台候选手机(Reno9、Reno8、vivo)的内核配置全部检查了一遍——zcat /proc/config.gz——结论是:这些量产机的内核裁掉了 PID namespace、USER namespace、CGROUP_DEVICE,Docker 的运行前提一个都不满足。就算你拿到 root,容器也起不来。1Panel 更不用说,它本身依赖 Docker。刷 Linux 发行版则需要社区适配的内核,这些机型都没有。

方案三:Termux + proot Debian(成功)。proot 不需要内核特性,它用 ptrace 在用户态"伪造"出一个 root 文件系统环境。性能有损耗(系统调用拦截约 10%~20%),但换来的是完整的 Debian 12 生态:apt、systemd 之外的任意服务、原生 aarch64 的 .NET 8 runtime。

一句话总结选型逻辑:内核不给的能力,就在用户态绕过去。

三、七步部署流程

03-七步流程.png

第 1 步:安装 Termux 并换源

认准 GitHub Releases 的 APK(版本 0.118.3+)。不要从 F-Droid 和 Google Play 混装,两者签名不互通。装完换清华源:

sed -i 's@^\(deb.*stable main\)$@#\1\ndeb https://mirrors.tuna.tsinghua.edu.cn/termux/apt/termux-main stable main@' $PREFIX/etc/apt/sources.list
pkg update && pkg install openssh proot tar curl

顺手装好 sshd 并注入公钥,之后所有操作都在 PC 上远程完成,不用对着手机小屏幕打字:

sshd   # 监听 8022,注意 Android 非 root 用不了 22 端口

第 2 步:准备 Debian rootfs(第一个大坑)

我直接从 PC 打包了一个 Debian 12 aarch64 的 rootfs 传过去,结果解压时报了满屏的:

tar: Cannot create hard link: Operation not permitted

根因:普通应用的存储空间上内核拒绝创建硬链接,而 Debian 官方 rootfs 里到处都是硬链接。

解法是组合拳:PC 端打包时把硬链接全部解引用——

tar --hard-dereference -czf rootfs.tar.gz debian-rootfs/

手机端解压时让 proot 把链接转义成它自己的机制——

proot --link2symlink -0 -r $HOME/debian -b /dev -b /proc -b /sys -b /dev/urandom:/dev/random -w /root /bin/bash

-0 伪造 root 身份,-b 把几个必要的内核虚拟目录绑定进来。注意:这里千万不能加 --kill-on-exit,否则 SSH 会话一断,proot 会把里面所有服务全杀了(我在这上面损失过一次完整部署)。

第 3 步:.NET 8 运行时

PC 端自包含发布,拷过去就能跑:

dotnet publish -c Release -r linux-arm64 --self-contained -o ./publish

不需要在手机上装 SDK,只带 runtime 更省空间。两个 API 都这么发。

第 4 步:MariaDB 初始化(第二个大坑)

apt 装 MariaDB 10.11 之后,service mysql start 是起不来的(没有 systemd),直接调 mariadbd 又报 setuid 失败——proot 里没有真正的 root,降权切换用户必然失败。所以必须显式指定运行用户:

mariadbd --user=root --datadir=/var/lib/mysql &

初始化 root 密码时发现 root 默认走 unix_socket 认证,常规方式登不进去,用 skip-grant-tables 起一轮重置:

mariadbd --user=root --skip-grant-tables &
mariadb -uroot -e "FLUSH PRIVILEGES; ALTER USER 'root'@'localhost' IDENTIFIED VIA mysql_native_password USING PASSWORD('xxx');"

还有个隐蔽坑:Linux 上库名大小写敏感。我的连接串写的是 Demo_Db,建库时却是小写 demo_db,本地 Windows 全通,到了手机上直接报"数据库不存在"。DROP 重建,大小写对齐。

第 5 步:nginx 反向代理

Web 目录结构是标准的前台 + 后台双站:

server { listen 8080;  root /var/www/web-demo/web;    location /api/       { proxy_pass http://127.0.0.1:5201; } }
server { listen 8081;  root /var/www/web-demo/admin;  location /admin/api/ { proxy_pass http://127.0.0.1:5202/api/; } }

注意后台那行的写法:proxy_pass 必须带 URI(结尾的 /api/),因为我的后台接口统一走 /admin/api 网关段,nginx 要负责把 /admin 剥掉再转发——这一点在第 6 节的坑里还回来补了一刀。

第 6 步:前端构建产物(第三个大坑,最隐蔽)

前端 vite build 后传到手机,前台站点一切正常,管理后台打开却是整页白屏,控制台:

Uncaught ReferenceError: Cannot access 'Nt' before initialization

本地 dev 环境完全正常,只有生产构建炸。排查到最后发现是 vite.config.ts 里 manualChunks 把 element-plus 单独拆了一个 chunk:Rollup 把公共 interop 辅助函数提升进了 EP chunk,vue-vendor chunk 又反过来 import 它——两个 chunk 形成了循环依赖,模块求值顺序被打乱,EP chunk 里一个还没初始化的 const 被提前访问,直接 TDZ。

解法:把 element-plus 并入 vue-vendor 同一个 chunk,依赖图变成纯单向,问题消失。代价是 EP 升级时 vue 的缓存一起失效——可接受。

经验:manualChunks 不是随便拆的,互相引用的包必须在同一个 chunk 里,拆分前画一下依赖方向图。

第 7 步:内网穿透与保活

nohup cloudflared tunnel --url http://127.0.0.1:8080 > cf.log 2>&1 &
nohup cloudflared tunnel --url http://127.0.0.1:8081 > cf-admin.log 2>&1 &

快速隧道免费、免注册、免公网 IP,几秒钟就拿到一个 xxx.trycloudflare.com 的 HTTPS 域名。代价是地址随机,隧道重启就换——要固定域名得把 DNS 托管到 Cloudflare 做正式隧道,这是后续计划。

最后是保活三件套,缺一不可:

termux-wake-lock                    # 拿住唤醒锁,防止 CPU 休眠
# 设置里把 Termux 加入电池优化白名单  # 防 Android 低内存清理
# 安装 Termux:Boot                  # 开机自启

我在这上面翻过车:MariaDB 被 Android 低内存机制无痕杀掉,日志里一个字都不提,表现是所有接口随机 500、后台日志每秒刷"调度循环异常"。所以我把全部服务的启动逻辑写成了一个幂等脚本 start-all.sh,MariaDB → 两个 API → nginx → 隧道 → sshd,一条命令全拉起。

四、实测数据

05-实测数据.png

几个值得说的点:

  • 512MB 的 GC 堆上限是通过 DOTNET_GCHeapHardLimit=0x20000000 显式限制的。手机内存宝贵,不限制的话 GC 会按机器内存比例去拿,容易触发系统级查杀。
  • 公网访问实测首包 1.2 秒左右(curl time_total,含 Cloudflare 跨境链路),局域网几乎无感。作为测试环境完全够用。
  • 全部前后端部署体积约 300MB,手机存储毫无压力;把安装包残留清掉之后,整套系统占用不到 2GB。

五、踩坑速查

04-踩坑清单.png

把四个最疼的坑浓缩成一张图,按"现象 → 根因 → 解法"组织。如果你也走这条路,建议先看这张图再动手。

六、边界与建议

这套方案的真实能力边界,说实话:

适合:个人项目演示、测试环境、给客户看 Demo、7×24 挂一个低流量服务。手机待机功耗大概 1~2W,一年电费几块钱。

不适合:生产业务。三个硬伤:proot 的性能损耗、Android 随时可能杀后台(即使白名单也不能 100% 避免)、家用宽带的公网质量。真要上生产,还是老老实实买服务器。

以及一个安全提醒:把管理后台暴露到公网之前,确认登录接口有验证码和防爆破措施,最好再套一层 Cloudflare Access。


这个项目后续还会更新:正式隧道固定域名、Termux:Boot 开机自启、监控告警。感兴趣的话关注「阿波技术栈」,我们下期见。

如果这篇文章帮到了你,点个「点赞」和「收藏」,让更多想白嫖服务器的人看到。


相关阅读(往期):.NET 8 部署实践系列 · SqlSugar CodeFirst 实践 · Vue3 分包策略