Если вкладка Extensions в AUTOMATIC1111 WebUI показывает пустой список или расширение после установки не появляется в интерфейсе, причина чаще всего кроется в конфликте зависимостей Python, устаревшей версии WebUI или ошибке при клонировании репозитория через git. Эти проблемы решаются без переустановки всего окружения — достаточно проверить лог консоли при запуске и действовать по шагам, описанным ниже.
Расширения (extensions) — это основной способ расширить возможности Stable Diffusion: от удобного просмотра метаданных изображений до продвинутого инпейнтинга и анимации. В этой статье разберём, как работает система плагинов, какие расширения стоит поставить в первую очередь, как избежать конфликтов и что делать, если WebUI перестал запускаться после установки очередного дополнения.
Что такое extensions и как они работают
Extensions — это дополнения для веб-интерфейса AUTOMATIC1111 Stable Diffusion WebUI (а также для форков вроде Forge и SD.Next), которые добавляют новые вкладки, кнопки, модели и функции. Технически каждое расширение — это папка с Python-скриптами, которая размещается в директории extensions внутри каталога WebUI.
При запуске WebUI сканирует эту папку, подгружает скрипты и устанавливает зависимости, указанные в файле requirements.txt конкретного расширения. Именно на этом этапе возникает большинство ошибок: если версия библиотеки конфликтует с уже установленной, запуск может зависнуть или завершиться с traceback в консоли.
Ключевой момент: расширения выполняются с полными правами внутри вашего окружения. Скрипт плагина может читать файлы и отправлять данные в сеть, поэтому ставить стоит только дополнения из известных репозиториев с открытым кодом.
Способы установки расширений
Существует три рабочих способа добавить extension в WebUI. Первый и самый удобный — через встроенный каталог: откройте вкладку Extensions → Available, нажмите Load from, найдите нужное расширение и кликните Install. После этого перейдите на вкладку Installed и нажмите Apply and restart UI.
Второй способ — установка по ссылке на GitHub. На вкладке Extensions → Install from URL вставьте адрес репозитория и подтвердите установку. Этот метод подходит для плагинов, которых нет в официальном индексе.
Третий вариант — ручная установка через git. Она полезна, когда веб-интерфейс не запускается или нужна конкретная ветка репозитория:
cd stable-diffusion-webui/extensions
git clone https://github.com/имя-пользователя/имя-расширения.git
После ручного клонирования перезапустите WebUI полностью — зависимости подтянутся автоматически при старте. Если этого не произошло, проверьте наличие файла install.py в папке расширения: именно он отвечает за установку зависимостей.
☑️ Установка расширения без ошибок
Лучшие расширения для Stable Diffusion
Выбор плагинов зависит от задач, но есть набор расширений, которые полезны почти каждому пользователю. Ниже — проверенные временем варианты с открытым исходным кодом и активной поддержкой сообщества.
- 🎛️ ControlNet — управление позой, глубиной и композицией генерации через дополнительные входные изображения.
- 🖼️ ADetailer — автоматическая детализация лиц и рук на готовых изображениях без ручного инпейнтинга.
- 📚 Civitai Helper — загрузка моделей, LoRA и превью напрямую с Civitai из интерфейса WebUI.
- 🗂️ Image Browser — удобный просмотр сгенерированных изображений с метаданными и фильтрами.
- 🌐 sd-webui-prompt-all-in-one — перевод и автодополнение промптов, полезно при работе с английскими запросами.
Перед установкой обязательно читайте описание репозитория: у некоторых расширений есть требования к версии WebUI, объёму видеопамяти или конкретным моделям. Например, ControlNet требует скачивания отдельных управляющих моделей — без них вкладка появится, но работать не будет.
Сравнение популярных расширений
Чтобы проще выбрать, сведём ключевые характеристики основных плагинов в одну таблицу. Данные ориентировочные — требования могут меняться с обновлениями, сверяйтесь с README конкретного репозитория.
| Расширение | Назначение | Доп. файлы | Сложность |
|---|---|---|---|
| ControlNet | Контроль композиции | Управляющие модели | Средняя |
| ADetailer | Улучшение лиц | Детекторы YOLO | Низкая |
| Civitai Helper | Загрузка моделей | Не требуются | Низкая |
| Image Browser | Просмотр галереи | Не требуются | Низкая |
| Deforum | Анимация и видео | FFmpeg | Высокая |
Обратите внимание на колонку «Сложность»: тяжёлые расширения вроде Deforum требуют дополнительных системных компонентов и тонкой настройки. Начинать знакомство с extensions лучше с простых утилит.
Типичные ошибки и их решение
Самая частая жалоба — WebUI не стартует после установки расширения. Откройте консоль запуска и найдите последний traceback: в нём обычно указано имя проблемного скрипта и папка плагина. Самый быстрый способ восстановить работу — удалить или переименовать папку этого расширения в extensions и запустить WebUI снова.
⚠️ Внимание: не удаляйте папкуextensions-builtin— в ней находятся встроенные компоненты WebUI (например, Lora и ScuNET). Удалять можно только содержимое папкиextensions, куда ставятся сторонние плагины.
Вторая распространённая ситуация — ошибка ModuleNotFoundError. Она означает, что зависимость расширения не установилась. Возможное решение — активировать виртуальное окружение WebUI (папка venv) и вручную установить недостающий пакет через pip install имя-пакета. Точное имя модуля указано в тексте ошибки.
Третий тип проблем — конфликт версий: расширение требует более новую версию torch или gradio, чем установлена. Здесь безопаснее обновить сам WebUI через git pull, чем вручную менять версии библиотек — принудительное обновление одной зависимости часто ломает другие плагины.
Как запустить WebUI без расширений для диагностики
Добавьте флаг --disable-all-extensions в файл webui-user.bat (в строку set COMMANDLINE_ARGS=). WebUI запустится в чистом виде — если ошибка исчезла, проблема точно в одном из плагинов. Далее возвращайте расширения по одному, чтобы найти виновника.
Обновление и удаление расширений
Обновлять плагины удобнее всего через вкладку Extensions → Installed: нажмите Check for updates, дождитесь проверки и примените обновления кнопкой Apply and restart UI. Для вручную установленных расширений можно зайти в папку плагина и выполнить git pull.
Удаление выполняется двумя путями. Через интерфейс — снятием галочки напротив расширения и перезапуском UI: плагин отключится, но файлы останутся на диске. Для полного удаления закройте WebUI и удалите папку расширения из extensions вручную.
⚠️ Внимание: перед массовым обновлением расширений сделайте копию папки extensions. Обновления плагинов не тестируются на совместимость друг с другом, и откат через копию папки — самый быстрый способ вернуть рабочую конфигурацию.
Полное отключение всех расширений флагом запуска — единственный способ быстро проверить, связана ли проблема с плагинами или с самим WebUI. Запомните этот приём, он сэкономит часы диагностики.
Безопасность при работе с extensions
Расширения — это исполняемый код, который запускается на вашем компьютере без песочницы. Прецеденты с вредоносными плагинами в сообществе уже были, поэтому к выбору источников стоит относиться внимательно.
- 🔒 Устанавливайте расширения только с GitHub и только из репозиториев с историей, звёздами и issues.
- 🧐 Перед установкой незнакомого плагина просмотрите его
install.py— там не должно быть загрузок со сторонних подозрительных адресов. - 🚫 Не запускайте WebUI с флагом
--enable-insecure-extension-access, если открываете доступ к интерфейсу по сети. - 💾 Держите резервную копию рабочей папки
extensionsперед экспериментами с новыми плагинами.
Если WebUI доступен из локальной сети или через туннель, вредоносное расширение теоретически может получить доступ к вашим файлам удалённо. Для публичных инстансов используйте только проверенный минимум плагинов.
FAQ: частые вопросы о расширениях
Почему расширение установлено, но вкладка не появилась?
Чаще всего причина в неудачной установке зависимостей — проверьте консоль на наличие ошибок при запуске. Также некоторые расширения добавляют не вкладку, а блок внутри существующих разделов (например, ADetailer появляется внизу страницы txt2img). Проверьте Settings — часть плагинов включается там.
Совместимы ли расширения AUTOMATIC1111 с Forge и SD.Next?
Частично. Многие популярные плагины адаптированы под форки, но гарантии нет — сверяйтесь с README конкретного расширения. В SD.Next есть собственный механизм совместимости, однако плагины, глубоко завязанные на внутренности A1111, могут работать с ошибками.
Можно ли установить расширение без интернета?
Да, если заранее скачать архив репозитория и все зависимости. Распакуйте папку в extensions, а пакеты Python установите из локальных wheel-файлов. На практике это трудоёмко, поэтому проще ставить плагины при подключении к сети.
WebUI зависает на этапе "Installing requirements" — что делать?
Подождите несколько минут: загрузка больших библиотек может занимать время. Если процесс явно завис, закройте консоль, удалите папку проблемного расширения и попробуйте установить его снова при стабильном соединении. Иногда помогает ручная установка зависимостей через pip в активированном venv.
Как откатить расширение на предыдущую версию?
Через git: зайдите в папку плагина, выполните git log, найдите нужный коммит и переключитесь командой git checkout хеш-коммита. После этого перезапустите WebUI. Учтите, что старая версия может быть несовместима с текущей версией самого WebUI.