手机 Ubuntu 运维
身份与入口
管理用户为 amani,SSH 端口为 8022。启动时生成手机自己的 SSH 主机密钥,重新连接时核对已固定的 Ed25519 主机指纹。USB 维护可用 adb -d forward tcp:0 tcp:8022 取得临时电脑端口。无线入口绑定到 wlan0 的 IPv4 地址,地址变化后服务重建无线监听。蜂窝网络接口未配置监听。
服务文件位于 /data/adb/amani,ext4 镜像为 ubuntu.ext4。专用目录和镜像分别使用权限 0700 和 0600。Linux Deploy CLI 的版本见验收记录。在已验证的版本中,将 cli.sh 的 mount) 分支从 container_mount 改为 container_mount "$@",使启动脚本可选择 proc、sys、dev。配置文件 config/amani.conf 设置 TARGET_TYPE="file" 和 TARGET_PATH="/data/adb/amani/ubuntu.ext4"。
将仓库的 scripts/amani-service.sh 和 scripts/run-guest.sh 安装到专用目录,scripts/90-amani-ubuntu.sh 安装到 Magisk 的 /data/adb/service.d/,由 root 持有并设置 0700。启动器取得独占锁,在私有挂载命名空间中挂载 ext4、devpts 和运行目录。Android 宿主的全局视图中挂载目录可以是空的。服务日志为 /data/adb/amani/service.log。
Android 联网身份
Android 根据应用 UID 管理出站网络。在此构建上,只有 chroot 内的 inet 附加组时,SSH 用户创建套接字返回 EPERM。仓库的 android/network-identity/AndroidManifest.xml 声明一个无代码、无界面、仅请求 INTERNET 的 APK。使用 Android 36 SDK 的 aapt2 link、zipalign 和 apksigner 构建并签名,安装后使用包管理器报告的 UID。签名材料保存在仓库外,后续更新使用同一签名。
在服务的挂载命名空间中以 Android root 运行 scripts/configure-guest-network.sh,同步 Ubuntu 用户 UID,并仅给此身份授予设备休眠网络例外。启用后分别检查 DNS、对外 TCP 和屏幕关闭后的新会话。重装身份 APK 后先复核 UID,再开放服务。
回退与备份
停用开机入口时,将 90-amani-ubuntu.sh 移到 service.d 之外,再重启。确认无 Ubuntu SSH 监听、镜像无 loop 关联后再备份整份 ext4 文件,保留其稀疏属性和 SHA-256。还原前先关闭服务。恢复官方 boot.img 的操作见维护接口。
如果已保存的 Wi-Fi 被 Android 标记为缺少互联网,且被设为永久禁用自动连接,应在系统通知中接受该指定网络并记住选择。完成后以无人操作的真实重启验证,待 wlan0 自动获得地址后从电脑新建 SSH 会话。
Android 默认网络可能在 Wi-Fi 与蜂窝数据之间切换。启动器读取 wlan0 对应的路由表,对 Ubuntu 管理用户的单个 UID 设置优先级 17990 的 IPv4/IPv6 路由,并从该网络的 LinkProperties 更新 DNS。验收包含普通用户访问 Ubuntu 软件源的实际 HTTP 请求。
熄屏测试通过管理电脑上的 scripts/verify-screen-off.sh SERIAL SSH_CONFIG HOST_ALIAS 执行。它记录启动 ID 和最后唤醒时间,一小时后经 Wi-Fi 新建 SSH 会话并核对两者。保持设备供电,在测试期间手动亮屏会影响判定。
Ubuntu 软件管理
通过已授权的 ADB Root 进入运行服务的挂载命名空间。以 Android root 运行下列命令,随后在 Ubuntu 内使用包管理器。
p=$(ps -Ao PID,ARGS | awk '$2=="sh" && $3=="/data/adb/amani/run-guest.sh" {print $1;exit}')
bb=/data/adb/magisk/busybox
test -n "$p" && "$bb" nsenter -t "$p" -m "$bb" chroot /data/adb/amani/mnt /usr/bin/env -i HOME=/root PATH=/usr/sbin:/usr/bin:/sbin:/bin /bin/bash
首次配置时,先完成 Android 联网身份映射,再在上述 Ubuntu root shell 中运行仓库的 scripts/provision-guest.sh(将脚本内容通过标准输入交给 /bin/sh 即可)。这一步需要能够访问 Ubuntu 软件源。
日常用 amani 的 SSH 公钥登录后,运行 sudo apt update 刷新索引,运行 sudo apt install 软件包名 安装软件,运行 neofetch 查看环境。APT 的下载进程使用有 Android 网络权限的 amani UID,并验证 Ubuntu 仓库签名。预装工具覆盖编辑、手册、DNS 查询、文件传输、Git、C/C++ 编译和 Python 虚拟环境。
amani 是这台单用户设备的管理员,持有其 SSH 私钥即可免密码执行 sudo。需要交互式 root shell 时使用 sudo -i。chroot 与 Android 共享内核及部分设备挂载,应按整台手机的管理员权限保管密钥。