企业官网建设流程全解析

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

SteamOS-Waydroid-Installer 是专为 Steam Deck 打造的一站式安卓环境安装脚本，它基于 Waydroid 容器技术，让你在 SteamOS 上直接运行安卓应用与游戏，并通过图形化的 Waydroid Toolbox 完成卸载、网络、音频等日常维护。无论你是刚接触掌机的安卓新手，还是已经玩了一阵想清理环境的老玩家，这篇指南都会带你安全地卸载或升级这套安卓环境。

先想象一个真实场景：你昨天还在 Steam Deck 上通过 Waydroid 玩《植物大战僵尸 2》，今天一开机却发现安卓环境打不开了；又或者你只是想腾出几个 GB 的存储空间，却不知道该从哪个图标下手。别急，看完这篇文章你就能自己搞定。

先看这张表：你的目标该走哪条路

不同诉求对应的操作完全不同，先对号入座，再往下翻到对应章节，能省下大量试错时间。

动手之前：先搞懂这三件事，操作时心里才有底

卸载不等于破坏 SteamOS。Waydroid 采用容器方案，安卓系统跑在独立容器里，卸载动作只清理安卓相关的组件和镜像，不会触碰 SteamOS 本体，所以大胆操作即可。

卸载有两种"颗粒度"。Waydroid Toolbox 的 UNINSTALL 选项会先问你要不要保留安卓用户数据：选"保留"，下次重装还能找回应用与存档；选"彻底清空"，则连同镜像和配置一起抹掉，释放最干净的空间。

升级不完全等于重装。项目的更新脚本 Waydroid-Updater 会自动拉取最新代码并重新安装，过程中保留你的数据配置，这是绝大多数人最省心的升级方式。

图形化卸载：5 分钟用 Waydroid Toolbox 清理安卓环境

这一步在做什么。通过安装脚本自带的维护工具 Waydroid Toolbox，以图形界面完成卸载，避免手动删除文件时漏掉残留配置。

为什么要用工具箱。它内置了完整的卸载流程：停止服务、移除容器与安卓镜像、清理配置文件、恢复系统设置，一条龙处理，比逐个敲命令安全得多。

操作步骤。按下面五步走：

1. 按下 Steam 按钮，选择"电源 → 切换至桌面"，进入桌面模式。
2. 在桌面或应用程序菜单中找到名为Waydroid Toolbox的图标，双击打开。
3. 在图形界面中选择UNINSTALL选项。
4. 按提示输入你的 sudo 密码完成权限验证。
5. 在弹出的确认中选择"保留数据"或"彻底清除"，然后等待进度条跑完。

预期结果。安卓容器、镜像与配置文件被移除，桌面上的 Waydroid 相关快捷方式也会一并清理。整个过程大约 2–5 分钟，完成后回到游戏模式即可。

命令行卸载：不想开图形界面时的备选方案

如果你更习惯终端操作，或图形界面打不开，也可以手动停止并清理 Waydroid 服务：

# 停止 Waydroid 容器服务，这是卸载前必须做的一步 sudo systemctl stop waydroid-container.service # 分别结束会话与容器进程，确保没有残留进程占用 sudo waydroid session stop sudo waydroid container stop # 移除 Waydroid 主程序包（如需连用户数据一起清理可再加 --noconfirm） sudo pacman -Rns waydroid

需要说明的是，手动卸载适合应急和排障；日常使用仍推荐工具箱，因为脚本还会顺带清理~/Android_Waydroid目录、系统服务配置和菜单残留，手动方式容易遗漏。

版本升级的两条路：一键更新脚本与重装式更新

路径一：Waydroid-Updater 一键更新（推荐多数人使用）

安装完成后，脚本会在~/Android_Waydroid目录放下Waydroid-Updater.sh，同时在桌面生成同名快捷方式，双击或在终端运行即可：

# 进入存放 Waydroid 维护脚本的目录 cd ~/Android_Waydroid # 运行更新脚本：自动拉取最新代码并重新安装，保留你的数据 ./Waydroid-Updater.sh

脚本会完成"克隆最新仓库 → 全新安装 → 保留数据配置"整套动作。适合希望始终停留在最新稳定版、又不想折腾手动步骤的人。

路径二：重新克隆再安装，适合想顺手排障的人

如果你遇到过疑难问题，官方建议的排查思路就是"先卸载、再克隆最新仓库重新安装"，因为新版本可能早已修复了你遇到的 bug：

# 回到主目录 cd ~/ # 克隆最新稳定版仓库（main 分支） 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

安装过程中脚本会自动检测到这是一次重装，直接复用已有数据并补齐缺失的配置，全程大约 5 分钟，视网速而定。安装结束后会询问是否返回游戏模式，届时即可在游戏模式中通过 Waydroid 启动器进入安卓环境。

路径三：testing 分支尝鲜，适合想提前体验新功能的人

新功能会先在 testing 分支停留一到两周打磨，想抢先体验就克隆这个分支：

# 克隆 testing 分支，其中的功能会比稳定版更新 git clone --depth=1 -b testing https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer

克隆后同样进入目录、执行脚本即可。注意 testing 分支可能存在尚未修复的问题，尝鲜前记得备份重要数据。

避坑区：报错现象与解决办法对照表

下面这些是社区里最高频的报错，遇到时先对照这张表，别急着重装系统。

另外要提醒一句：由于 AUR 出现恶意软件事件，作者出于安全考虑已暂时停用了安装脚本主程序，并明确警告旧版本在 SteamOS 3.8.x 上会破坏桌面模式。如果你正处于 3.8.x，请耐心等待作者推送适配更新，不要强行绕过限制运行。

高频问题 Q&A

Q1：卸载 Waydroid 会不会把 SteamOS 弄坏？不会。Waydroid 运行在独立容器中，卸载只清理安卓相关组件与镜像，SteamOS 系统和你的游戏库不受影响。

Q2：卸载时想保留安卓应用数据，该怎么做？在 Waydroid Toolbox 的 UNINSTALL 步骤中选择"保留数据"即可，下次重装后应用和数据仍可找回。

Q3：一键升级会弄丢游戏存档吗？Waydroid-Updater 默认保留数据，正常情况下存档不丢。不过跨大版本升级前，稳妥起见建议先做一次备份。

Q4：SteamOS 系统更新后 Waydroid 没了，是装坏了吗？不是。这是 SteamOS 更新机制的正常现象，容器会被重置。重新运行安装脚本就能恢复，不需要额外排查。

Q5：怎么快速确认 Waydroid 当前是否正常运行？在终端执行sudo systemctl status waydroid-container.service查看服务状态，或用journalctl -u waydroid-container查看最近日志定位问题。

定期维护与最佳实践

每月做一次版本检查。关注项目更新节奏，稳定版每月都会合并测试分支的修复，保持更新能持续获得新功能、性能优化和安全修复。

升级前看一眼更新日志。仓库 README 的 "What's New" 会列出本次更新的重点，比如新增的安卓版本支持、ARM 转译层改进、热门游戏的兼容性修复，确认是否值得立刻升级。

养成备份习惯。重装或升级前，把~/Android_Waydroid目录和重要存档复制到外部存储，成本很低，关键时刻能救急。

效率小贴士

• "先卸载再安装"是排障最快的组合拳。遇到疑难问题别纠结，先卸载再重跑脚本，多数问题就此解决。
• 善用"保留数据卸载"做配置重置。当你只是想清掉旧的错误配置、又不想丢应用时，这是比手动改配置更干净的选择。
• 用日志代替猜谜。任何异常都先看journalctl -u waydroid-container，日志里通常直接写明原因，省去反复试错。

收尾清单：现在就照着做

• 最常用的三个命令：./Waydroid-Updater.sh（一键升级）、sudo systemctl stop waydroid-container.service（应急停服）、journalctl -u waydroid-container（查日志）。
• 最常踩的三个坑：在 SteamOS 3.8.x 上强跑旧脚本、在 ssh 会话里运行安装脚本导致快捷方式丢失、下载慢时直接关终端而不是Ctrl+C后重跑。
• 最推荐的动作：日常升级用 Waydroid-Updater；想彻底清理或排障时，先用工具箱卸载，再克隆最新仓库重装。

读完这篇文章，你的下一步很简单：先对照开头的决策表明确自己的目标，然后按对应章节操作。如果是例行升级，打开 Waydroid-Updater 点一下就好；如果是遇到问题，就走"卸载 → 克隆最新仓库 → 重装"的完整闭环。记住，定期更新能让你始终享受最新的功能与修复，而规范的卸载则能保证系统长久的稳定性。

【免费下载链接】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