2026 年怎么安装 LSPosed：Vector、Zygisk、Magisk、KernelSU 与 APatch 全攻略

你搜了 LSPosed，翻到一篇 2023 年的教程，让你直接刷个 zip，可你现在也拿不准这个包在自己的 Android 版本上到底能不能跑。这种犹豫是有道理的。

简短回答： 2026 年你要装的是 Vector，也就是 LSPosed 的维护延续版。先把 Root 管理器的 Zygisk 环境弄好，再从 Vector 的 GitHub Releases 页面下载安装。原版 LSPosed v1.9.2 的压缩包发布于 2023 年 10 月，README 只写到 Android 14；Vector 声明支持 Android 8.1 到 17（其 README 写的是“17 Beta”）。¹⁴

多数教程不会提的一点：KernelSU 和 APatch 都没有内置 Zygisk。 在这两个上要先另装一个 Zygisk 模块，而且同一时间只能运行一个 Zygisk 实现。¹¹¹⁶

资料核查日期：2026 年 11 月 5 日。这是一篇基于文档的指南，并不表示 DroidRooter 实测了文中提到的每一款手机、ROM 或模块。凡是菜单名称未经核实的地方，文中都会明说。

快速跳转： 发生了什么变化 · 你需要它吗？ · 环境要求 · 装哪个版本 · 动手之前 · Magisk · KernelSU · APatch · Zygisk 怎么选 · 打开并验证 · 模块与作用域 · 更新 · 排错 · 卸载 · 安全 · DRVCAM · 常见问题

LSPosed 是什么，到 2026 年发生了什么变化

LSPosed 是一个 ART 钩子（hook）框架：它让被称为模块的小型附加程序，借助原版 Xposed API 改变应用和系统服务的行为。它是以 Zygisk 模块的形式交付的，所以运行在由 Root 管理器的 Zygisk 层启动的进程里。¹

它有个很实用的特点：钩子只存在于内存中，不会改写任何应用的 APK，所以停用模块并重启之后，行为改动就会还原。（不过模块仍然可能自己写入文件，所以“可还原”指的是钩子本身，而不是模块可能做的所有事情。）⁴

下面是这个项目的变化，日期都可以自己核对：

• 原版 LSPosed 仓库自 2023-10-11 的 v1.9.2 之后再无发布，默认分支自 2024-01-07 之后也没有新提交。仓库没有被归档，其他分支仍有推送，所以你在 GitHub 上看到的动静，可能比 Releases 页面显示的要多。它的 README 写的是“Android 8.1 ~ 14”。¹²
• Vector 是原先 JingMatrix 的 LSPosed 分支。v2.0（2026-03-22）的发布说明称项目已从 LSPosed 更名为 Vector，并重写了 Zygisk 架构。v2.1（2026-08-02）是第一个基于新版 libxposed API 101 的构建，声明支持 Android 8.1 到 17，并重做了管理器。v2.2（2026-08-04）是 2.1 的热修复版，新增 API 102 热重载。⁵
• 只有 Vector 声明了对 Android 15、16、17 的支持。原版项目对这些版本没有任何声明，但这不等于它一定在这些版本上跑不起来。⁴¹

Xposed、EdXposed、LSPosed、Vector：一张表看清

你还会看到一些只出现在视频标题里的分支和改名版本。我们无法核实，也不推荐其中任何一个。

旧版 API 与 libxposed API

Vector 同时支持旧版 Xposed API 和较新的 libxposed API。⁴ 对你来说，这意味着老模块照样能加载，而新模块可能是按 libxposed 写的，并且要求必须用 Vector。模块自己的页面会写明这一点。

你真的需要吗？它能做什么，不能做什么

LSPosed 系框架需要 Root 和 Zygisk。也就是说手机必须已经 Root，而通过 Magisk 或 KernelSU 获取 Root 需要先解锁 Bootloader。Magisk 的安装指南和 KernelSU 的 FAQ 都明确这样说。¹⁰¹¹

第一次折腾 Root 之前的警告： 解锁 Bootloader 通常会清空手机。在三星手机上，Magisk 自己的文档说明，首次安装需要完整清除数据，并且会永久触发 Knox 保修位。¹⁰ 请先备份。如果你还没 Root，请先读一读什么是 Root和我们的安卓 Root 指南，并确认你的具体机型，因为并不是每台设备都能 Root。

框架给你的是运行“钩住应用”的模块的能力。它不会给你的是：

• 不保证某个模块一定能在某个应用或某个 Android 版本上正常工作。 应用和 Android 一变，模块就可能失效。
• 不会让你隐形。 Root 和 hook 都可能被检测到，有些应用会拒绝运行。我们不作“检测不到”的承诺，也不对 Play Integrity 或银行类应用作任何保证。
• 没有“免 Root 的 Xposed”。 修补 APK 和虚拟容器类工具确实存在，但那是另一种技术，各有取舍。我们没有验证过，也不在这里讨论。

如果你想了解有哪些模块，请看我们的 Magisk 与 Xposed 模块指南，那里专门讲这个问题。本文只讲框架的安装和修复。

按 Android 版本和 Root 管理器划分的环境要求

请找到你手机对应的那一行。“没有维护者声明”并不等于失败报告。

Root 层同样重要：

KernelSU 的 FAQ 自己回答了框架的问题：你可以配合 Zygisk Next 使用 LSPosed 或其他现代 Xposed 衍生版。¹¹ APatch 的 FAQ 说它没有内置 Riru 或 Zygisk，需要通过 APatch 模块来添加 Zygisk。¹⁶

装哪个版本

文件命名规律，帮你认出正版文件： Vector 稳定版的文件名形如 Vector-v2.2-3080-Release.zip 和 Vector-v2.2-3080-Debug.zip。原版项目最后的文件是 LSPosed-v1.9.2-7024-zygisk-release.zip 和对应的 Riru 版本。⁵² 如果发布页列出了校验值，请与你下载的文件比对。

Release 还是 Debug？ Vector 的 README 建议排查问题的人用 Debug 版，并说明只接受来自最新 Debug 构建的 bug 报告。日常使用请选 Release。⁴ Canary 构建是 CI 的预发布版本，大多数读者应当运行稳定版。⁵

动手之前：备份与救砖准备

框架会运行在每个被勾选应用的进程里，一个有问题的模块就可能让手机无法开机。先把退路准备好。

1. 备份你的数据。 不管用哪个框架都要做，因为你马上要以 Root 身份刷模块了。
2. 保存好原厂 boot 或 init_boot 镜像，要和你当前的版本完全一致。我们的获取正确的 boot 或 init_boot 镜像指南告诉你怎么拿到，Magisk 刷机失败恢复则讲了常见的抢救办法。
3. 知道你的安全模式（Safe Mode）入口。
4. Magisk： 它的 FAQ 说，连续两次开机失败会进入安全模式，禁用所有模块和 Zygisk。你也可以通过 adb 运行 magisk --remove-modules，或在应用的重启菜单里重启到安全模式。FAQ 介绍了组合键的按键时机，这个时机可能比较难把握。⁹
5. KernelSU： 它的救砖页面说，在第一个开机画面之后，按下并松开音量下键超过三次。页面警告说，在开机很快的设备上这个时机可能触发不了，写错的 init rc 行即使在安全模式下也仍会执行，并且千万不要安装来历不明的模块。¹³
6. 如果你真的陷入了开机循环，我们的 Android 开机循环指南和不丢数据修复开机循环是接下来要看的。

在 Magisk 上安装

Magisk 内置了 Zygisk，所以这是最短的路径。不同 Magisk 版本的菜单名称会有变化；下面的“设置”开关，是我们的 DRVCAM 安装指南在一台 Magisk 31.x 手机上用截图记录过的那个。²⁰

1. 打开 Zygisk。 进入 Magisk → 设置，在 Magisk 分组里找到 Zygisk 开关并打开。Magisk 会提示你重启。
2. 重启，并确认 Magisk 首页现在显示 Zygisk：已启用（Enabled）。
3. 下载 Vector，来源是项目的 Releases 页面（github.com/JingMatrix/Vector/releases）：选稳定版的 Release.zip，不要选“Source code”。
4. 进入 模块 → 从本地安装，选中该压缩包，等它安装完成。
5. 重启。
6. 用下一节里的三种方式之一打开管理器。

Vector 的 README 用自己的话讲的也是同样的顺序：通过 Root 管理器安装，确保已有 Zygisk 环境，重启，然后通过系统通知进入设置。⁴

Magisk 内置 Zygisk 开着的时候，不要再装独立的 Zygisk 模块。 ReZygisk 的 README 告诉 Magisk 用户要关掉内置的那个，因为两者会冲突；Zygisk Next 的要求也写明必须关闭 Magisk 内置的 Zygisk。¹⁸¹⁷

补充一条版本说明：Magisk v31.1 去掉了临时弹出的超级用户授权提示，所以应用要提前在“超级用户”标签页里授权。⁸ 这一点和排错对照表里的 Shell Root 那一步有关。

在 KernelSU 上安装

1. 确认你的 KernelSU 管理器显示 Root 正常工作。 KernelSU 官方支持 GKI 2.0、内核 5.10 及以上。¹⁴
2. 不要同时运行 Magisk。 KernelSU 的文档说，它的模块系统与 Magisk 的 magic mount 冲突：只要 KernelSU 里启用了任何一个模块，Magisk 就会完全无法工作。¹¹
3. 决定要不要装 metamodule（元模块）。 KernelSU 3.x 引入了 metamodule，其页面说，没有 metamodule 的话，模块不会被挂载。FAQ 做了限定：只有修改 /system 下文件的模块才需要 metamodule，脚本、sepolicy 和 system.prop 不需要。¹²¹¹ 我们没有单独验证过 Vector 是否需要一个被挂载的模块。 我们自己的 DRVCAM 安装指南记录了一台 KernelSU 手机运行 Zygisk Next 和 Vector，其中没有提到 metamodule。²⁰ 如果你的其他模块会改动 /system，请按 KernelSU 页面的说明安装一个 metamodule（例如 meta-overlayfs，通过管理器里的添加按钮安装，然后重启；同一时间只能装一个）。
4. 在“模块”标签页安装一个 Zygisk 实现（Zygisk Next、ReZygisk 或 NeoZygisk，见对比）。重启。
5. 用同样的方式安装 Vector Release 压缩包。重启。
6. 打开管理器（见下一节）。

Zygisk Next 的 README 列出的最低要求是 KernelSU 10940 和 KernelSU 管理器（ksud）11575。¹⁷ 当前的 KernelSU v3.3.1 远超这两个数字，但无论你选哪个实现，都请再看一下它自己的 README。

在 APatch 上安装

1. APatch 必须是 arm64，而且你的内核必须落在它声明的 3.18 到 6.12 范围内。¹⁵
2. 在 APatch 管理器中打开模块列表（APM），安装一个 Zygisk 实现的压缩包并重启。不同版本的菜单名称会有差异。
3. 安装 Vector Release 压缩包并重启。
4. 打开管理器（见下一节）。

关于 APatch 有三点提醒。第一，它的 FAQ 把一个叫 Zloader 的项目列为备选，但同时说它自 v0.1.3 之后就没有提交了，不再推荐，并且它与任何 Zygisk 实现都不兼容。我们同样不推荐。¹⁶ 第二，APatch 的 README 说明 SuperKey 的权限比 Root 权限更高，所以要像对待 Root 密码一样对待它。¹⁵ 第三，如果模块安装因 shell 相关错误而失败，APatch 的 FAQ 建议移除 Shell 应用的 Root 权限。这恰好与 Vector 的某一个排错步骤相反，下面的对照表里会讲到。¹⁶⁶

怎么选 Zygisk 实现

Vector、KernelSU 和 APatch 都点名了这三个，但没有给出优劣排名。它们共同的一条规则是：只装一个。⁴¹¹¹⁶

选哪个，既是技术偏好，也是信任和许可证方面的偏好。许可证那一行是一个事实，在选择要以 Root 身份运行的软件时你也许想知道，它不是质量排名。如果你已有一套能正常工作的配置，就不必更换。

打开管理器并验证是否生效

没有单独的管理器 APK 可下载。Vector 的管理器内置在模块里。⁶ 下面是维护者自己的排错指南里给出的三种进入方式：

1. 重启后的系统通知（README 里写的方式）。
2. Root 管理器里 Vector 模块的“操作”（Action）按钮，在通知没有出现时使用。请先更新 Magisk 或 KernelSU。
3. 通过 adb 把管理器当作普通应用从模块目录安装：

adb shell su -c cp /data/adb/modules/zygisk_vector/manager.apk /data/local/tmp && adb pull /data/local/tmp/manager.apk && adb install ./manager.apk

如果管理器仍然打不开，同一份指南说要先给系统 Shell（com.android.shell）授予 Root。在这样做之前，请先读排错对照表里的警告。⁶

v2.1 的管理器用 Jetpack Compose 重做了，所以本文只按功能来描述界面，不引用具体的菜单文字。⁵

验证清单：通过或不通过

• [ ] 你的 Root 管理器显示 Zygisk 已启用（Magisk 首页），或者在模块列表里恰好有一个 Zygisk 模块处于启用状态（KernelSU 和 APatch）。
• [ ] Root 管理器里列出了 Vector 模块，并且已启用。
• [ ] Vector 管理器能打开，首页显示框架处于激活状态。
• [ ] 实际测试一次。 装一个你信任、并且能读到源码的小模块，启用它，把一个目标应用勾选为它的作用域，强制停止该应用再重新打开。如果模块的效果出现了，说明整条链路是通的。

只要有一项不通过，就跳到对照表。最后一项很重要，因为框架可能显示“已激活”，而模块仍然什么都没做。

模块与作用域：激活是怎么起作用的

模块要对某个应用生效，必须同时满足三个条件：

1. 模块在管理器里已启用。
2. 目标应用已在该模块的作用域里被勾选。
3. 在前两步完成之后，目标进程已重启。

LSPosed wiki 描述的流程是一样的：模块像普通应用一样安装，你先把模块打开，再选择它的作用范围。许多模块会显示推荐作用域，管理器会自动勾选。不钩系统服务的模块，只需要重启目标应用；钩住系统框架的模块则需要重启手机。LSPosed 有意没有给过时的模块提供“全选”，勾选范围也应当尽量窄：LSPosed 只注入被勾选的应用，其余应用保持在干净的环境里。³

多用户： wiki 说管理器位于主用户下，并为每个用户显示一个标签页。请在需要该模块生效的那个用户配置文件里安装模块。³

热重载： Vector v2.2 为 libxposed API 102 的模块加入了热重载，所以这类模块可以在不结束目标进程的情况下被替换。较老的模块仍然遵循重启规则。⁵

管理器里还有一个“仓库”页面，用来找模块。本文不列出具体模块；挑选和注意事项请看模块指南。

更新，以及从原版 LSPosed 换到 Vector

更新 Vector： 在 Root 管理器的“模块”页面把新压缩包覆盖安装到旧版上，然后重启。如果你在 2.1 上把管理器单独装成了一个应用，v2.2 的说明要求更新前先把它卸载。⁵ 如果更新后出了问题，按 README 的要求，先试试最新的 Debug 构建，再去提报告。⁴

从 LSPosed v1.9.2 切换过来：

1. 在旧管理器里停用你的模块，在 Root 管理器里移除旧的 LSPosed 模块，然后重启。
2. 按上文所述安装 Vector。不要同时运行两个框架。
3. 之后要重新检查每个模块的作用域。 我们无法验证模块配置是否会从 LSPosed 延续到 Vector，所以请假定不会。

Android 或安全更新之后： 先更新 Root 层，再更新框架。Magisk 更新日志显示，对新 Android 版本的 Zygisk 支持是在特定版本中到来的（16 QPR2 在 v30.7，Android 17 在 v31.0）。⁸ 对于某次更新为什么让某台手机出了问题，我们没有验证过；请去项目的 issue 跟踪页查看你对应的版本。

排错对照表

“可能原因”一栏是我们根据文档推断出的综合判断，并不是按出现频率排的序。证据等级：P 表示项目文档，C 表示用户反馈。

如果是 Zygisk 本身崩溃了，维护者的指南里有一条命令，可以从数据目录拉取 Vector 守护进程的日志；请从原文复制，不要凭记忆敲。⁶

关于 GrapheneOS 等加固系统： Vector v2.1 的说明提到修复了它的管理器在 GrapheneOS 动态代码加载限制下的问题。⁵ 社区里有帖子说要通过关闭更多保护才能让它工作。这会降低加固系统的安全性，而依据只是某一个人的反馈，所以我们不推荐。⁶

安全卸载与回退

顺序很重要。

1. 在 Vector 管理器里停用模块（或全部模块），然后重启。因为钩子是在内存里生效的，光这一步通常就能让应用恢复正常。⁴
2. 在 Root 管理器里停用或移除 Vector 模块，然后重启。
3. 只有在手机上没有其他东西需要它时，才移除 Zygisk 实现。在 Magisk 上，直接把内置的 Zygisk 开关关掉就行。
4. 紧急情况下，使用动手之前里讲的安全模式入口。

有些模块会写入自己的文件和设置。移除框架并不会撤销这些内容。

安全注意事项

你是在把 Root 和会注入其他应用的软件组合在一起使用。请认真对待。

• 模块拥有 Root 级别的权限范围。 KernelSU 的文档警告说，模块拥有 Root 权限，可能造成不可逆的损害，并告诫读者不要安装来历不明的模块。¹³
• 只从项目的 GitHub Releases 页面下载。 把文件名与装哪个版本里的命名规律对照。Vector 的 README 警告说，来自 pull request 的 CI 构建通常不稳定，也可能不安全；请坚持使用 master 分支的构建。下载 CI 产物需要登录 GitHub。⁴
• “LSPosed APK”网站不是好来源。 正常流程里没有独立的管理器 APK，所以提供它的页面提供的并不是项目所发布的东西。安装类关键词搜到的靠前视频，也常把压缩包链接放在文件共享站上。我们这么说是对搜索结果的观察，并不针对任何上传者的意图。
• 隐私。 模块可以读取被钩住的应用所看到的内容。只勾选模块确实需要的应用。
• APatch 的 SuperKey 本身就和 Root 一样敏感。¹⁵

把框架用于 DRVCAM

DRVCAM 是面向已 Root 安卓的虚拟摄像头。它的产品页写明，它运行在已 Root 的 Android 9 到 17 上，需要 LSPosed 之类的 Xposed 框架；我们的 DRVCAM 安装指南用 Vector 担当这个角色，配有一台 Magisk 手机和一台 KernelSU 手机的截图，两者最终得到的状态相同。²¹²⁰ 框架就位之后的事，见 DRVCAM 使用手册和虚拟摄像头在已 Root 安卓上是怎么工作的。

实话实说的局限，也是 DRVCAM 自己的局限：它需要 Root，兼容性取决于你的手机、你的 Android 版本，以及你要对准的那些应用。框架能正常工作，并不保证这些。请只在你自己的手机上、出于合法目的使用。

总结

2026 年，“安装 LSPosed”的意思是：确认你的 Root 管理器，给它配上恰好一个 Zygisk，从 GitHub Releases 安装 Vector，打开管理器，再用一次限定作用域的测试来证明它真的生效。

不要因为某篇教程这么说，就去装 2023 年的那个压缩包。不要叠两个 Zygisk 实现。在刷任何东西之前，先弄清楚你的安全模式入口。并且把每个模块都当作拥有 Root 级别权限范围的软件来对待，因为它本来就是。

下一步： 如果你在配置 DRVCAM，请接着看我们的 DRVCAM 安装指南和 DRVCAM 页面。它需要一台已 Root 的手机，效果取决于你的手机、Android 版本和应用。如果你卡在开机循环里，或者怎么都 Root 不上，DroidRooter 提供远程 Root 与救援协助。服务会先检查具体的设备，并在某条路径不安全时坦率告诉你。不确定自己的手机到底能不能 Root？请先看 Root 指南，并且先备份。

最后核实于 2026 年 11 月 5 日（使用前请重新核对）： Vector v2.2（2026-08-04）、Magisk v31.1、KernelSU v3.3.1（2026-10-12）、APatch 11282（2026-10-15）、ReZygisk v1.0.0、NeoZygisk v2.4、Zygisk Next v1.5.2（2026-10-15）。

资料来源与项目文档