WSABuilds 中 KernelSU 的安装与使用指南从预构建包到 ADB 一键安装【免费下载链接】WSABuildsRun Windows Subsystem For Android on your Windows 10 and Windows 11 PC using prebuilt binaries with Google Play Store (MindTheGapps) and/or Magisk or KernelSU (root solutions) built in.项目地址: https://gitcode.com/GitHub_Trending/ws/WSABuildsKernelSU 是一种基于内核的 Android 根解决方案与常见的用户态 root 方案如 Magisk不同它以内核模块的形式运行因此在 WSAWindows Subsystem for Android环境中具有更高的隐藏能力和更低的资源开销。本文以 MagiskOnWSA/docs/Guides/KernelSU.md 为核心结合 MagiskOnWSA/docs/KernelSU.md 的官方安装说明与 构建脚本 的源码实现系统讲解如何在 WSABuilds 构建的 WSA 中安装 KernelSU Manager 并完成 root 环境搭建。说明本文的官方说明指仓库内两份 KernelSU 文档安装 Manager 指南 与 安装 KernelSU 指南实现细节以 build.sh 等脚本为准。KernelSU 在 WSABuilds 中的定位WSABuilds 项目README.md提供开箱即用的 WSA 预构建二进制包可内置 Google Play 商店MindTheGapps以及 Magisk / KernelSU 两种 root 方案。KernelSU 与 Magisk 的最大区别在于Magisk采用无系统修改的 init 补丁方案通过修改initrd.img注入 magiskinit 与 post-fs-data 脚本来实现 rootKernelSU直接以内核补丁形式集成将预编译的内核x64 为bzImagearm64 为Image替换 WSA 自带的Tools/kernel即可无需修改 initrd。从 build.sh 可以看到当ROOT_SOLkernelsu时构建流程会执行echo Extracting KernelSU source ${KERNELSU_INFO:?} || abort echo WSA Kernel Version: $KERNEL_VER echo KernelSU Version: $KERNELSU_VER if ! unzip $KERNELSU_PATH -d $WORK_DIR/kernelsu; then CLEAN_DOWNLOAD_KERNELSU1 abort Unzip KernelSU failed, package is corrupted? fi if [ $ARCH x64 ]; then mv $WORK_DIR/kernelsu/bzImage $WORK_DIR/kernelsu/kernel elif [ $ARCH arm64 ]; then mv $WORK_DIR/kernelsu/Image $WORK_DIR/kernelsu/kernel fi echo Integrate KernelSU mv $WORK_DIR/wsa/$ARCH/Tools/kernel $WORK_DIR/wsa/$ARCH/Tools/kernel_origin cp $WORK_DIR/kernelsu/kernel $WORK_DIR/wsa/$ARCH/Tools/kernel即下载的 KernelSU 内核压缩包解压后x64 架构取bzImage、arm64 架构取Image重命名为kernel后替换 WSA 的Tools/kernel同时将原内核保留为kernel_origin以便回退。因此使用 WSABuilds 构建的含 KernelSU 包包名形如WSA_..._-with-kernelsu-版本-...时内核已被预集成你不再需要手动替换内核只需安装 KernelSU Manager 即可。方法一使用 WSABuilds 预构建包推荐1. 确认你所下载的包包含 KernelSUWSABuilds 提供四种 KernelSU 变体详见 Post-Installation Guides/KernelSU 目录下的说明MindTheGapps and AMZ含 Gapps 与 Amazon AppstoreMindTheGapps and Removed AMZ含 Gapps、无 Amazon AppstoreNo Gapps and AMZ无 Gapps、含 Amazon AppstoreNo Gapps and Removed AMZ无 Gapps、无 Amazon Appstore构建产物命名规则见 build.shif [[ $ROOT_SEL none ]]; then name1 elif [ $ROOT_SEL magisk ]; then name1-with-magisk-$MAGISK_VERSION_NAME($MAGISK_VERSION_CODE)-$MAGISK_VER elif [ $ROOT_SEL kernelsu ]; then name1-with-$ROOT_SEL-$KERNELSU_VER fi因此包名中会包含-with-kernelsu-版本号例如WSA_2309.40000.8.0_x64_-with-kernelsu-10845-NoGApps。请确保下载的包与你的 CPU 架构一致x64 或 arm64并且不要选择 Install GApps and KernelSU 这种不支持的组合——build.sh 中明确写了abort Unsupported combination: Install GApps and KernelSU即在 KernelSU 方案下不能同时集成 GApps只能选 No Gapps 变体如需 Google 服务可安装 microG 等替代方案。2. 安装并启动 WSA按照 Installation.md 完成安装后启动Windows Subsystem for Android。由于 KernelSU 内核已集成系统会直接以 root 权限运行无需额外操作。3. 通过 ADB 一键安装 KernelSU ManagerKernelSU 官方安装文档MagiskOnWSA/docs/KernelSU.md的手动流程是先下载 Manager APK 再用adb install安装而 WSABuilds 的内置指南MagiskOnWSA/docs/Guides/KernelSU.md提供了一条更快捷的路径——系统内已内置ksuinstall脚本可直接通过 ADB 调用连接 WSA 与 ADB参考 ADB-Sideloading.md打开 WSA 设置 →Advanced Settings→ 开启Developer mode记下 Developer mode 中显示的IP address and port确保 Windows 已安装 ADB执行配对与连接adb pair 127.0.0.1:58526 adb connect 127.0.0.1:58526用adb devices确认 WSA 已连接。运行内置安装脚本adb shell ksuinstall若安装成功KernelSU Manager 会自动启动官方文档原句If the installation completes successfully, the KernelSU Manager will launching.。提示ksuinstall是 WSABuilds 预构建镜像中内置的辅助脚本对应仓库 post-fs-data.sh 所打出的系统环境它会自动完成 KernelSU Manager APK 的获取与静默安装省去了手动下载、校验、push、install 的多步操作。若你的包是基于老版本构建、未内置该脚本则请参考下文手动安装方法。方法二手动安装 KernelSU Manager官方流程若你使用的是未预装ksuinstall的包或希望手动掌控每一步可参照 MagiskOnWSA/docs/KernelSU.md 的完整流程1. 下载 KernelSU Manager从 KernelSU 官方构建渠道Build Manager 工作流下载名为manager的构建产物得到一个 zip 压缩包。解压后得到形如KernelSU_vx.x.x-xx-.....apk的 Manager APK。2. 通过 ADB 安装 Manageradb install apkname.apk其中apkname.apk为解压得到的 APK 文件名。也可以先adb push到 WSA 内部再用adb shell pm install安装但直接adb install更简洁。3. 安装 / 替换 KernelSU 内核仅手动构建时所需官方流程中若你使用的是原版 WSA非 WSABuilds 预构建包还需要从 KernelSU 官方Build Kernel - WSA工作流下载预构建内核注意选择与你的 CPU 架构一致x64 取bzImagearm64 取Image解压得到内核文件用该内核文件替换 WSA 目录下Tools文件夹中的kernel重启 WSA。这一点与 WSABuilds 预构建包有本质区别使用 WSABuilds 包时内核已在构建阶段由 build.sh 替换完毕原内核备份为kernel_origin因此不需要也不能重复替换——直接执行adb shell ksuinstall即可。若你确实想换内核可参考 Custom Builds.md 使用 build.sh 自行构建。从源码理解 KernelSU 的集成与版本匹配内核版本自动匹配构建含 KernelSU 的包时脚本会先探测 WSA 自带内核的版本再据此选择匹配的 KernelSU 内核见 build.shupdate_ksu_zip_name() { KERNEL_VER if [ -f $WORK_DIR/wsa/$ARCH/Tools/kernel ]; then KERNEL_VER$(getKernelVersion $WORK_DIR/wsa/$ARCH/Tools/kernel) fi KERNELSU_ZIP_NAMEkernelsu-$ARCH-$KERNEL_VER.zip KERNELSU_PATH$DOWNLOAD_DIR/$KERNELSU_ZIP_NAME KERNELSU_INFO$KERNELSU_PATH.info }而 generateKernelSULink.py 通过 GitHub API 查询 KernelSU v2.1.2 的发布资产用正则kernel-WSA-arch-kernelVersion.*\.zip匹配与当前 WSA 内核版本对应的预编译内核并在多个可用版本中选取最新的一个arch sys.argv[1] abi_map {x64: x86_64, arm64: arm64} ... res requests.get(https://api.github.com/repos/tiann/KernelSU/releases/tags/v2.1.2) ... for asset in assets: if re.match(rfkernel-WSA-{abi_map[arch]}-{kernelVersion}.*\.zip$, asset[name]) and asset[content_type] application/zip: tmp_kernel_ver re.search(u\d{1}.\d{1,}.\d{1,}.\d{1,}, asset_name.split(-)[3]).group() if (kernel_ver 0): kernel_ver tmp_kernel_ver elif version.parse(kernel_ver) version.parse(tmp_kernel_ver): kernel_ver tmp_kernel_ver从中可以看出 KernelSU 与 WSA 内核版本是强绑定的不同 WSA 版本对应不同内核版本构建系统会自动挑选匹配项这正是替换内核这一步骤极易出错的原因——手动操作时若版本不匹配可能导致 WSA 无法启动。此外该脚本还处理了 GitHub API 的限流403 / x-ratelimit-remaining 0这也是构建可能失败的原因之一。版本更新检查仓库的 KernelSUUpdateCheck.py 用于持续跟踪 KernelSU 最新版本它读取kernelsu.appversion中记录的当前版本请求 GitHub API 获取tiann/kernelsu的 latest release 版本号若不一致则在 CI 中生成 Update KernelSU Version fromvXtovY 的提示从而保证预构建包能跟随 KernelSU 上游更新。这也说明你下载到的预构建包中的 KernelSU 版本可能不是最新如需最新版可关注该更新检查脚本的同步情况或手动执行adb shell ksuinstall对应的官方流程更新 Manager。启动链路与 root 环境KernelSU 方案的 root 生效不依赖 Magisk 的 init 注入。在 WSABuilds 的构建流程中KernelSU 分支只做内核替换见上文代码而 Magisk 分支才会用magiskboot cpio修改initrd.imgbuild.sh。从 post-fs-data.sh 可以看出Magisk 的 post-fs-data 机制用于在启动早期挂载模块如 LSPosed 镜像KernelSU 则完全依赖内核级能力无需此类用户态脚本因此其启动链路更短、更隐蔽。安装后的验证与常见问题如何确认 KernelSU 已生效打开已启动的 KernelSU Manager若显示 root 已授权/内核已激活说明安装成功或用 ADB 验证adb shell su -c id若能返回uid0(root)相关内容说明 root 可用。常见问题adb shell ksuinstall报错 / 找不到命令确认你使用的是 WSABuilds 较新版本的 KernelSU 包老包未内置该脚本确认 ADB 已正确连接adb devices显示device状态而非offline或unauthorized必要时重启 WSA 再试。KernelSU Manager 已安装但无法连接内核多为内核版本与 Manager 版本不匹配建议更新包内 KernelSU 版本或使用匹配的 Manager。想要回退到原版内核预构建包保留的原内核位于Tools/kernel_origin将其重命名回kernel并重启 WSA 即可仅对了解系统结构的用户建议操作。需要 Google Play 服务但选了 KernelSUKernelSU 构建变体不支持 GAppsbuild.sh 明确 abort请使用 microG 等方案或改用 Magisk 变体。更多排查参见 Troubleshooting.md 与 Having Issues.md。总结在 WSABuilds 中启用 KernelSU 只需两条核心路径预构建包用户在装好包并启用 WSA 开发者模式后执行adb pair/adb connect连接 ADB再运行adb shell ksuinstall即可完成 KernelSU Manager 的自动安装手动流程用户则按官方文档依次下载 Manager APK、adb install若使用原版 WSA 还需替换匹配版本的内核。内核版本的自动匹配与预集成由 build.sh 与 generateKernelSULink.py 在构建阶段完成这也是 WSABuilds 相对手动折腾的核心价值所在。【免费下载链接】WSABuildsRun Windows Subsystem For Android on your Windows 10 and Windows 11 PC using prebuilt binaries with Google Play Store (MindTheGapps) and/or Magisk or KernelSU (root solutions) built in.项目地址: https://gitcode.com/GitHub_Trending/ws/WSABuilds创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考