Если после установки расширения в Automatic1111 WebUI пропадает вкладка txt2img или интерфейс падает с ошибкой при запуске, почти всегда виновата несовместимость версии дополнения с текущей версией самого WebUI — проверить это можно в консоли запуска, где Python выводит traceback с именем конфликтующего расширения. Дополнения (extensions) кардинально расширяют возможности Stable Diffusion: от управления позами через ControlNet до апскейла и пакетной обработки изображений.
В этой статье разберём, какие типы дополнений существуют, как их правильно устанавливать, обновлять и отключать, а также что делать, когда расширение ломает запуск интерфейса. Материал ориентирован на локальную установку WebUI под Windows, но общие принципы применимы и к другим сборкам.
Какие бывают дополнения для Stable Diffusion
Под словом «дополнения» пользователи обычно смешивают три разные категории, и важно их различать, потому что устанавливаются они по-разному:
- 🧩 Расширения WebUI (extensions) — плагины, добавляющие новые вкладки и функции в интерфейс: ControlNet, ADetailer, Ultimate SD Upscale, менеджеры промптов.
- 🎨 Модели и LoRA — файлы весов, которые подключаются к генерации: чекпоинты, LoRA, embeddings, VAE. Это не расширения, но их часто называют дополнениями.
- 🛠️ Скрипты (scripts) — отдельные .py-файлы, появляющиеся в выпадающем списке Script внизу интерфейса: X/Y/Z-плоты, матрицы промптов.
- 📦 Альтернативные интерфейсы — ComfyUI, Fooocus и другие оболочки с собственной экосистемой нод и плагинов.
Дальше речь пойдёт в основном о расширениях для Automatic1111 — самой распространённой оболочки. Если вы работаете в ComfyUI, логика похожа, но установка выполняется через менеджер нод (ComfyUI-Manager) или ручное копирование в папку custom_nodes.
Установка расширений через интерфейс WebUI
Самый безопасный способ — штатная вкладка Extensions. Откройте её, перейдите в подраздел Available и нажмите кнопку Load from, чтобы подтянуть актуальный список из официального индекса. Найдите нужное расширение поиском и нажмите Install.
После установки требуется перезапуск: на вкладке Installed нажмите Apply and restart UI. Учтите, что некоторые расширения при первом запуске докачивают зависимости — модели детекторов, библиотеки Python — и этот процесс может занять заметное время, а консоль при этом будет выглядеть «зависшей».
Если расширения нет в индексе, используйте подраздел Install from URL: вставьте ссылку на git-репозиторий проекта и подтвердите установку. Этот метод требует осторожности — вы фактически запускаете чужой код на своей машине.
⚠️ Внимание: устанавливайте расширения только из репозиториев с хорошей репутацией. Расширение имеет полный доступ к файловой системе через Python, поэтому ссылки из случайных комментариев и перепакованные сборки — реальный риск безопасности.
☑️ Установка расширения без ошибок
Ручная установка и структура папок
Иногда автоматическая установка недоступна — например, нет git или репозиторий скачан архивом. В этом случае папку расширения копируют вручную в каталог:
stable-diffusion-webui\extensions\имя_расширенияМодели и вспомогательные файлы кладутся в другие места, и это частая причина «неработающего» дополнения. Ориентируйтесь на таблицу:
| Тип файла | Куда копировать | Расширение |
|---|---|---|
| Чекпоинт (основная модель) | models\Stable-diffusion | .safetensors, .ckpt |
| LoRA / LyCORIS | models\Lora | .safetensors, .pt |
| Embeddings (Textual Inversion) | embeddings | .pt, .safetensors |
| VAE | models\VAE | .pt, .safetensors |
| Расширения WebUI | extensions | папка с кодом |
После ручного копирования обязателен полный перезапуск WebUI — кнопка Reload UI не всегда подхватывает новые расширения. Предпочитайте файлы формата .safetensors: в отличие от .ckpt и .pt, они не выполняют произвольный код при загрузке.
Популярные дополнения и зачем они нужны
Набор расширений у каждого свой, но несколько инструментов считаются фактически стандартом. ControlNet позволяет управлять композицией через референсы: позы (OpenPose), глубину, контуры, эскизы. ADetailer автоматически дорабатывает лица и руки после основной генерации, что заметно улучшает портреты без ручного inpainting.
Для увеличения разрешения применяют Ultimate SD Upscale — он разбивает изображение на тайлы и апскейлит их с сохранением деталей. Полезны также расширения для работы с промптами: подсветка синтаксиса, история, автодополнение тегов в стиле Danbooru.
Не ставьте всё подряд. Каждое расширение увеличивает время запуска WebUI и риск конфликтов, а некоторые постоянно занимают видеопамять. Разумный подход — начать с двух-трёх проверенных инструментов и добавлять новые по мере реальной необходимости.
Обновление и отключение расширений
Обновления выполняются на вкладке Extensions → Installed: кнопка Check for updates проверяет репозитории, после чего появляется возможность применить обновления и перезапустить интерфейс. Регулярно обновлять стоит и сам WebUI — расширения часто требуют свежую версию ядра.
Чтобы временно отключить расширение без удаления, снимите галочку напротив него в списке Installed и перезапустите UI. Это удобно для диагностики: если после отключения проблема исчезла, виновник найден.
⚠️ Внимание: перед масштабным обновлением всех расширений сразу сделайте копию папки extensions. Если после апдейта интерфейс перестанет запускаться, вы сможете быстро вернуть рабочее состояние, не разбираясь с каждым плагином по отдельности.
Как откатить расширение на старую версию
Откройте папку расширения в extensions, запустите в ней терминал и выполните команду git log, чтобы увидеть список коммитов. Затем командой git checkout хеш_коммита переключитесь на нужную версию. Это работает только если расширение было установлено через git, а не скопировано архивом.
Типичные ошибки и их решение
Самая частая жалоба — WebUI не стартует после установки дополнения. Откройте консоль запуска и найдите первый traceback: в нём обычно указан путь к проблемному расширению. Быстрое решение — переименовать или удалить его папку в extensions, после чего интерфейс должен запуститься.
Вторая типичная ситуация — ошибка установки зависимостей вида ModuleNotFoundError. Она означает, что расширение не смогло поставить нужные Python-пакеты: возможная причина — отсутствие интернета при первом запуске, блокировка антивирусом или конфликт версий библиотек. Помогает повторный запуск с работающим соединением либо ручная установка пакета через pip в окружении WebUI.
Третья группа проблем — конфликт версий: расширение, написанное под старый WebUI, может ломать новые сборки, и наоборот. Если проект расширения давно не обновлялся, проверьте в его репозитории раздел Issues — там обычно уже описана ваша ошибка и способ обхода.
Если ничего не помогает, крайняя мера — чистый запуск: временно переименуйте всю папку extensions и проверьте, стартует ли «голый» WebUI. Если да — возвращайте расширения по одному, перезапуская интерфейс после каждого. Это долго, но гарантированно локализует проблему.
Совместимость с разными сборками
Расширения для Automatic1111 не работают в ComfyUI и наоборот — у этих оболочек разная архитектура. Для ComfyUI существуют свои «кастомные ноды», устанавливаемые через ComfyUI-Manager, а аналогом ControlNet выступают соответствующие ноды и модели.
Также учитывайте поколение моделей: дополнения и вспомогательные сети для SD 1.5 несовместимы с SDXL — LoRA, ControlNet-модели и embeddings нужны отдельные под каждую базу. Перед скачиванием проверяйте, для какой версии модели предназначен файл; обычно это указано на странице загрузки.
Частые вопросы
Сколько расширений можно установить одновременно?
Жёсткого лимита нет, но каждое расширение замедляет запуск и повышает риск конфликтов. Практичный ориентир — оставлять активными только те инструменты, которыми вы реально пользуетесь, а остальные отключать галочкой в списке Installed.
Безопасно ли ставить расширения по ссылке на репозиторий?
Только если источник заслуживает доверия. Расширение — это исполняемый Python-код с полным доступом к системе. Проверяйте популярность репозитория, дату последнего обновления и отзывы пользователей перед установкой.
Почему LoRA не появляется в списке после копирования?
Проверьте три момента: файл лежит именно в models\Lora, вы нажали кнопку обновления (refresh) в интерфейсе, и сам файл не повреждён при скачивании. Если файл скачан не полностью, WebUI может молча его игнорировать.
WebUI падает при запуске после установки расширения — что делать?
Найдите в консоли traceback с именем расширения и удалите или переименуйте его папку в extensions. После запуска проверьте совместимость версий: возможно, расширение требует более свежий или, наоборот, старый WebUI.
Нужно ли ставить расширения заново после обновления WebUI?
Нет, папка extensions сохраняется при обновлении. Но после крупных обновлений ядра часть расширений может оказаться несовместимой — в этом случае обновите их через Check for updates или дождитесь фикса от автора.