Zapret Wiki

Недавно обновлено

время чтения ~7 мин.

.md

🛠️ Установка Magisk — патч boot/init_boot, Recovery, Samsung

О чём заметка

Пошаговая установка Magisk на Android по официальной документации: требования, как понять, какой образ патчить, патч boot/init_boot/recovery, отдельные случаи для устройств без boot-ramdisk и для Samsung, удаление и сохранение root при обновлениях. Что такое Magisk, зачем он и как устроен (systemless, модули, Zygisk, скрытие root) — в обзорной заметке Magisk — systemless-root и модули.

Нужны навыки прошивки и разблокированный загрузчик

Инструкция предполагает, что вы умеете пользоваться adb и fastboot и знаете, как выводить устройство из «кирпича». Загрузчик обязан быть разблокирован (его разблокировка стирает все данные). Если планируете ещё и кастомное ядро — ставьте его после Magisk. Заранее сохраните оригинальные boot.img/init_boot.img для отката.

TL;DR

  • Ставится приложением Magisk: оно патчит загрузочный образ, который вы затем прошиваете через fastboot.
  • Сначала определите по строке Ramdisk в приложении, какой образ патчить: boot.img/init_boot.img (есть ramdisk) или recovery.img (нет).
  • Образ берите от своей прошивки той же версии и патчите только на своём устройстве — чужой пропатченный образ шить нельзя.
  • Samsung — особый путь (Odin + AP tar, необратимый Knox, полный wipe).
  • После каждого OTA root слетает; на A/B-устройствах спасает «Install to Inactive Slot».

Шаг 1. Понять, какой образ патчить (строка Ramdisk)

Ключевой вопрос перед установкой — есть ли ramdisk в boot-разделе устройства. От этого зависит, какой образ патчить. Установите свежее приложение Magisk (APK) и посмотрите на главном экране строку Ramdisk:

  • Ramdisk = Yes → патчим boot.img; на устройствах с отдельным разделом init_boot (Pixel с Android 13+ и др.) — init_boot.img. Это случай большинства современных устройств.
  • Ramdisk = No → ramdisk в boot нет, Magisk «захватывает» recovery-раздел: патчим recovery.img (см. Magisk in Recovery).

Редкое исключение

Некоторые устройства (известны отдельные модели Xiaomi) принимают ramdisk в boot, даже когда «не должны». Автоматически это не определить — если стандартный путь не срабатывает, действуйте так, будто ramdisk в boot есть. Большинству об этом можно не думать.

Нужный образ (boot.img / init_boot.img / recovery.img) извлекают из официальной прошивки или zip вашего кастомного ROM — строго той версии, что стоит на устройстве.

Шаг 2. Пропатчить образ и прошить (общий случай)

Стандартный путь для устройств с boot-ramdisk (например, Pixel — там init_boot). Порядок по официальной инструкции:

  • Скопировать стоковый boot.img / init_boot.img от вашей текущей прошивки на телефон.
  • В приложении Magisk нажать Install (кнопка в карточке Magisk).
  • (Только для recovery-образа) включить опцию «Recovery Mode».
  • Метод — «Select and Patch a File», выбрать образ, запустить установку.
  • Забрать пропатченный образ на ПК: adb pull /sdcard/Download/magisk_patched_[строки].img.
  • Уйти в fastboot и прошить в тот же раздел, что патчили:
fastboot flash init_boot magisk_patched-*.img
# или:  fastboot flash boot magisk_patched-*.img
# или:  fastboot flash recovery magisk_patched-*.img
  • (Необязательно) если есть отдельный раздел vbmeta: fastboot flash vbmeta --disable-verity --disable-verification vbmeta.img — может стереть данные.
  • Перезагрузиться и запустить приложение Magisk; на запрос «environment fix» согласиться и дождаться ребута. Готово.

Патчить образ — только на своём устройстве и от своей прошивки

Никогда не прошивайте чужой пропатченный образ и не патчите образ на другом устройстве — даже той же модели. Это может привести к «кирпичу» с необходимостью полного wipe данных. Всегда патчьте boot/init_boot на том же устройстве, где ставите Magisk, и от точно той прошивки, что установлена.

Известная проблема на Android 16 (Pixel)

По сообщениям (Magisk issue #9583), на Android 16 со свежими сборками Magisk root иногда «не берётся» после прошивки — патч не распознаётся. Обходной путь из обсуждения: переустановить сам APK Magisk после флеша, тогда Zygisk и модули появляются. Это баг-репорт, а не официально закрытая проблема — проверяйте актуальность.

Особый случай: Magisk in Recovery (устройства без boot-ramdisk)

Если у устройства нет ramdisk в boot (Ramdisk = No), Magisk вынужденно занимает recovery-раздел. Тогда Magisk включается только при загрузке в recovery: обычная загрузка идёт без Magisk, а чтобы система стартовала с root, нужно каждый раз входить через комбинацию клавиш recovery (у каждой модели своя — легко ищется по названию устройства).

Схема (от выключенного состояния):

  • Обычное включение → система без Magisk.
  • Комбо recovery → сплеш-экран → отпустить все кнопки → система с Magisk.
  • Комбо recovery → сплеш-экран → долго держать Volume Up → настоящий recovery.

В этом режиме обновлять/ставить Magisk через кастомный recovery нельзя — только методом «Patch Image».

Особый случай: устройства Samsung

Samsung: необратимый Knox и обязательный wipe

На Samsung установка Magisk навсегда «сжигает» Knox Warranty Bit (необратимо) и при первой установке требует полного wipe данных.

Порядок на Samsung отличается — вместо fastboot используется Odin (Windows) / Odin4 (Linux) / Heimdall:

  • Проверить в Download mode, что загрузчик разблокирован: OEM Lock = OFF (U) и что KnoxGuard (RMM) не активен (значения Checking/Completed/Broken = разблокирован). Активный KnoxGuard не даст поставить Magisk.
  • Скачать официальную прошивку своей модели (SamFirm.NET, Frija, Samloader, Bifrost) и скопировать на телефон AP tar (AP_[модель_версия].tar.md5).
  • В Magisk: Install → (если нет boot-ramdisk — включить «Recovery Mode») → «Select and Patch a File» → выбрать AP tar.
  • Забрать результат по ADB: adb pull /sdcard/Download/magisk_patched_[строки].tar. Не использовать MTP — он портит большие файлы.
  • В Odin прошить magisk_patched.tar как AP вместе с BL, CP и CSC (именно CSC, а не HOME_CSC, — чтобы стереть данные при первой установке).
  • После прошивки согласиться на factory reset; при отсутствии boot-ramdisk — загрузиться в recovery, чтобы включить Magisk. Запустить приложение Magisk и дать ему доделать настройку с автоперезагрузкой.

Samsung: важные запреты

  • После рутинга OTA недоступны — новую прошивку ставят вручную тем же патчем AP. При апгрейде в Odin используют HOME_CSC (а не CSC), чтобы не стирать данные.
  • Никогда не восстанавливайте boot/init_boot/recovery/vbmeta обратно на сток — это грозит «кирпичом» с восстановлением только через полный Odin-флеш с wipe.
  • Никогда не шейте стоковый AP напрямую при обновлении — всегда сперва патчьте его в Magisk.

Root и обновления прошивки (OTA): как не терять root

Как и любой boot-based root, Magisk слетает после OTA — обновление перезаписывает boot/init_boot. На A/B-устройствах (современные Pixel и др.) переустанавливать через ПК не нужно — есть функция «Install to Inactive Slot (After OTA)»:

  • Установить обновление (например, в LineageOS Updater / системном апдейтере), но не перезагружаться, когда предложит «Reboot».
  • В Magisk: Install → «Install to Inactive Slot (After OTA)» — Magisk пропатчит неактивный слот, куда легло обновление.
  • Только теперь перезагрузиться — система стартует с обновлённого слота уже с root.

Порядок критичен

Сначала установка OTA в неактивный слот, потом Magisk в тот же слот, и лишь затем перезагрузка. Если перезагрузиться раньше — root слетит, и придётся патчить boot/init_boot вручную и шить через fastboot. Изредка трюк с неактивным слотом даёт сбой (зависит от версии Magisk/сборки) — тогда откатываетесь к ручному патчу текущего образа.

Удаление Magisk

  • Через приложение Magisk — кнопка Uninstall (простой и рекомендуемый способ).
  • Через кастомный recovery — переименовать APK Magisk в uninstall.zip и прошить как обычный flashable-zip. Способ устарел и поддерживается по минимуму; на современных устройствах используйте метод «Patch Image».

Не стирайте cache-раздел

Файлы правил sepolicy.rule некоторых модулей могут лежать в разделе cache. При манипуляциях не выполняйте wipe cache, иначе потеряете настройки модулей.

📚 См. также

🤖 Эти статьи открыты — можно обучать на них ИИ

При желании вы можете натренировать ИИ на наших статьях. Исходное форматирование и скачивание всего репозитория одним zip-архивом доступны в Forgejo: исходник этой заметки · весь репозиторий.

Вид графа

Обратные ссылки