win11 安卓子系统（WSA）ROOT 安装 Magisk 与谷歌框架

Category（分类）: Backend Status: 已读

原文：win11 安卓子系统（WSA）ROOT安装面具（Magisk）与谷歌框架（秋风于渭水）。 本文为整理版本，保留全部步骤与注意事项。

时效提醒：微软已于 2025 年 3 月 5 日停止 WSA 更新，此后仅提供一年技术支持，大版本停留在 2311（微软大刀部名不虚传）。本文作为 WSA 折腾记录归档。

背景

win11 的安卓子系统（WSA）默认没有 root、没有谷歌框架，应用市场是亚马逊市场（没有 Google Play），直接给 WSA 安装 magisk 又非常麻烦。

LSPosed 的 MagiskOnWSALocal 项目解决了这个问题：通过构建安卓子系统安装包，把 magisk 提前整合进 WSA 安装包。

前提条件

1. 电脑配置需满足 WSA 要求：
   • Windows 11 版本 ≥ 22000.526；Windows 10 需依次安装补丁 KB5014032、KB5022834；
   • CPU 一般要求 Core i3 8XXX / Ryzen 3000 以上（更早的也可能能跑，自行测试）；
   • BIOS/UEFI 已启用虚拟化（任务管理器 - 性能 - CPU 页面显示"虚拟化：已启用"）；
   • 微软商店版本 ≥ 22110.1402.6.0；
   • WSA 默认分配 2G（最大 16G）内存，建议 16G 内存以上的电脑使用；
2. 如已装过 WSA，建议彻底卸载重装；
3. 在「设置 - 应用 - 可选功能 - 更多 Windows 功能」中勾选开启 Hyper-V 和虚拟机平台，安装组件并重启；
4. 构建安装包需要一台 Ubuntu 20.04 LTS / OpenSUSE Leap 15.4 / Debian 11.3+ 的机器（磁盘 ≥ 10GB，能自由访问网络）。可以直接用 WSL2 跑 Ubuntu。不想折腾构建的，直接跳到「本地安装」用预构建安装包。

构建 WSA 安装包

1. 打开 MagiskOnWSALocal 项目，clone 到 Ubuntu：

cd /usr/
git clone https://github.com/LSPosed/MagiskOnWSALocal.git
cd MagiskOnWSALocal
scripts/run.sh

2. 运行构建脚本，按提示选择构建选项（方向键移动、空格选择、回车确认）。

临时措施（2023-07）：保留亚马逊商店的版本更新到 2306/2307 后可能崩溃退出，相关代码未合并主线，直接拉取只能构建到 2305。需要更高版本可手动修改 scripts/build.sh 中三处 WSA_MAJOR_VER 的版本判断（651、675、909 行附近）。

构建选项说明

等待 SSH 输出 Everything is Ok / done / Cleanup Work Directory done 即构建完毕，产物在 /usr/MagiskOnWSALocal/output。

本地安装（预构建包）

原文提供了三个预构建安装包（访问密码 acgmoe）：

• 1 号（安卓 12）：WSA 2210.400000.7.0 + Magisk 25.2 + OpenGApps pico + ROOT + 移除亚马逊市场；
• 2 号（安卓 13）：WSA 2310.40000.2.0 + Magisk 26.4 + MindTheGapps pico + ROOT + 移除亚马逊市场；
• 3 号（安卓 13，作者自用）：WSA 2311.40000.3.0 + Magisk 26.4 + MindTheGapps pico + ROOT + 移除亚马逊市场。

安装步骤：

1. 下载/复制 output 文件夹的全部内容到 win11 本机（网盘下载同理），保留最后可用的压缩包，出问题可覆盖重装；
2. 解压到你喜欢的目录（如 C:\output）。解压出的安装文件夹不可删除——它是 WSA 的工作目录；
3. 双击 run.bat 运行（首次安装可能弹出一个或两个要求同意诊断信息的窗口，都正常）；
4. 安装完毕即可使用带 root、带 Magisk 的安卓子系统。

安装后注意：

• 初始 Magisk 页面里 Zygisk 默认是"否"，要正式使用 LSPosed 还需自行安装 LSPosed-zygisk 模块（与手机上几乎没区别，可能还需要从 zip 里手动找 manager.apk 装进 WSA）；
• WSA 2304 起微软默认用 Windows Defender 扫描新装 APP，Magisk 会被当作恶意应用拦截。新装的 WSA 需进入「适用于 Android™ 的 Windows 子系统设置」，关闭"阻止安装恶意应用"开关，再重跑一次 run.bat；
• WSA 2305 起支持「共享用户文件夹」，把 C:\Users\用户名 的非隐藏文件映射进安卓（.exe 出于安全无法映射）。注意在 WSA 里删除文件不进回收站，且文件操作以 WSA 权限执行可能绕过安全软件实时监控，开启后小心操作。

后续更新 WSA

不要在 Microsoft Store 里更新 WSA。正确姿势：

cd /usr/MagiskOnWSALocal
rm -r download output   # 可选：清缓存
git pull                # 拉最新代码
scripts/run.sh          # 重新构建

然后在 win11：开始菜单 -「适用于 Android™ 的 Windows 子系统设置」- 系统 - 关闭子系统 → 用新 output 内容覆盖原文件夹 → 重新运行 run.bat。脚本会自动保留数据、更新 Magisk。

卸载 WSA

1. 开始菜单 -「适用于 Android™ 的 Windows 子系统设置」- 系统 - 关闭子系统；
2. 点击「重置为默认值」的重置按钮；
3. 开始菜单里对「适用于 Android™ 的 Windows 子系统设置」右键卸载；
4. 备份数据可备份 %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx，配合 WSAHelper 可恢复开始菜单里的 APP 图标。

常见问题

1. Failed to connect to the host ... Network is unreachable（IPv6 地址）：微软服务器解析出的 IPv6 不可用，最快的办法是关闭网络的 IPv6；
2. TLS handshake timeout / connection reset by peer / dns lookup failed 等一堆连接报错：全是网络问题，需开代理——要么 TUN 模式、要么 WSL2 里设全局代理、要么路由器全局模式；
3. Magisk 里装好 LSPosed 重启后模块消失 / VPN 授权弹窗不弹（>2309 版本易发）：
   • 无脑解法：彻底卸载新版 WSA，先装旧版（2301/2304 等）+ LSPosed，再升级到新版（从旧版升级不触发）；
   • 不想重装：按 GitHub 上的对应 issue 操作；
4. WSA 突然只有 x86_64 架构的 APP 能运行：本质是配置问题，需干净重装——关闭子系统 → 任务管理器结束残留进程（如 WSACrashUploader.exe）→ 删掉 WSA 安装文件夹全部内容（删不掉说明有残留进程）→ 覆盖新内容 → 重跑 run.bat。

系列文章

原文所在的 win11 安卓子系统系列（同站）：

1. win11 安卓子系统（WSA）ROOT安装面具（Magisk）与谷歌框架（本文）
2. Windows Android 子系统 WSA 代理设置方法教程
3. 解决Win11安卓子系统烦人的提示"VirtWifi的连接受限"
4. Windows 11 Android 子系统 WSA 安装APP软件APK文件方式教程
5. 为 win11 安卓子系统（WSA）内 APP 设置桌面快捷方式