企业官网建设流程全解析

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 打造的开源脚本，让你在 SteamOS 上快速安装、卸载 Android 环境（Waydroid）。本篇文章将完整解答一个核心问题：什么时候该卸载、什么时候该升级，以及每一步具体怎么操作。无论你是想彻底移除 Android、解决运行异常，还是只想把版本更新到最新，这份 Waydroid 卸载与升级指南都能帮你一次搞定，全程不踩坑。

全局视图：一次看懂 Waydroid 维护的全生命周期

维护 Waydroid 这件事，本质上只有五件事：判断、备份、执行、验证、恢复。把顺序理清楚，后面每个操作都不会乱。

整个流程可以概括为一条主线：先评估现状 → 再备份数据 → 然后执行卸载或升级 → 验证结果 → 最后处理意外。下文就沿着这条主线逐步展开。

先判断再动手：何时该卸载、何时该升级 Waydroid

很多人一上来就点卸载或更新，其实多数问题根本不需要走"重来一遍"的极端路线。先用下面这张对照表给自己的情况归类，能省下大量时间。

判断时请记住两个原则：

1. 升级解决不了的问题，才考虑重装。脚本本身迭代很快，很多 bug 早就修好了，你只是还在用旧版本。
2. 卸载分两种强度。一种是保留 Android 用户数据只移除系统组件，适合想快速重装的情况；另一种是连应用数据一起彻底清除，适合换镜像、彻底清理或卖机前抹除。动手前先想清楚你要哪种。

卸载前的数据备份清单与风险评估

无论你打算卸载还是重装，先花十分钟把数据保住，这是整个过程中最不值得省的一步。

建议备份的内容

• Android 应用数据：游戏内购记录、账号登录态、应用内设置，卸载后无法找回。
• 游戏存档：单机游戏的进度，部分游戏支持云存档，但别赌。
• 自定义配置：你在 Waydroid 里改过的按键映射、显示设置等。

提前确认的三项前提条件

在执行任何维护操作前，先确认以下三项，避免操作到一半被迫中断：

• SteamOS 版本：脚本支持 SteamOS 3.7.x 及部分 3.8 分支，过低或过高的版本会被拦截。
• 存储空间：home 分区至少留出 10GB 可用空间，否则脚本会在预检阶段直接退出。
• sudo 密码：SteamOS 默认没有启用 sudo 密码，未设置时脚本会先引导你设置。

风险提示

• 卸载是单向操作，一旦彻底卸载，应用数据不可恢复，所以备份必须放在卸载之前。
• 整个维护过程建议在桌面模式下进行，通过 SSH 或虚拟终端运行脚本会导致后续快捷方式添加失败。
• 如果你装了 Decky Loader，脚本会自动临时停用其服务并在结束时恢复，这是正常现象，不用手动干预。

桌面模式下完成 Waydroid 安全卸载的操作步骤

当你确认要走卸载这条路时，标准做法是使用安装时生成的图形化管理面板Waydroid Toolbox，而不是手动去删文件。直接删除 vs 标准卸载的区别在于：标准卸载会同步清理服务、内核模块、系统配置和桌面快捷方式，而手动删除很容易留下残留。

操作步骤

1. 按下 Steam 按钮，选择"电源 → 切换至桌面"，进入桌面模式。
2. 在桌面上找到Waydroid Toolbox图标并双击打开。
3. 在选项列表中选择UNINSTALL。
4. 根据提示选择卸载强度：保留 Android 用户数据，或连数据一起完全清除。
5. 按提示输入 sudo 密码，等待自动清理完成，整个过程约 2～5 分钟。

出问题怎么办

• 双击无反应：检查是否在桌面模式下操作，部分环境需要先从应用菜单启动终端手动执行~/Android_Waydroid/Waydroid-Toolbox.sh。
• 提示密码错误：重新输入，确认键盘布局没有把密码打错。
• 卸载中途卡住：等待 1～2 分钟再判断，脚本在删除镜像文件时可能短暂无输出；若长时间无响应，可开新终端查看系统日志定位问题。

卸载后如何验证 Waydroid 是否清理干净

卸载不等于结束，验证清理结果这一步能帮你确认系统回到了干净状态，也为后续重装铺平道路。

验证清单

验证时建议按顺序从上往下过一遍。如果发现桌面图标还在，先重启一次 Steam Deck，部分图标缓存需要重启才能刷新。

Waydroid 升级失败的快速恢复方法

升级 Waydroid 通常指的是升级 Android 镜像，也就是把你运行的 Android 版本更新到包含最新修复的版本。安装时脚本会在桌面生成Waydroid Updater的入口，双击即可启动升级流程，它会自动拉取新版镜像并尽量保留你的数据配置。

升级失败时的处理顺序

1. 先别慌，看网络：镜像下载依赖外网，慢速镜像源会让下载看起来像卡死。此时按Ctrl+C取消，重新运行升级即可，脚本会重新选择下载源。
2. 确认存储空间：下载新版镜像需要额外空间，如果 home 分区剩余不足，升级会在预检阶段报错退出，先清理再重试。
3. 查看日志：安装脚本会在运行目录生成logfile，升级异常时优先查看这里的报错信息。
4. 执行重装兜底：如果升级反复失败，最稳妥的恢复方案是先完整卸载，再重新获取最新代码安装。这能同时解决"旧脚本 + 新镜像"不匹配的问题。

重装用的标准命令

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

SteamOS 更新后 Waydroid 消失的重装流程

很多用户第一次遇到"Waydroid 不见了"都会以为是自己操作失误，实际上这是 SteamOS 的更新机制导致的正常现象：SteamOS 系统更新时会重写系统分区，Waydroid 及其配置随之被清除。

应对流程

1. 确认 SteamOS 已更新到最新版本。
2. 重新获取脚本代码并运行安装脚本，选择你需要的 Android 镜像类型。
3. 安装完成后回到游戏模式，重新运行 Waydroid 启动器。

这里有一个需要特别留意的分支情况：如果 SteamOS 更新升级了内核版本，安装脚本会在预检阶段直接退出。原因是 Waydroid 依赖的 binder 内核模块需要匹配对应内核，脚本内置的模块不适用于新内核。此时不要反复重试，正确的做法是把你的 SteamOS 版本信息记录下来，等待项目更新支持后再安装。

关于测试分支

项目采用main和testing双分支策略：新功能先在testing分支验证 1～2 周，稳定后再合并到main。如果你想提前体验新特性，可以使用测试分支安装：

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

想追求稳定则优先使用main分支。需要提醒的是，测试分支可能存在未修复的问题，追求稳定的用户建议等待正式合并。

避坑提醒：新手最容易踩的五个坑

结合脚本的预检逻辑和大量用户反馈，下面五件事是最常出问题的环节：

1. 在 SSH 或虚拟终端里运行脚本。脚本会直接拒绝执行，即使强行运行，游戏模式的快捷方式也会添加失败。务必在桌面模式的终端（Konsole）中操作。
2. 忽略 sudo 密码。SteamOS 出厂默认未设置 sudo 密码，脚本会先引导你设置。请记住这个密码，后续卸载和升级都会用到。
3. 不看版本直接装。脚本对 SteamOS 版本有硬性要求，不满足条件的系统会在最开始被拦下，反复强行运行没有意义。
4. 下载慢就以为卡死。镜像走 SourceForge 等外部源，慢速镜像很常见，Ctrl+C取消重跑往往就能解决，不需要做任何系统级改动。
5. 以为 SteamOS 更新后 Waydroid 还在。更新即清空是正常机制，不需要怀疑安装出了问题，按重装流程处理即可。

Waydroid 维护常见问题 FAQ

问：Waydroid 卸载后，Steam Deck 上的其他数据会受影响吗？不会。卸载流程只清理 Waydroid 相关的服务、镜像、配置和快捷方式，不涉及 Steam 游戏库和系统其他数据。

问：只卸载 Waydroid 但保留 Android 数据，以后还能恢复吗？可以。选择保留数据模式的卸载会留下 Android 用户数据，之后重新运行安装脚本并选择相同类型的镜像，数据可以继续使用。

问：升级到一半断网了，会损坏系统吗？不会。下载中断最多导致镜像文件不完整，脚本会通过校验检测到异常并提示重试，不会破坏 SteamOS 本身。

问：为什么安装脚本有时会自动停用 Decky Loader？这是脚本的预检保护机制。Decky Loader 可能与安装流程冲突，脚本会临时停用其服务并在安装结束后自动恢复。

问：彻底不想用了，卸载之后还需要手动清理什么吗？标准卸载已经覆盖了服务、目录和快捷方式。如果之后发现桌面残留图标，重启一次即可刷新。

核心要点总结

最后把整篇 Waydroid 卸载与升级指南浓缩成几句话，方便你日后快速回忆：

• 先判断再动手：能用升级解决的问题，不要轻易选择完整卸载。
• 备份永远在操作之前：应用数据和游戏存档一旦清除无法找回。
• 卸载认准 Waydroid Toolbox 的 UNINSTALL，选择保留数据或彻底清除要看你的下一步计划。
• 每次操作后都要验证：图标、服务、目录逐项检查，确认系统状态符合预期。
• 升级失败先查网络与空间，仍不行就完整卸载后重新安装。
• SteamOS 更新清空 Waydroid 是正常行为，按重装流程处理即可；若遇新内核导致脚本退出，请等待项目适配后再操作。

维护 Waydroid 并不复杂，核心就是"判断—备份—执行—验证—恢复"这条闭环。按这份指南操作，无论是卸载、升级还是重装，你都能从容应对。记住：动手前备份、动手后验证，两步做到位，Steam Deck 上的 Android 环境就能一直处于顺手好用的状态。

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