После установки проблемного модуля Magisk смартфон уходит в бутлуп — зависает на логотипе или перезагружается по кругу, и удалить модуль штатным способом через приложение уже невозможно. В этой ситуации помогает команда adb wait-for-device shell magisk --remove-modules, которая отключает все установленные модули ещё на ранней стадии загрузки системы.
Метод работает, потому что Magisk на этапе post-fs-data запускает ADB-демон раньше, чем активирует модули. В этот короткий промежуток можно успеть отправить команду на удаление. Ниже разберём подготовку, саму команду, альтернативные способы и действия, если ADB не видит устройство.
Что понадобится для удаления модуля через ADB
Перед началом убедитесь, что у вас есть всё необходимое. Без этих компонентов команда просто не будет выполнена.
- 🖥️ Установленные ADB и Fastboot на компьютере (пакет Platform Tools от Google).
- 🔌 Исправный USB-кабель и порт, через который устройство ранее определялось стабильно.
- 🔓 Включённая отладка по USB в настройках разработчика — она должна была быть активирована до возникновения бутлупа.
- ✅ Ранее подтверждённое на смартфоне разрешение на отладку с этого компьютера (RSA-фингерпринт).
Последний пункт критичен. Если вы ни разу не подключали телефон к этому ПК с подтверждением отладки, команда вернёт unauthorized, и метод не сработает. В таком случае переходите к разделу про альтернативные способы.
⚠️ Внимание: удаление модулей не отключает сам Magisk и не сбрасывает root-доступ. Команда затрагивает только содержимое каталога модулей, прошивка boot-раздела не требуется.
Подготовка компьютера и проверка подключения
Скачайте Platform Tools с официального сайта Google для разработчиков и распакуйте архив в папку без кириллицы и пробелов в пути, например C:\platform-tools. Затем откройте командную строку или терминал в этой папке: в Windows это делается через адресную строку проводника — введите cmd и нажмите Enter.
Подключите смартфон кабелем и проверьте, видит ли его система. Для этого выполните:
adb devicesЕсли устройство находится в бутлупе, строка в списке может появляться и исчезать — это нормально, потому что ADB-демон стартует только на определённом этапе загрузки. Статус device означает готовность к работе, unauthorized — отсутствие подтверждения отладки, а пустой список — проблему с драйверами или кабелем.
Удаление модулей командой adb wait-for-device
Основная команда, которая решает проблему бутлупа, выглядит так:
adb wait-for-device shell magisk --remove-modulesРазберём её по частям. Конструкция wait-for-device заставляет ADB ждать появления устройства в системе — как только демон запустится на ранней стадии загрузки, команда выполнится мгновенно. Часть shell magisk --remove-modules вызывает встроенную функцию Magisk, которая помечает все модули на удаление и физически очищает их каталоги.
Порядок действий следующий. Запустите команду в терминале — она «повиснет» в ожидании. Затем перезагрузите смартфон (удерживайте кнопку питания или комбинацию для принудительной перезагрузки вашей модели). На очередном цикле загрузки ADB перехватит устройство, выполнит удаление модулей, и телефон должен загрузиться в систему уже без них.
☑️ Удаление модулей Magisk через ADB
Если команда выполнилась, в терминале появится подтверждение, а смартфон продолжит загрузку. Откройте приложение Magisk и убедитесь, что раздел модулей пуст. После этого можно устанавливать модули заново — по одному, с проверкой загрузки после каждого.
⚠️ Внимание: команда удаляет все установленные модули сразу, выборочное удаление через неё невозможно. Если нужен только один проблемный модуль, используйте способ через файловый менеджер с root или кастомное рекавери.
Альтернативные способы отключить модуль
ADB — не единственный вариант. В зависимости от состояния устройства подойдут и другие методы.
- 🛡️ Safe Mode Magisk: на многих устройствах удержание кнопки громкости во время загрузки переводит Magisk в безопасный режим, где модули не активируются. Комбинация зависит от модели и версии — уточняйте в документации к вашей прошивке.
- 💾 Кастомное рекавери (TWRP): через файловый менеджер рекавери можно удалить папку конкретного модуля по пути
/data/adb/modules/имя_модуля. - 📱 Частичная загрузка: если система всё же стартует, но нестабильно, удалите модуль прямо из приложения Magisk и перезагрузитесь.
Отдельно стоит упомянуть модуль-спасатель, например Magisk Module Recovery или аналогичные решения: они автоматически отключают модули после нескольких неудачных загрузок. Ставить такой инструмент имеет смысл заранее, до экспериментов с системными модификациями.
Сравнение способов удаления модулей
| Способ | Когда применять | Требования | Выборочное удаление |
|---|---|---|---|
| ADB-команда | Бутлуп, отладка включена | ПК, авторизованная отладка | Нет, удаляет все |
| Safe Mode Magisk | Бутлуп, отладка не настроена | Поддержка комбинации кнопок | Нет, отключает все |
| TWRP / рекавери | Бутлуп, есть кастомное рекавери | Установленное рекавери | Да, по папкам модулей |
| Приложение Magisk | Система загружается | Рабочая система | Да |
Что делать, если ADB не видит устройство
Самая частая причина — статус unauthorized. Он означает, что на этом компьютере отладка раньше не подтверждалась, а диалог подтверждения невозможно принять, пока система не загружена. Обойти это штатными средствами нельзя — переходите к Safe Mode или рекавери.
Вторая типичная проблема — драйверы. Откройте Диспетчер устройств Windows и посмотрите, не появляется ли устройство с жёлтым восклицательным знаком в момент подключения. Если да, установите драйвер от производителя смартфона или Google USB Driver, затем повторите adb devices.
Почему команда срабатывает не с первого раза
Окно, в котором ADB-демон доступен во время загрузки, может длиться всего несколько секунд. Если команда не успела выполниться, просто перезагрузите устройство ещё раз, не закрывая терминал — wait-for-device продолжит ждать следующего цикла.
Также проверьте кабель и порт. Кабели «только для зарядки» не передают данные, а нестабильный контакт рвёт соединение в критический момент. Используйте порт USB напрямую на материнской плате, без хабов.
Как избежать бутлупа в будущем
Главное правило — устанавливать модули по одному и перезагружаться после каждого. Так вы сразу поймёте, какой именно модуль вызвал проблему, и не будете гадать среди пяти свежих установок.
Дополнительно держите включённой отладку по USB с авторизованным домашним компьютером — это ваш запасной канал доступа. И перед установкой системных модулей, меняющих boot или vendor, полезно иметь резервную копию boot-раздела, чтобы в худшем случае вернуться к рабочему состоянию через fastboot.
Частые вопросы
Удалит ли команда сам Magisk или root-доступ?
Нет. Команда magisk --remove-modules очищает только каталоги установленных модулей. Сам Magisk, root-доступ и настройки остаются нетронутыми.
Можно ли удалить только один конкретный модуль через ADB?
Штатная команда удаляет все модули сразу. Для выборочного удаления нужен доступ к файловой системе: через TWRP удалите папку модуля в /data/adb/modules/, либо при загруженной системе — через приложение Magisk.
Что делать, если отладка по USB не была включена?
ADB-метод не сработает без предварительно включённой и авторизованной отладки. Используйте Safe Mode Magisk (комбинация кнопок зависит от устройства), кастомное рекавери или перепрошивку boot-раздела оригинальным образом через fastboot.
Команда выполнилась, но телефон всё равно не загружается. В чём причина?
Возможно, проблема не в модулях, а в самой прошивке, boot-образе или недавнем обновлении системы. Проверьте, не устанавливали ли вы OTA-обновление или не меняли ли boot-раздел. В таком случае может потребоваться прошивка стокового boot-образа через fastboot.
Работает ли метод на Magisk Delta и Kitsune Mask?
Форки Magisk, как правило, сохраняют совместимость с базовыми командами, включая --remove-modules. Однако поведение может отличаться в зависимости от версии форка — проверяйте документацию конкретной сборки.