Каталог Magisk Modules Repository — это официальная коллекция модулей для Magisk, встроенная в менеджер и доступная через раздел «Модули» в приложении: именно оттуда большинство пользователей ставят MagiskHide Props Config, Universal SafetyNet Fix и другие дополнения, не скачивая ZIP-файлы вручную со сторонних сайтов.
Модуль в терминах Magisk — это ZIP-пакет, который изменяет систему Android бессистемным (systemless) способом: файлы не перезаписываются в разделе /system, а монтируются поверх него. Благодаря этому изменения откатываются простым отключением модуля, а обновления OTA в ряде случаев продолжают работать. Ниже разберём, как устроен репозиторий, как безопасно ставить модули и что делать, если после установки устройство ушло в bootloop — циклическую перезагрузку на логотипе.
Что такое Magisk Modules Repository и как он устроен
Репозиторий модулей — это индекс, где каждый модуль описан файлом module.prop с названием, версией, автором и описанием. Менеджер Magisk загружает этот индекс и показывает модули с возможностью установки в один тап. Исторически список хостился на GitHub и обновлялся сообществом; в новых версиях Magisk встроенный онлайн-репозиторий был упрощён, поэтому часть модулей теперь ищется через GitHub-репозитории авторов и профильные ветки форума XDA Developers.
Важно понимать разницу между тремя источниками модулей:
- 📦 Встроенный раздел «Модули» в приложении Magisk — показывает уже установленные модули и позволяет ставить ZIP из памяти устройства.
- 🌐 Онлайн-репозиторий — каталог модулей, доступный для поиска и установки напрямую (доступность зависит от версии Magisk).
- 🛠 Сторонние источники — GitHub-релизы авторов, Telegram-каналы, ветки XDA. Требуют ручной проверки перед установкой.
Каждый модуль при установке распаковывается в каталог данных Magisk (обычно /data/adb/modules), и именно оттуда система монтирует его содержимое при загрузке. Это знание пригодится при ручном удалении проблемного модуля.
Как найти и установить модуль из репозитория
Стандартный сценарий установки выглядит так. Откройте Magisk, перейдите на вкладку «Модули» (иконка пазла) и нажмите «Установить из хранилища», если у вас уже есть ZIP-файл. Если модуль доступен в онлайн-каталоге вашей версии — найдите его поиском и нажмите кнопку загрузки. После установки обязательна перезагрузка: модуль активируется только при старте системы.
☑️ Проверка перед установкой модуля
Если ставите ZIP вручную, убедитесь, что это именно модуль Magisk, а не прошивка для recovery. Внутри корректного архива есть файл module.prop и скрипт установки. Архивы без этих файлов менеджер отклонит или установит некорректно.
# Просмотр установленных модулей через ADB (требуется root-доступ)
adb shell
su
ls /data/adb/modules
Обновление, отключение и удаление модулей
Управление модулями сосредоточено на той же вкладке «Модули». У каждого установленного модуля есть переключатель: выключение деактивирует модуль после перезагрузки, не удаляя его файлы. Кнопка «Удалить» помечает модуль на удаление — фактически он исчезнет тоже только после перезапуска устройства.
Обновления модулей из онлайн-репозитория Magisk предлагает автоматически, если автор опубликовал новую версию. Для модулей, установленных вручную, обновление сводится к повторной установке свежего ZIP поверх старого — данные настроек модуля обычно сохраняются, но это зависит от конкретного модуля.
Bootloop после установки модуля: порядок действий
Наиболее частая проблема при работе с репозиторием — устройство не загружается после установки несовместимого модуля. Система зависает на логотипе или перезагружается циклически. Паниковать не нужно: поскольку Magisk работает бессистемно, проблему решает отключение модулей.
⚠️ Внимание: не прошивайте стоковую прошивку и не делайте сброс данных как первый шаг. В большинстве случаев bootloop от модуля устраняется без потери данных — начинайте с безопасных методов ниже.
Способы отключить модули без загрузки системы:
- 🔄 Safe Mode Magisk: при загрузке, когда появляется анимация/логотип, зажмите кнопку уменьшения громкости и держите до полной загрузки — Magisk стартует с отключенными модулями. Срабатывает не на всех устройствах.
- 🧩 Модуль аварийного отключения — некоторые пользователи заранее ставят модули-«страховки», отключающие все модули по комбинации кнопок громкости во время загрузки.
- 💻 Через кастомное recovery (если установлено): удалите папку проблемного модуля из
/data/adb/modulesчерез файловый менеджер recovery. - ⌨️ Через ADB в режиме recovery с доступом к данным: командой удаления каталога модуля.
# Удаление модуля через ADB shell в recovery
(требуется доступ к разделу данных)
rm -rf /data/adb/modules/имя_модуля
После удаления модуля перезагрузите устройство. Если система загрузилась — откройте Magisk и убедитесь, что проблемный модуль отсутствует в списке, а остальные работают.
Совместимость модулей и типичные конфликты
Не все модули совместимы между собой и с конкретной прошивкой. Конфликты возникают, когда два модуля изменяют одни и те же системные файлы (например, аудиомоды, правящие audio_policy), или когда модуль рассчитан на другую версию Android. Признаки конфликта: функции одного из модулей не работают, система нестабильна, приложения вылетают.
Метод диагностики прост: отключите все модули, перезагрузитесь и включайте их по одному с перезагрузкой после каждого. Модуль, после включения которого проблема вернулась, и есть источник конфликта. Это медленно, но даёт однозначный ответ.
| Ситуация | Вероятная причина | Действие |
|---|---|---|
| Модуль не появляется после установки | Не выполнена перезагрузка | Перезагрузить устройство |
| Bootloop после установки | Несовместимость модуля с прошивкой | Отключить модули через Safe Mode или recovery |
| Модуль установлен, но не работает | Конфликт с другим модулем или не та версия Android | Отключить остальные модули, проверить по одному |
| Ошибка при установке ZIP | Архив не является модулем Magisk | Проверить наличие module.prop в архиве |
| Модуль пропал после обновления Magisk | Сбой при обновлении | Проверить /data/adb/modules, переустановить модуль |
Безопасность: как не подхватить вредоносный модуль
Модули Magisk выполняются с правами root, поэтому вредоносный модуль получает полный контроль над устройством. Это главный риск при установке из непроверенных источников — Telegram-каналов и файлообменников, где ZIP мог быть перепакован.
⚠️ Внимание: никогда не устанавливайте модули, автор и исходный код которых неизвестны. Отдавайте предпочтение проектам с открытым кодом на GitHub, где можно проверить, что именно делает модуль, и историю изменений.
Практические правила: сверяйте имя пакета и автора с официальной веткой проекта, читайте свежие отзывы в профильной ветке XDA, избегайте «сборников модулей одним архивом» от неизвестных авторов. Если модуль просит необычные разрешения или его поведение не описано — это повод отказаться от установки.
Как проверить содержимое ZIP модуля перед установкой
Откройте архив любым архиватором на ПК или в приложении на телефоне. В корне должны быть файл module.prop (метаданные), скрипт установки и папки с файлами модуля. Откройте скрипты в текстовом редакторе — подозрительные команды вроде отправки данных на внешние серверы или удаления системных файлов видны невооружённым глазом даже без глубоких знаний shell.
Часто задаваемые вопросы
Где сейчас находится официальный репозиторий модулей Magisk?
Встроенный онлайн-каталог в приложении Magisk был упрощён в новых версиях. Актуальные модули ищите на GitHub-страницах авторов и в профильных разделах форума XDA — там публикуются проверенные проекты с историей обновлений.
Можно ли ставить модули без перезагрузки?
Нет. Модуль активируется только при загрузке системы, когда Magisk монтирует его содержимое. Без перезагрузки установленный модуль остаётся неактивным.
Удалит ли обновление Magisk мои модули?
Обычно модули сохраняются при штатном обновлении Magisk. Однако при смене метода установки (например, переход на другую версию через прямую прошивку boot-образа) модули могут потребовать переустановки. Перед крупными обновлениями полезно сфотографировать список установленных модулей.
Модуль вызвал bootloop, а recovery нет — что делать?
Попробуйте Safe Mode Magisk: зажмите кнопку уменьшения громкости при появлении логотипа загрузки и держите до полного старта системы. Если сработает — все модули будут отключены, и вы сможете удалить виновника из приложения. Если метод не поддерживается устройством, остаётся доступ к /data/adb/modules через ADB в режиме sideload/recovery.
Сколько модулей можно установить одновременно?
Жёсткого лимита нет — ограничивают только совместимость модулей между собой и ресурсы устройства. Чем больше модулей, тем сложнее диагностировать конфликты, поэтому разумно ставить только действительно нужные и включать новые по одному.