一、为什么干这件事
起因很简单:我有一个跑在 .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,手机还是原来的系统,微信该刷照刷。
二、选型:为什么是 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。
一句话总结选型逻辑:内核不给的能力,就在用户态绕过去。
三、七步部署流程
第 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,一条命令全拉起。
四、实测数据
几个值得说的点:
- 512MB 的 GC 堆上限是通过
DOTNET_GCHeapHardLimit=0x20000000显式限制的。手机内存宝贵,不限制的话 GC 会按机器内存比例去拿,容易触发系统级查杀。 - 公网访问实测首包 1.2 秒左右(curl time_total,含 Cloudflare 跨境链路),局域网几乎无感。作为测试环境完全够用。
- 全部前后端部署体积约 300MB,手机存储毫无压力;把安装包残留清掉之后,整套系统占用不到 2GB。
五、踩坑速查
把四个最疼的坑浓缩成一张图,按"现象 → 根因 → 解法"组织。如果你也走这条路,建议先看这张图再动手。
六、边界与建议
这套方案的真实能力边界,说实话:
适合:个人项目演示、测试环境、给客户看 Demo、7×24 挂一个低流量服务。手机待机功耗大概 1~2W,一年电费几块钱。
不适合:生产业务。三个硬伤:proot 的性能损耗、Android 随时可能杀后台(即使白名单也不能 100% 避免)、家用宽带的公网质量。真要上生产,还是老老实实买服务器。
以及一个安全提醒:把管理后台暴露到公网之前,确认登录接口有验证码和防爆破措施,最好再套一层 Cloudflare Access。
这个项目后续还会更新:正式隧道固定域名、Termux:Boot 开机自启、监控告警。感兴趣的话关注「阿波技术栈」,我们下期见。
如果这篇文章帮到了你,点个「点赞」和「收藏」,让更多想白嫖服务器的人看到。
相关阅读(往期):.NET 8 部署实践系列 · SqlSugar CodeFirst 实践 · Vue3 分包策略