简体中文

手机部署（Android，实验性）

WARNING

手机部署是实验性、进阶用法，资源消耗大，并不适合大多数人。如果你有一台 PC / 服务器，请优先用 Docker 部署。本页只是说明在 Android 上"能跑"的现实路径，并诚实地交代它的限制。

现实情况：Docker 在手机上基本跑不动

先把期望摆正：

无 root 的 Linux 用户态在 Android 上很容易——用 Termux + proot-distro 装一个 Ubuntu 即可。
但真正的 Docker（dockerd）在 proot 下跑不起来。 proot 只是一个基于 ptrace 的系统调用模拟器，没有 namespaces / cgroups / netfilter，而这些正是容器运行时所依赖的。
想在手机上跑真 Docker只能上虚拟机（Termux 里的 QEMU，或 Podroid 这类 App）。但手机一般没有 KVM，只能走 TCG 软件模拟，非常慢，对绝大多数用户不实用。Google AVF 的"Linux 终端"是真 VM，但其官方镜像在 2026 年仍不是开箱即用的容器环境。

因此手机上的现实推荐：Termux + proot Ubuntu，然后在里面按 Linux 手动部署流程手动跑 SnowLuma。 手机上的 Docker 留给极客折腾，不在本页推荐范围。

各平台对比见部署方式选择。

DANGER

别从 Google Play 装 Termux。 Play 商店里的版本早已停更、有已知问题。请从 F-Droid 或 Termux 的 GitHub Releases 安装。

装好后先更新一下：

pkg update && pkg upgrade

pkg install proot-distro
proot-distro install ubuntu
proot-distro login ubuntu

进去之后你就在一个 Ubuntu 用户态里了。文档见 https://github.com/termux/proot-distro 与 https://wiki.termux.com。

剩下的步骤和 Linux 手动部署 完全一致，在 proot Ubuntu 里依次做：

由于一切都在手机本机，noVNC / WebUI 直接用 http://localhost:6081 / http://localhost:5099 在手机浏览器里打开即可。

请直接照搬 Linux 手动部署的完整命令，本页不再重复。

ptrace 注入在 proot 下可能受限。 SnowLuma 的 hook 靠 ptrace 注入 QQ 进程，而 proot 本身就是个 ptrace 模拟层——两者叠加时注入是否成功高度取决于设备、内核与 proot 版本，不保证可用。这是本路径最大的不确定点。
资源吃紧。 QQ 是基于 Chromium 的 Electron 应用，外加一整套 Xvfb + VNC + Node，对手机内存 / 发热 / 电量压力很大。低端机基本带不动。
arm64。 手机基本都是 arm64，记得 Node、Linux QQ、SnowLuma 都要选 arm64 版本。
会话保活。 Termux 进程可能被系统省电策略杀掉；用 Termux 的 wake-lock，并考虑关掉该 App 的电池优化。
架构选错就跑不起来。 lite tarball 选 linux-arm64-lite，QQ .deb 选 arm64。

整体而言：手机部署可以作为尝鲜 / 应急，但不是稳定生产方案。 想长期稳定，请用 PC / 服务器上的 Docker 部署。

如果你执意要在手机上跑 Docker，唯一可行方向是在 Termux 里用 QEMU 起一个 x86_64/arm64 的 Linux 虚拟机、在 VM 里装真 Docker，再按 Docker 部署操作。但没有 KVM 的纯软件模拟非常慢，不推荐，这里仅作说明，不展开。