4步在Linux上部署Waydroid：从慢速下载到容器直接跑起来

4步在Linux上部署Waydroid从慢速下载到容器直接跑起来【免费下载链接】waydroidWaydroid uses a container-based approach to boot a full Android system on a regular GNU/Linux system like Ubuntu.项目地址: https://gitcode.com/gh_mirrors/wa/waydroid你刚装完 waydroid一条waydroid init卡在上百 MB 的进度条上半天没动。Waydroid 是用 LXC 容器在 Linux 里跑完整 Android 系统的工具跟着本文4 个命令以内让容器跑起来并验证部署成功。 前置条件动手前确认这几点缺一样后面都会卡住Debian 系桌面系统Ubuntu 22.04x86_64 或 arm64 架构你的账号能执行sudo网络能连通 Waydroid 官方 OTA 镜像源下载依赖它磁盘预留 2 GB 以上镜像默认落在/var/lib/waydroid 推荐路径一条 init 命令跑完全程第 1 步确认命令可用。这条只是确认安装到位waydroid --version看到版本号即正常没有输出才需要回安装环节。第 2 步初始化镜像。init会从 OTA 渠道拉取 system 和 vendor 两个镜像包边下边做 SHA256 校验校验通过才解压到/var/lib/waydroid/imagessudo waydroid init需要 Google 服务时追加-s GAPPS其余参数-i自定义镜像目录、-c/-v换 OTA 渠道默认不用动。第 3 步启动并验证。先拉起容器再打开 Android 窗口sudo waydroid container start waydroid launch弹出 Android 13 桌面主路径就算走完。 替代路径镜像包已到手时跳过下载如果你已经在本机或内网拿到解压好的system.img和vendor.img直接放进预装目录再执行waydroid init检测到该目录同时有两个镜像文件就会跳过 OTA 下载sudo mkdir -p /usr/share/waydroid-extra/images sudo cp system.img路径 vendor.img路径 /usr/share/waydroid-extra/images/ sudo chown root:root /usr/share/waydroid-extra/images/*.img随后重跑sudo waydroid init即可。✅ 验证部署是否成功最小验证命令组是下面两条成功标准逐条写死不是看个大概waydroid status waydroid launch看到Session:为RUNNING、Container:为RUNNING、IP address:有一串内网 IP不是UNKNOWN且launch弹出 Android 桌面窗口——三项齐了才算部署成功。⚠️ 高频问题现象init卡在下载或报Failed to get system OTA channel。原因到 OTA 源的网络中断或半截镜像包残留在缓存里被复用。 处理清掉缓存目录后重跑 init注意用通配符删文件别误删整个工作目录sudo rm /var/lib/waydroid/cache_http/* sudo waydroid init现象报Downloaded system image hash doesnt match。原因下载的 zip 与渠道元数据里的 SHA256 对不上文件不完整。 处理同样先清缓存再重跑仍复现就说明网络链路丢包换网络环境。现象status正常waydroid launch却报打不开。原因当前终端没有 Wayland 显示环境变量容器找不到宿主机的显示端。 处理在已登录的桌面会话设置好WAYLAND_DISPLAY的 shell里重新执行。跑完这四步waydroid status里那个 RUNNING 就是开头卡住时的终点。两个提醒system.img和vendor.img留在/var/lib/waydroid/images别删这是你下次的免下载备份后续升级镜像直接sudo waydroid upgrade。【免费下载链接】waydroidWaydroid uses a container-based approach to boot a full Android system on a regular GNU/Linux system like Ubuntu.项目地址: https://gitcode.com/gh_mirrors/wa/waydroid创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考