本方案基于Linux CachyOS 6.19.3-2-cachyos实现并且症状是未使用docker的时候可以正常开启waydroid使用docker的时候则无法正常使用waydroid。执行waydroid session start后 session 无法启动waydroid status显示Session: STOPPED。首先查看详细日志确认错误类型tail-80 /var/lib/waydroid/waydroid.log故障一nftables masquerade 规则失败症状日志出现以下错误RuntimeError: Command failed: % /usr/lib/waydroid/data/scripts/waydroid-net.sh start ... Error: Could not process rule: No such file or directory ... Failed to setup waydroid-net.原因nft_masq内核模块未加载导致 waydroid 在设置网络时无法创建 NAT masquerade 规则。该模块在某些发行版如 CachyOS、Arch Linux上不会随系统启动自动加载。验证lsmod|grepnft_masq若无任何输出说明模块未加载。修复的步骤第一步当前会话立即生效sudomodprobe nft_masq第二步配置开机自动加载永久修复echonft_masq|sudotee/etc/modules-load.d/nft_masq.conf验证修复lsmod|grepnft_masq# 应输出类似nft_masq 12288 1故障二loop 回环设备不可用导致镜像挂载失败症状日志出现以下错误通常在故障一修复后出现RuntimeError: Command failed: % mount -o ro /usr/share/waydroid-extra/images/system.img /var/lib/waydroid/rootfs ... mount: /var/lib/waydroid/rootfs: 设置回环设备失败原因loop内核模块未加载系统中没有可用的/dev/loop*设备导致无法将system.img/vendor.img以回环方式挂载。验证lsmod|greploopls/dev/loop*21若lsmod无输出且/dev/loop*不存在只有/dev/loop-control说明模块未加载。修复步骤第一步当前会话立即生效sudomodprobe loop第二步配置开机自动加载永久修复echoloop|sudotee/etc/modules-load.d/loop.conf验证修复lsmod|greploopls/dev/loop*# 应能看到 /dev/loop0、/dev/loop-control 等设备一步修复两个问题如果你的系统同时缺少以上两个模块可以依次执行# 立即加载当前会话生效sudomodprobe nft_masqsudomodprobe loop# 配置开机自动加载重启后永久生效echonft_masq|sudotee/etc/modules-load.d/nft_masq.confecholoop|sudotee/etc/modules-load.d/loop.conf然后重启 waydroid 服务并启动 sessionsudosystemctl restart waydroid-container waydroid session start确认启动成功waydroid status正常输出应为Session: RUNNING Container: RUNNING Vendor type: MAINLINE IP address: 192.168.240.x Session user: 你的用户名 Wayland display: wayland-0适用环境项目说明发行版Arch Linux、CachyOS、Manjaro 及其他使用 nftables 的系统内核类型标准内核、CachyOS-bore 等模块化内核Waydroid 版本适用于使用waydroid-net.sh的所有版本不保证其他发行版可以成功。