Waydroid 折腾记录（安卓兼容环境）

Waydroid 折腾记录（安卓兼容环境）

日期: 2026-08-11
机器: ryzen5-5500u · Debian 13 (trixie) · 14GiB 内存
目的: 不用模拟器（太重），用容器方案跑 Android，让 Flutter 直接调试 APK

方案选型

Waydroid 是 LXC 容器，Android 进程和主机共用内存（类似普通进程），不像模拟器固定圈走几 GB。桌面空置时几乎不占内存，跑 Flutter 调试 APK 也就多几百 MB。

安装过程

1. 添加 USTC backports 源

binder 内核模块内核自带（binder_linux.ko.xz，零编译），但 Debian 13 正式源里没有 waydroid，要加 backports：

# /etc/apt/sources.list 追加一行deb http://mirrors.ustc.edu.cn/debian/ trixie-backports mainsudoaptupdatesudoaptinstallwaydroid# 版本: 1.6.3+ds-2~bpo13+1

2. 加载 binder 模块（anbox 命名）

waydroid init时 LXC 会挂载 binder 节点，设备名不对会失败，所以用 anbox 命名加载：

# /etc/modules-load.d/binder_linux.confbinder_linux# /etc/modprobe.d/binder_linux.confoptions binder_linuxdevices=anbox-binder,anbox-vndbinder,anbox-hwbinder# 立即生效sudomodprobe-vbinder_linux

3. waydroid init — 镜像下载（最大坑）

waydroid init下载官方镜像，SourceForge 巨慢（~35KB/s），镜像站基本没有。两条关键经验：

1. SourceForge 拦浏览器 UA（403），但对 Python urllib 默认 UA 放行。用 Python 拿真实签名 URL（resp.geturl()，带 e/st 时间戳参数），再丢给下载器。
2. aria2 挂代理实测 9.3MB/s（代理http://192.168.31.82:7890；curl 走该代理 TLS 会握手失败，aria2 反而正常）。

# 用 Python 拿真实 URL → aria2 -x16 --all-proxy 下载python3 -<<'PY' import urllib.request url = "https://sourceforge.net/projects/waydroid/files/images/lineage/20260403/system.zip/download" resp = urllib.request.urlopen(url) print(resp.geturl()) # 真实带签名的 zip 地址 PYaria2c-x16-s16--all-proxy=http://192.168.31.82:7890'上面拿到的真实URL'

• system zip: 838MB → system.img 1.8G
• vendor zip: 189MB → vendor.img 536M
• 放到/etc/waydroid-extra/images/，再跑sudo waydroid init即秒过

下载中途失败先清残留再重来（坏文件会导致 init 校验失败）：

sudorm-rf/var/lib/waydroid /etc/waydroid-extra/images/*sudowaydroid init# 重新来

4. 启动 + adb 授权（免 RSA）

sudosystemctlenable--nowwaydroid-container waydroid session start# 注意: bash 命令超时会被杀, 用 setsid 保活

Waydroid 默认ro.adb.secure=1（adb 要求 RSA 授权，命令行授权麻烦），改成 0 直接免授：

# /var/lib/waydroid/waydroid.cfg [properties] ro.adb.secure = 0 persist.service.adb.enable = 1 # 同时开自动 adb 输出 auto_adb = True

之后：

adb devices# 192.168.240.112:5555 device ← 直接用, 无需 authorizeflutter devices# WayDroid x86 64 Device (mobile) • 192.168.240.112:5555 • android-x64 • Android 13 (API 33)

5. 开机自启 + 桌面快捷方式

会话自启（容器 service 已开机自启，这是用户态部分）：

• /home/a1/bin/waydroid-autostart.sh：轮询等容器 RUNNING → 若会话没跑则setsid waydroid session start
• ~/.config/autostart/waydroid-session.desktop指向它

桌面快捷方式：

• /home/a1/桌面/安卓桌面.desktop→/home/a1/bin/waydroid-desktop.sh
• 脚本逻辑：会话没跑就setsid waydroid session start并等 5s →waydroid show-full-ui全屏

APK 双击安装：系统自带waydroid.app.install.desktop，已是.apk默认处理器，双击即装。

内存实测（开机后）

结论：Waydroid 不预分配内存，Android 进程视负载在主机池里动态取用，桌面空置时基本不占。

注意事项

1. 会话生命周期：bash/终端命令超时被 kill 会导致容器 FROZEN 或会话偶发停止，恢复用sudo waydroid container stop/start+setsid waydroid session start。重启机器后自启用不上就手动跑一次waydroid-desktop.sh。
2. 镜像源：waydroid 镜像只有官方 SourceForge，无国内镜像站；只能挂代理 + Python 拿真实 URL 加速。
3. Flutter debug 版构件（未解决）：mirrors.huaweicloud.com/flutter缺 io.flutter debug 构件，flutter run -d waydroid的 debug 构建会失败；release 构建无碍。已装 APK 是 release 版。
4. 系统镜像版本：lineage-20.0 VANILLA（无 GMS），Android 13 API 33。