Обзор развертывания ComfyUI на сервере¶
Предварительные требования¶
Для корректной работы приложения требуются следующие условия:
-
Операционная система: Debian или Ubuntu.
-
Наличие видеокарты NVIDIA (требуется драйвер версии не ниже 580).
-
Доступ к интернету для загрузки пакетов, моделей и зависимостей Python.
-
Права суперпользователя (
root) для установки системных пакетов и управления сервисами.
FQDN итоговой панели на домене hostkey.in¶
| Параметр | Значение | | Префикс | comfyui | | Домен | hostkey.in | | Полный шаблон | comfyui{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
Основные компоненты системы расположены по следующим путям:
-
/root/ComfyUI— рабочая директория приложения (исходный код, модели, пользовательские данные). -
/etc/systemd/system/comfyui.service— файл конфигурации системного сервиса. -
/root/nginx— конфигурация и файлы Docker для прокси-сервера Nginx.
Процесс установки приложения¶
Установка выполняется в несколько этапов:
-
Подготовка системы: Обновление репозиториев APT и проверка наличия драйверов NVIDIA. Если установлены устаревшие версии или конфликтующие драйверы, производится их полная очистка.
-
Настройка графической подсистемы: Установка заголовочных файлов ядра (
linux-headers), пакетаdkmsи установка открытого драйвера NVIDIA (nvidia-open) версии 580 или выше. Выполняется настройкаblacklistдля модуляnouveau. -
Подготовка среды Python:
-
Установка
python3-pip. -
Принудительная переустановка PyTorch с поддержкой CUDA 13.0 (
torch,torchvision,torchaudio). -
Клонирование репозитория ComfyUI из GitHub в директорию
/root/ComfyUI. -
Установка зависимостей через
pip install -r requirements.txt. -
Загрузка моделей: Автоматическая загрузка модели
flux1-dev-fp8.safetensorsв директорию/root/ComfyUI/models/checkpoints/с поддержкой докачки при обрыве соединения. -
Настройка приложения: Создание пользовательских рабочих процессов (workflows) и конфигурационных файлов настроек (
comfy.settings.json). -
Регистрация сервиса: Создание системного юнита
systemdдля автоматического запуска ComfyUI в фоновом режиме.
Права доступа и безопасность¶
-
Для работы приложения используется пользователь
root. -
Настройка брандмауэра и ограничение доступа не описываются, однако приложение работает через защищенный прокси-сервер Nginx.
-
Файлы конфигурации сервиса имеют права
0644.
Базы данных¶
В данной конфигурации использование внешних баз данных не предусмотрено; данные хранятся локально в директории приложения.
Контейнеры Docker и их запуск¶
Для обеспечения работы веб-интерфейса через HTTPS используется контейнерный прокси:
| Имя образа | Порты | Тома (volumes) | Переменные окружения | Политика перезапуска |
|---|---|---|---|---|
jonasal/nginx-certbot:latest | host mode | nginx_secrets:/etc/letsencrypt/data/nginx/user_conf.d:/etc/nginx/user_conf.d | CERTBOT_EMAIL=hkadm@hostkey.com | unless-stopped |
Контейнер работает в режиме network_mode: host для обеспечения корректной работы с сертификатами и портами.
Кастомные скрипты и дополнительные настройки¶
В процессе развертывания выполняются следующие действия:
-
Настройка окружения: Удаление записей о зеркалах HuggingFace из
/etc/hostsдля обеспечения прямого доступа к ресурсам. -
Инициализация рабочих процессов: Размещение файла
flux1-dev-fp8.jsonв директории/root/ComfyUI/user/default/workflows. -
Конфигурация настроек: Применение кастомного файла
comfy.settings.jsonдля настройки интерфейса (язык, режим меню).
Инструкция по обновлению приложения¶
Для обновления основного приложения ComfyUI необходимо выполнить следующие действия:
-
Перейти в директорию приложения:
cd /root/ComfyUI. -
Выполнить обновление исходного кода (через git) или загрузить новую версию.
-
Обновить зависимости Python:
pip install -r requirements.txt --upgrade. -
Перезапустить сервис:
systemctl restart comfyui.
Расположение конфигурационных файлов и данных¶
-
Конфигурация приложения:
/root/ComfyUI/user/default/comfy.settings.json -
Рабочие процессы (Workflows):
/root/ComfyUI/user/default/workflows/ -
Модели (Checkpoints):
/root/ComfyUI/models/checkpoints/
Доступные порты для подключения¶
| Порт | Назначение | Протокол |
|---|---|---|
443 | Веб-интерфейс (через Nginx) | HTTPS |
8188 | Внутренний порт приложения | HTTP |
Запуск, остановка приложения¶
Управление приложением осуществляется через системный менеджер systemd:
-
Запуск:
systemctl start comfyui -
Остановка:
systemctl stop comfyui -
Проверка статуса:
systemctl status comfyui -
Включение автозапуска при загрузке системы:
systemctl enable comfyui