Hotdry.
systems-engineering

WSABuilds:预构建的带 Magisk/KernelSU Root 的 WSA 二进制包

WSABuilds 项目提供 Win10/11 上即用型 WSA 镜像,内置 Magisk/KernelSU root 与 MindTheGapps GApps,无需手动内核补丁或侧载 GApps,实现一键部署 Android 子系统。

Windows Subsystem for Android (WSA) 是微软为 Win10/11 提供的 Android 运行环境,但官方版本不支持 root 或 Google Play 服务,导致部署复杂。WSABuilds 项目通过预构建镜像解决此痛点,直接集成 Magisk 或 KernelSU root 解决方案及 MindTheGapps GApps,用户无需手动修补内核镜像或侧载应用商店,即可快速启动完整 Android 生态。该方案特别适合开发者测试、逆向工程或运行需 root 的工具,显著降低门槛。

WSABuilds 的核心优势在于 “即插即用”。项目维护者 MustardChef 在 GitHub 上提供 LTS(长期支持)和稳定版镜像,例如最新 v2407.40000.4.0 LTS_7,支持 Win11 x64/arm64 和 Win10 x64。镜像已预装 root:Magisk(默认)或 KernelSU(可选),并可选集成 GApps(MindTheGapps,避免 OpenGApps 兼容问题)。据 repo 统计,该项目获 14.4k 星标、2.1k fork,证明社区认可。相比手动使用 MagiskOnWSALocal 脚本修补,WSABuilds 避免了依赖 GitHub Actions 或本地构建的风险,直接下载 .7z 包提取运行。

实际证据显示部署高效。安装只需 5-10 分钟:下载对应架构镜像(如 Win11 x64 LTS),用 7-Zip 解压至 WSA 文件夹,重命名为 WSA,运行 Run.bat(需管理员权限)。脚本自动注册 Appx 包、启用虚拟化(VMP/HVP),并保留 userdata.vhdx 数据。更新时覆盖文件再运行 Run.bat,即可零丢失升级。repo 提供 100+ 应用兼容表(如 Telegram、VLC 完美运行,部分游戏需 GMS),及 20+ 故障指南(如 0x80073CF6 错误修复)。近期 Windows 更新(如 7 月后)曾破坏 WSA,项目建议用 NoGApps 版或旧版 2211 绕过。

为确保可落地,遵循以下参数与清单:

硬件 / 系统阈值:

  • Win11 Build ≥22000.526 或 Win10 22H2 (19045.2311+),推荐 NTFS C 盘 ≥10GB 空闲。
  • RAM ≥8GB(推荐 16GB),CPU 支持虚拟化(BIOS 启用 VT-x/AMD-V)。
  • GPU:Intel/AMD/NVIDIA 均可,Intel HD 530 前或 NVIDIA 需切换 Microsoft Basic Renderer(详见 GPU 指南)。

部署清单(一键脚本优先):

  1. 确认 “可选功能” 中启用 “虚拟机平台” 和 “Windows 虚拟化平台”。
  2. 下载 LTS(如 Windows_11_2407.40000.4.0_LTS_7.7z)或稳定版,从 GitHub Releases 或 OneDrive 镜像。
  3. 解压至 Documents/WSA,重命名文件夹,避免路径过长(<260 字符)。
  4. 以管理员运行 WSA/Run.bat;若 PowerShell 闪退,手动 cd 目录执行 PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1
  5. 首次启动同意诊断,WSA 设置中开启开发者模式(ADB 端口 58526)。
  6. 测试 root:ADB shell su,Magisk Manager 或 KernelSU App 应可见。

Root/GApps 参数优化:

  • Root 选择:Magisk 通用,KernelSU 内核级更隐蔽(安装指南:下载 KernelSU Manager,ADB push 模块)。
  • GApps:MindTheGapps 轻量(~200MB),Play Store 登录需伪装非模拟器(可选 Shamiko 模块隐藏 root)。
  • 监控阈值:CPU 使用 >80% 降级分辨率;网络:ADB connect localhost:58526,若拒连用 IP:5555。
  • 备份:复制 %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx
  • 回滚:若更新冲突,卸载(设置卸载 + 删除 Packages 文件夹),恢复 vhdx 后重装旧版。

高级配置清单:

配置项 参数值 目的
ADB 连接 adb connect 127.0.0.1:58526 调试 / 侧载
侧载 APK WSA-Sideloader 或 adb install app.apk 安装非 Play 应用
移动分区 MoveToExtDrive.md 脚本 移至 D 盘节省 C 空间
BusyBox ADB shell 安装模块 shell 增强
Loopback 编辑 hosts 添加 127.0.0.1 localhost 内网访问

风险控制:微软 2025 年 3 月 5 日终结 WSA 支持,LTS 版保持 Magisk/KernelSU/GApps 更新,但 Windows 更新可能破坏(监控 #593 issue)。无 GApps 版避开 Play Integrity 检测失败。自定义构建:Issues 申请指定设备模型 /root 变体。

WSABuilds 使 WSA 从 “实验玩具” 变 “生产工具”,开发者可无缝运行 Termux、LSPosed 等。未来若 WSA 弃用,可迁移 MagiskOnWSALocal 自建。

资料来源:

(正文 1250+ 字)

查看归档