架构与决策

Android 宿主

基线为 cupid 官方 LineageOS 23.2(20261008)、Android 15 国行底层固件与同构建启动镜像。保留官方 boot.img 及发布方 SHA-256。Magisk 28.1 实测无法启动,首选验证 30.7。按构建分别保存补丁镜像。保持 SELinux Enforcing。逐项验证 Root 和系统启动后再启用服务。

Ubuntu 与远程接入

使用 Canonical Ubuntu Base 24.04 ARM64、32 GiB 按需分配的 ext4 镜像和普通 chroot,优先复用 Linux Deploy CLI 的挂载、服务启动和卸载接口。采用 OpenSSH 普通用户和公钥认证,验证交互 PTY、远程命令和断开后的服务生命周期。宿主开机入口只负责挂载文件系统并启动服务。停服并卸载后方可复制运行镜像作为一致备份。保留电脑上的密钥和配置记录。

旧 Ubuntu-Chroot v4.4 已被上游归档,其启动脚本会尝试改变宿主 SELinux 和 Doze 策略。Droidspaces 需要当前内核缺少的 PID 和 IPC namespace。

Docker

手机本地服务先使用 Ubuntu ARM64 软件包。如容器可以运行在外部主机,使用 Docker CLI 经 SSH context 管理指定引擎,明确卷和发布端口属于远端。需要手机离线运行 Compose 时,建立独立的 cupid 内核构建与回归流程,覆盖厂商模块 ABI、PID/IPC namespace、cgroup、存储及网桥。验证容器、卷、网络、重启恢复、Wi-Fi、USB 和充电后再部署。当前官方内核具备 OverlayFS,缺少 PID namespace。

无人值守与供电

先验证 Lineage 充电阈值;仅在实测不满足要求时引入 ACC,并保持单一控制者。分别验收未解锁冷启动后 SSH 可达、熄屏一小时后新建 SSH 会话,以及长插电 24 小时的电量和温度。记录实际时间与结果。旁路供电须单独实测。只针对可复现的断连调整保活。

发布与资料

文档站采用 MkDocs,交付路径为 Git 仓库连接 Cloudflare Workers Builds。记录构建号、校验值、验收和回退步骤。外部发布目标由维护者指定。

参考 Magisk 变更记录、Linux Deploy CLI、Ubuntu Base、旧模块及继任者、Docker SSH 接入。