零基础云手机搭建教程

开始前：准备两类设备和必要信息

管理电脑需要运行 Windows 64 位客户端。云手机节点需要运行 Ubuntu 24.04 amd64，并能从管理电脑到达 SSH 端口。你还需要准备节点 IP、SSH 端口、账号和密码。

如果节点位于局域网，管理电脑应能直接访问该地址；如果需要从外部网络使用，应先完成你自己的安全网络方案。不要为了方便直接暴露弱口令 SSH 服务。

• Windows 64 位管理电脑，可正常安装并运行客户端。
• Ubuntu 24.04 amd64 节点，内存和数据盘达到部署预检要求。
• 节点 IP、SSH 端口、SSH 账号和密码。
• 稳定网络；局域网场景优先使用内网直连。
• 重要数据已经备份，特别是准备重装系统的闲置电脑。

从客户端完成一键部署

1. 01

   下载并登录客户端

   安装 Windows 64 位客户端，注册账号并登录。后续服务器和云手机管理都在客户端中完成。

2. 02

   添加 Ubuntu 服务器

   填写服务器名称、分组、节点 IP、SSH 端口、账号和密码；按网络环境选择自动连接、平台公网连接或桌面端局域网连接。

3. 03

   先执行连接测试

   确认客户端能够到达节点并完成 SSH 身份校验。首次连接会要求确认主机指纹；如果指纹发生变化，系统会阻止继续连接，需先核实服务器是否被重装或更换。

4. 04

   发起一键部署

   客户端先运行只读预检，检查 Ubuntu 版本、网络、内存、磁盘、Docker、ADB、Binder、镜像和节点服务条件，再准备基础依赖、存储目录、Docker、运行环境与 Agent。

5. 05

   观察步骤与日志

   保持客户端运行，查看每个阶段的状态和日志。如果预检明确提示系统版本、空间或网络问题，应先修正对应条件再重试。

6. 06

   确认服务器健康状态

   部署完成后执行健康检查，确认节点服务、Docker 和运行环境可用。若检查发现可修复问题，可使用客户端中的修复功能。

7. 07

   创建并启动云手机

   选择服务器、分组、系统镜像、资源配置和网络方式，创建云手机。启动后再通过远程入口连接，检查画面和基本操作是否正常。

第一台云手机创建后应该检查什么

先用一台云手机完成小范围验证：检查启动状态、远程画面、输入操作、网络访问和重启流程。确认稳定后，再根据节点实时负载逐步增加数量。

同一节点首次使用某个系统镜像时需要下载和校验；后续创建相同镜像的云手机会优先复用节点缓存。不要在镜像仍在准备时同时提交大量创建任务。

• 服务器健康检查通过。
• 云手机能正常启动、停止和重启。
• 远程画面与输入操作正常。
• 网络方式与实际使用场景一致。
• 节点内存、磁盘和负载仍有安全余量。

部署失败时按这个顺序排查

先看失败阶段和原始日志，不要连续重复点击部署。系统版本错误、SSH 不通、磁盘不足和软件源不可用，处理方法完全不同。

• 确认节点确实为 Ubuntu 24.04 amd64，而不是其他 Ubuntu 版本或桌面系统。
• 从管理电脑检查 IP、SSH 端口、账号、密码和主机指纹。
• 确认节点内存不少于 4 GB，数据目录可用空间不少于 30 GB。
• 确认节点可以访问部署所需的软件源或已准备离线环境包。
• 部署完成但状态异常时，先运行健康检查，再根据结果使用修复或 Agent 更新。