Waydroid是基于Linux命名空间和LXC容器运行完整Android系统的开源模拟器，内置定制LineageOS镜像，支持ARM/x86多平台，深度集成Wayland，使安卓应用直接出现在Linux应用列表并自由调整窗口。
如果您希望在Linux桌面系统中直接运行Android应用程序，而无需虚拟机或双系统，Waydroid提供了一种基于Linux容器（LXC）与Wayland协议的原生级安卓运行环境。以下是实现该目标的多种可行路径：
一、通过官方软件源安装Waydroid
此方法适用于Ubuntu/Debian系发行版，依赖管理由包管理系统自动处理，适合新手用户快速部署。
1、更新系统软件包索引并安装基础工具：
sudo apt update && sudo apt install curl ca-certificates -y
2、添加Waydroid官方GPG密钥及软件源：
sudo curl -# --proto '=https' --tlsv1.2 -Sf https://repo.waydro.id/waydroid.gpg --output /usr/share/keyrings/waydroid.gpg echo "deb [arch=amd64 signed-by=/usr/share/keyrings/waydroid.gpg] https://repo.waydro.id/$(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/waydroid.list
3、刷新源列表并安装Waydroid主程序：
sudo apt update && sudo apt install waydroid -y
4、执行初始化，下载默认Android系统镜像：
sudo waydroid init
二、使用Git源码方式部署Waydroid
该路径可获取最新开发版本，支持自定义构建参数，适用于需要调试、定制或使用非标准镜像（如GApps版）的用户。
1、安装构建依赖：
sudo apt install git lxc python3 adb wget curl -y
2、克隆Waydroid官方镜像仓库：
git clone https://gitcode.com/gh_mirrors/wa/waydroid.git && cd waydroid
3、运行Python初始化脚本：
sudo python3 tools/initializer.py
4、启用并启动容器服务：
sudo systemctl enable --now waydroid-container.service
三、Arch Linux及AUR用户专用安装流程
Arch系用户需手动加载Binder内核模块，并通过AUR助手安装配套组件，确保Android运行时底层驱动就绪。
1、安装binder_
linux
内核模块：
yay -S binder_linux-dkms Docker Desktop（linux）
当前 Docker 最新稳定版本之一，主要针对稳定性和兼容性进行了修复优化，适合生产环境与日常开发使用。该版本继续强化 AI 开发支持、容器日志管理以及 Docker Engine 的安全能力，对 Windows/macOS/Linux 平台兼容性进行了进一步优化。
下载
2、安装Waydroid主程序及含Google服务的镜像：
yay -S waydroid waydroid-image-gapps
3、初始化并启用容器服务：
waydroid init -s GAPPS sudo systemctl enable --now waydroid-container.service
四、启动与运行Android应用
无论采用哪种安装方式，完成初始化后均需启动会话服务并加载UI界面，方可交互使用。
1、启动Waydroid会话后台进程：
waydroid session start
2、显示完整Android图形界面：
waydroid show-full-ui
3、通过ADB安装APK应用：
adb install /path/to/app.apk
4、启动已安装的应用（以包名为准）：
waydroid app launch com.example.app
五、网络异常时的应急修复措施
若启动后Android系统无法联网，通常因网络桥接未正确配置，需手动运行网络初始化脚本。
1、切换至Waydroid项目目录（若为源码安装）：
cd /path/to/waydroid
2、执行网络桥接配置脚本：
sudo bash data/scripts/waydroid-net.sh
3、重启容器服务以应用变更：
sudo systemctl restart waydroid-container.service