老赵写字的地方

LineageOS 系统 OTA 升级并保留 Magisk(Root)的操作指南

在现代 Android 的 A/B 双分区机制下,LineageOS 的系统更新会默认写入当前未使用的闲置分区(Inactive Slot)。如果在系统 OTA 完成后直接重启,设备将从已写入新系统但未配置 Root 的干净分区启动,导致 Magisk 权限丢失。

为实现无缝升级并保留 Root 权限,应采用「未激活槽位注入法」。本指南适用于日常小版本或安全补丁更新。

🛠️ 前置条件与风险提示

  1. 适用架构:设备必须支持 A/B 分区结构(近年发布的主流设备均支持)。
  2. 升级限制:此方法仅适用于同版本内的增量或全量 OTA 更新。若涉及跨 Android 大版本升级(如从 LineageOS 20 升级至 21),必须进入 Recovery 手动卡刷,不可使用此方法。
  3. 操作核心:在升级流程结束前,绝对不可触发系统的自动重启。

📋 标准化操作流程

  • 触发系统 OTA 更新(常规下载阶段)
  1. 依次进入手机的「设置」→「系统」→「更新」(Updater)。
  2. 检查并下载最新的 LineageOS 固件包,点击「安装」。此时系统会在后台将新固件写入未激活的分区槽位。
  • 挂起系统重启指令(关键红线阶段)
  1. 待固件写入完毕后,系统更新界面会弹出「重启」提示。
  2. 此时绝对不要点击重启。 直接返回手机桌面。
  • 利用 Magisk 注入未激活分区(权限留存阶段)
  1. 打开 Magisk App,点击第一栏 Magisk 选项右侧的「安装」(Install)。
  2. 在安装选项列表中,选择「安装到未使用的槽位 (OTA 后)」(Install to Inactive Slot (After OTA))。
  • 执行修补与安全重启(流程完成阶段)
  1. 点击「开始」(Let's go),Magisk 将自动抓取并修补另一个分区的 boot.img 镜像。
  2. 等待日志输出结束并显示 All done!(全部完成)后,点击 Magisk 的「重启」(Reboot)按钮。

⚠️ 异常情况处理(Bootloop 应急)

若重启后设备未能进入系统,卡在 LineageOS 启动动画(俗称卡第一屏):

  1. 恢复原生启动分区:长按 电源键 + 音量上键 强制关机,并进入 Lineage Recovery 模式。
  2. 覆盖错误补丁:通过电脑执行 adb sideload lineageos_固件名.zip,将干净的官方固件重新刷入该分区。此操作会覆盖掉导致故障的 Magisk 补丁,确保系统优先正常开机。
  3. 重新提取修补:顺利开机进入系统后,再通过提取当前固件的 boot.img 发送至手机端 Magisk 进行手动修补,并利用 Fastboot 模式重新刷入。
zh/lineageos/update.txt · 最后更改: 由 tom