Steam Deck 上 Waydroid 环境的更新、重装与彻底卸载完整指南

【免费下载链接】SteamOS-Waydroid-InstallerScript to easily install / uninstall Android via Waydroid on the Steam Deck running on SteamOS stable, beta or MAIN!项目地址: https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer

在 Steam Deck 上装好 Android 环境只是第一步，真正考验人的是之后的日子：系统更新了要不要重装？游戏闪退要不要重置？玩腻了想彻底删除，又怕删不干净。这套由SteamOS-Waydroid-Installer驱动的 Waydroid 环境，维护起来其实比想象中简单，关键是选对路径。这篇完整指南会带你从"判断处境"开始，一步步走完升级、修复、卸载三条路，并附上常见报错的对照解法，让你以后不再为维护发愁。

先对号入座：你现在属于哪种处境？

别急着敲命令，先花 30 秒定位自己的状态。你的需求基本逃不出下面三种情况：

无论走哪条路，动手前请先过一遍这套前置条件检查表（对应项目里的sanity-checks.sh会自动替你校验）：

• 处于桌面模式，不能在 ssh 或虚拟终端里跑安装脚本
• SteamOS 版本为3.7.x 稳定版或 beta（3.8 及以上有已知风险，见下文避坑红线）
• home 分区剩余空间不少于 10GB
• 已经设置好sudo 密码
• 网络连接正常，能访问镜像服务器

确认无误，就可以放心往下走了。

路径一：安全升级，让 Waydroid 跟上最新版本

先给你吃颗定心丸：Waydroid 的"升级"本质上就是重新拉取最新脚本 + 重跑一遍安装，脚本会自动处理内核模块、Android 镜像下载、ARM 翻译层等一系列脏活累活，你基本只需要负责确认。

第一步：选对分支

项目用main和testing两个分支维护版本，别搞混了：

第二步：重新拉取脚本并安装

打开终端（Konsole），输入下面这组命令升级到稳定分支：

cd ~/ git clone --depth=1 https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer cd ~/SteamOS-Waydroid-Installer chmod +x steamos-waydroid-installer.sh ./steamos-waydroid-installer.sh

想体验测试分支的话，把第一条命令换成带-b testing的版本即可：

git clone --depth=1 -b testing https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer

安装过程大约 5 分钟，取决于网速。另外，桌面上那个Waydroid-Updater快捷方式也是干这件事的，懒得敲命令就双击它。为什么要走"重跑脚本"这条路？因为脚本更新得很勤——从更新日志看，几乎每个月都有新镜像、新翻译层和新游戏兼容修复，旧版本的问题很可能已经被新版本顺手修掉了。

第三步：升级后的验收清单

跑完脚本别急着关，按这个清单确认一下：

• 回到游戏模式，启动Android_Waydroid_Cage看能否正常进入系统
• 在设置里核对 Android 版本号（支持 Android 11 / Android 13 及对应的 TV 版本）
• 装一个游戏实测 ARM 翻译层是否生效，比如《植物大战僵尸 2》

路径二：卸载重装，最高效的排障手段

如果你遇到的是"怎么修都修不好"的疑难杂症，记住一条铁律：先卸载、再安装，往往比硬修快得多。脚本迭代这么快，你踩的坑八成在新版本里已经被填平了。

第一步：通过 Waydroid Toolbox 卸载

在桌面模式下，找到Waydroid Toolbox图标并双击打开，这个工具箱集成了 ADBLOCK（广告拦截）、AUDIO（音频）、SERVICE（服务开关）、GPU（显卡）、LAUNCHER（启动器）、NETWORK（网络）和UNINSTALL（卸载）等多个选项。

选择UNINSTALL后，工具箱会提示你输入 sudo 密码进行授权。这里有一个贴心的小分支值得注意：卸载时可以选择保留 Android 用户数据还是连同数据一起完整卸载。如果你只是想去掉旧配置、重新安装，选"保留数据"就能省去重新登录账号的麻烦。

第二步：重新安装

卸载完成后，回到路径一，重新 clone 最新代码并执行安装即可。整个"卸载—重装"周期大约 5-10 分钟，换来一个干净且最新的环境，这笔账怎么算都划算。

进阶：命令行操作

如果你是喜欢掌控一切的高级用户，也可以直接用 systemd 停掉容器服务：

sudo systemctl stop waydroid-container

不过说句实在话，普通用户完全没必要手动折腾，Waydroid Toolbox 一个选项就能搞定，还不会因为少删了某个配置文件留下后遗症。

路径三：彻底卸载，把 Android 环境干干净净送走

决定彻底告别了？放心，卸载比你想象中温柔，按下面三步走就能还你一个原汁原味的 SteamOS。

第一步：进入桌面模式

按下Steam 按钮 → 电源 → 切换至桌面，等待系统完成切换。为什么要切桌面？因为卸载工具是图形化的，而且脚本本身也要求必须运行在桌面会话里，直接终端操作容易踩坑。

第二步：启动 Waydroid Toolbox 并选择 UNINSTALL

双击桌面上的Waydroid Toolbox，选择UNINSTALL。工具箱会自动完成下面这些操作，全程不需要你操心：

1. 停止 Waydroid 相关服务与容器
2. 卸载已安装的软件包与内核模块
3. 移除 Android 镜像、配置文件与启动项
4. 清理桌面快捷方式并恢复系统只读设置

第三步：卸载后的残留检查

卸载完成后，花一分钟确认没有"尾巴"：

• 桌面和 KDE 菜单里是否还有 Waydroid 相关图标（若有，重启一次一般就消失了）
• ~/Android_Waydroid目录是否已不存在
• /var/lib/waydroid是否已清空

全部干净，恭喜你，存储空间回来了——一个 Android 镜像加应用数据通常能释放2-4GB甚至更多。

常见报错对照表：遇到问题先查这张表

维护路上难免翻车，我把最常见的几个坑整理成了对照表，先自查再求助：

避坑红线：动手前先记住这几件事

• SteamOS 系统更新会清空 Waydroid，这不是 Bug，是 SteamOS 的更新机制决定的。重跑一遍安装脚本就能恢复；如果更新包含新内核，脚本会直接退出等待适配，这种时候别硬来，等项目发布配套模块。
• SteamOS 3.8 及以上版本暂时别用。项目 README 顶部有明确警告，在 3.8 上运行可能破坏桌面模式，动手前务必先确认系统版本。
• 卸载前先备份。游戏存档、重要应用数据、自定义配置，能备份就备份，尤其是选择"完整卸载"之前，数据删了就真没了。
• 动手前看下空间。确保 home 分区至少有 10GB 空闲，免得装到一半磁盘满了，进退两难。

让环境保持健康的日常节奏

维护不需要天天做，但建议养成下面这个轻量级节奏：

• 每月一次：看看项目有没有新提交，顺手做一次升级
• 按需清理：删除不用的 APK 和缓存，保持 Android 内部存储清爽
• 定期备份：重要游戏进度定期导出
• 出了问题先重装：不要长时间带着旧配置硬撑，卸载重装通常五分钟解决

写在最后

说到底，Waydroid 环境的维护没有那么多玄学：想要新功能就升级，出了乱子就卸载重装，不想玩了就彻底删除。把这三条路径记在心里，再加上那张报错对照表，你就是 Steam Deck 上的 Android 管理大师了。别犹豫，现在就打开 Konsole 检查一下你的环境版本，该升级的升级，该清理的清理，让你的掌机始终保持最佳状态。🚀

【免费下载链接】SteamOS-Waydroid-InstallerScript to easily install / uninstall Android via Waydroid on the Steam Deck running on SteamOS stable, beta or MAIN!项目地址: https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer