Если Stable Diffusion WebUI не запускается с флешки или внешнего диска и выдаёт ошибку вида «Python не найден», чаще всего причина в том, что портативная сборка распакована в папку с русскими буквами или пробелами в пути — встроенный интерпретатор Python и скрипты запуска критичны к таким символам. Перенесите всю директорию в корень диска с коротким путём вроде D:\sd-webui и повторите запуск через webui-user.bat.
Портативная версия Automatic1111 WebUI (или её аналогов вроде Forge) позволяет хранить весь инструментарий генерации изображений — Python, зависимости, модели, LoRA и расширения — в одной самодостаточной папке. Такой вариант удобен, когда нужно работать на разных компьютерах, не засорять системный диск или держать несколько независимых конфигураций. Ниже разберём, как правильно развернуть портативную сборку, перенести модели и решить типичные проблемы.
Что такое портативная версия Stable Diffusion WebUI
Под портативностью понимается сборка, где все компоненты лежат внутри одной папки: встроенный Python, библиотека PyTorch, файлы интерфейса, кэши и пользовательские данные. Ничего не прописывается в системный реестр и глобальные переменные окружения, поэтому папку можно свободно копировать между дисками и компьютерами.
Официального «portable-релиза» у Automatic1111 нет — портативность достигается двумя способами. Первый — готовые сборки от энтузиастов, где всё уже настроено. Второй — самостоятельная установка в отдельную папку с флагом, направляющим кэши внутрь неё. Оба подхода рабочие, но готовые сборки требуют доверия к источнику.
Системные требования и подготовка
Перед развёртыванием убедитесь, что компьютер соответствует базовым требованиям. Главный фактор — видеокарта с поддержкой CUDA от NVIDIA: комфортная работа начинается примерно от 6–8 ГБ видеопамяти, хотя с оптимизациями возможна генерация и на 4 ГБ. На картах AMD под Windows всё заметно сложнее, а запуск только на CPU будет крайне медленным.
- 🎮 Видеокарта NVIDIA с актуальным драйвером и поддержкой CUDA
- 💾 Свободное место на диске — от 20–30 ГБ с учётом моделей (каждая весит 2–7 ГБ)
- 🧠 Оперативная память — желательно от 16 ГБ
- 📁 Файловая система NTFS, путь к папке без кириллицы и пробелов
- 🌐 Стабильный интернет для первичной загрузки зависимостей
⚠️ Внимание: не размещайте портативную папку на медленной флешке USB 2.0 — загрузка моделей по несколько гигабайт будет занимать минуты, а интерфейс станет подтормаживать. Используйте внешний SSD или быстрый накопитель USB 3.0 и выше.
Где взять и как установить портативную сборку
Самый контролируемый способ — собрать портативную версию самостоятельно. Скачайте репозиторий Automatic1111 или Forge с официального GitHub в виде архива, распакуйте в выбранную папку и запустите webui-user.bat. При первом запуске скрипт сам скачает Python-зависимости в подпапку venv — это и есть основа портативности.
Чтобы кэши моделей Hugging Face и pip не уходили в системный профиль пользователя, добавьте в начало файла webui-user.bat переменные окружения:
set HF_HOME=%~dp0cache\huggingface
set PIP_CACHE_DIR=%~dp0cache\pip
set XDG_CACHE_HOME=%~dp0cache
После этого вся сборка действительно становится самодостаточной. Если вы выбираете готовую сборку от стороннего автора, проверяйте источник: загружайте только из известных репозиториев и сканируйте архив антивирусом, так как внутри находятся исполняемые файлы.
☑️ Проверка после установки
Перенос и подключение моделей
Модели — самая объёмная часть сборки. Чекпоинты размещаются в папке models\Stable-diffusion, LoRA — в models\Lora, VAE — в models\VAE. Если у вас уже есть библиотека моделей на другом диске, не обязательно копировать её: можно указать внешние пути через аргументы командной строки.
set COMMANDLINE_ARGS=--ckpt-dir "E:\models\checkpoints" --lora-dir "E:\models\lora"Такой подход особенно удобен, когда портативная WebUI используется на нескольких машинах: модели остаются на большом внешнем диске, а сама сборка занимает минимум места. Учтите, что буква диска на другом компьютере может отличаться — тогда путь придётся поправить.
Настройка запуска и оптимизация
Поведение WebUI управляется аргументами в строке COMMANDLINE_ARGS файла webui-user.bat. На картах с малым объёмом видеопамяти помогают флаги --medvram или --lowvram, а для ускорения генерации часто добавляют --xformers — оптимизированную реализацию механизма внимания.
| Аргумент | Назначение | Когда применять |
|---|---|---|
--xformers | Ускорение генерации и снижение расхода VRAM | На большинстве карт NVIDIA |
--medvram | Экономия видеопамяти ценой скорости | Карты с 4–6 ГБ VRAM |
--lowvram | Максимальная экономия VRAM | Очень слабые карты |
--port 7861 | Смена порта интерфейса | Конфликт с другой копией WebUI |
--autolaunch | Автооткрытие браузера при старте | По желанию, для удобства |
Не добавляйте все флаги сразу: часть из них взаимоисключающие, а лишние оптимизации иногда вызывают артефакты или падения. Изменяйте параметры по одному и проверяйте результат тестовой генерацией.
Типичные ошибки и их решение
Наиболее частая проблема портативных сборок — конфликт с уже установленным в системе Python. Если скрипт подхватывает системный интерпретатор вместо встроенного, зависимости ставятся не туда и WebUI не стартует. Проверьте, что в папке сборки есть каталог venv или встроенный python, и что bat-файл ссылается именно на него.
- 🚫 Ошибка «CUDA out of memory» — снизьте разрешение генерации, уберите лишние модели из памяти или добавьте
--medvram - 🐌 Очень медленная генерация — проверьте, не работает ли сборка на CPU; в консоли при запуске указывается используемое устройство
- 📦 Расширение сломало запуск — удалите его папку из
extensionsи перезапустите - 🔁 Бесконечная переустановка зависимостей — часто признак запуска от имени администратора с другим окружением или антивирусной блокировки
⚠️ Внимание: не запускайте портативную сборку одновременно с обычной установленной копией WebUI на том же порту — обе попытаются занять127.0.0.1:7860, и одна из них завершится с ошибкой. Разведите их по разным портам через--port.
Почему после переноса на другой ПК пропали настройки
Часть настроек хранится в файле config.json в корне сборки и переносится нормально, но расширения могут держать свои конфиги в собственных папках или в ui-config.json. Проверьте, что вы скопировали всю директорию целиком, включая скрытые подпапки, а не только models и outputs.
Обновление портативной версии
Обновление портативной сборки зависит от способа её создания. Если папка содержит каталог .git, достаточно выполнить в ней git pull — как и в обычной установке. Готовые архивные сборки без git обновляются заменой файлов программы, при этом папки models, outputs, extensions и файлы настроек трогать не нужно.
Перед любым обновлением сделайте копию папки целиком или хотя бы файла config.json и списка установленных расширений — это единственный надёжный способ откатиться, если новая версия окажется несовместима с вашими дополнениями. Вся прелесть портативности как раз в том, что резервная копия делается простым копированием папки.
Часто задаваемые вопросы
Можно ли запускать портативную WebUI с флешки?
Технически да, но практично только с быстрых накопителей USB 3.0 и выше, лучше — с внешнего SSD. Модели весят гигабайты, и на медленной флешке их загрузка будет занимать очень много времени.
Будет ли сборка работать на другом компьютере без доработок?
В большинстве случаев да, если на целевом ПК есть совместимая видеокарта NVIDIA с актуальным драйвером. Может потребоваться поправить букву диска в путях к внешним моделям и порт, если он занят.
Чем портативная версия отличается от обычной установки?
Функционально — ничем, интерфейс и возможности идентичны. Разница только в организации файлов: все зависимости, кэши и данные изолированы в одной папке и не затрагивают систему.
Конфликтует ли портативная WebUI с установленным Python?
При корректной сборке — нет, поскольку используется собственное виртуальное окружение venv. Конфликты возникают, только если скрипт запуска по ошибке подхватывает системный интерпретатор.
Как перенести наработанные промпты и настройки на другую копию?
Скопируйте файлы config.json и ui-config.json из корня сборки, а также папку outputs, если нужны сгенерированные изображения с их метаданными. Параметры генерации также можно извлечь из любого сохранённого PNG через вкладку PNG Info.