waydroid与docker共存问题解决方案

本方案基于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

第二步：配置开机自动加载（永久修复）

echo"nft_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*2>&1

若lsmod无输出，且/dev/loop*不存在（只有/dev/loop-control），说明模块未加载。

修复步骤

第一步：当前会话立即生效

sudomodprobe loop

第二步：配置开机自动加载（永久修复）

echo"loop"|sudotee/etc/modules-load.d/loop.conf

验证修复

lsmod|greploopls/dev/loop*# 应能看到 /dev/loop0、/dev/loop-control 等设备

一步修复两个问题

如果你的系统同时缺少以上两个模块，可以依次执行：

# 立即加载（当前会话生效）sudomodprobe nft_masqsudomodprobe loop# 配置开机自动加载（重启后永久生效）echo"nft_masq"|sudotee/etc/modules-load.d/nft_masq.confecho"loop"|sudotee/etc/modules-load.d/loop.conf

然后重启 waydroid 服务并启动 session：

sudosystemctl 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

适用环境

不保证其他发行版可以成功。