Skip to content
Follow me on X
•ComfyUI Wiki
Руководство по установке1. Install ComfyUI1.4 Linux

SVI 2.0 Pro Выпущен - Генерация Видео Бесконечной Длительности с Поддержкой Wan 2.2

29.12.2025

Как установить ComfyUI на Linux

⚠️ Важное уведомление: Эта документация может не всегда быть актуальной. Пожалуйста, в первую очередь обратитесь к Официальному репозиторию ComfyUI для получения самых последних и точных инструкций по установке, особенно для конкретных конфигураций, таких как поддержка GPU AMD. Официальная документация является лучшим источником актуальной информации.

Есть два основных способа установки ComfyUI на Linux:

  1. Установка с использованием Comfy CLI (Рекомендуется) - Самый простой и быстрый метод
  2. Установка из исходного кода ComfyUI - Традиционный метод ручной установки

Этот учебник подробно охватит оба метода установки, с акцентом на рекомендацию установки Comfy CLI.

Метод 1: Установка ComfyUI с использованием Comfy CLI (Рекомендуется)

Comfy CLI - это официальный инструмент командной строки, предоставляемый ComfyUI, который значительно упрощает процесс установки и управления ComfyUI.

Шаг 1: Подготовка системной среды

1. Обеспечение среды Python

ComfyUI требует Python 3.12 или выше (рекомендуется Python 3.13). Проверьте версию Python:

python3 --version

Если Python не установлен или версия слишком низкая, установите его, следуя этим шагам:

Системы Ubuntu/Debian:

sudo apt update
sudo apt install python3 python3-pip python3-venv

Системы CentOS/RHEL/Fedora:

# CentOS/RHEL
sudo yum install python3 python3-pip
# Или Fedora
sudo dnf install python3 python3-pip

Arch Linux:

sudo pacman -S python python-pip

2. Установка Git (если не установлен)

# Ubuntu/Debian
sudo apt install git
 
# CentOS/RHEL
sudo yum install git
 
# Fedora
sudo dnf install git
 
# Arch Linux
sudo pacman -S git

3. Создание виртуальной среды (Рекомендуется)

Использование виртуальной среды может избежать проблем с конфликтами пакетов:

# Создать виртуальную среду с именем comfy-env
python3 -m venv comfy-env
 
# Активировать виртуальную среду
source comfy-env/bin/activate

Примечание: Вам нужно активировать виртуальную среду каждый раз перед использованием ComfyUI. Для выхода из виртуальной среды используйте команду deactivate.

Шаг 2: Установка Comfy CLI

Установите comfy-cli в активированной виртуальной среде:

pip install comfy-cli

Настройка автодополнения командной строки (Опционально)

Для получения лучшего пользовательского опыта вы можете включить автодополнение командной строки:

comfy --install-completion

Шаг 3: Установка ComfyUI

Установка ComfyUI с comfy-cli очень проста, требует всего одну команду:

comfy install

Эта команда будет:

  • Скачивать и устанавливать последнюю версию ComfyUI
  • Автоматически устанавливать ComfyUI-Manager (менеджер узлов)
  • Настраивать базовую структуру проекта

Опции установки

Вы можете использовать следующие опции для настройки установки:

# Установить в место по умолчанию ~/comfy
comfy install
 
# Установить в указанную директорию
comfy --workspace=/path/to/your/workspace install
 
# Операции на существующем ComfyUI в текущей директории (в основном для обновлений)
comfy --here install
 
# Операции на наиболее недавно выполненном или установленном ComfyUI
comfy --recent install
 
# Установить только ComfyUI, без ComfyUI-Manager
comfy install --skip-manager

Проверка пути установки

Вы можете использовать следующие команды для проверки текущего рабочего пространства:

# Проверить рабочее пространство по умолчанию
comfy which
 
# Проверить рабочее пространство для указанных опций
comfy --recent which
comfy --here which

Шаг 4: Установка поддержки GPU

NVIDIA GPU (CUDA)

Если вы используете GPU NVIDIA, вам нужно установить поддержку CUDA:

# Установить PyTorch с поддержкой CUDA
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

Примечание: Пожалуйста, выберите соответствующую версию PyTorch на основе вашей версии CUDA. Посетите сайт PyTorch для получения последних команд установки.

AMD GPU (ROCm)

Если вы используете GPU AMD, вам нужно установить версию PyTorch с ROCm. В зависимости от вашей системы, вы можете попробовать следующие версии:

# Попробовать ROCm 6.4 (рекомендуется, если ссылка 6.0 не работает)
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4
 
# Или попробовать ROCm 6.0
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.0

Примечание: Если ссылка версии ROCm не работает, пожалуйста, попробуйте другие версии. Вы также можете посетить веб-сайт PyTorch для получения последних команд установки ROCm.

Для GPU AMD, не официально поддерживаемых ROCm

Если ваш GPU AMD не официально поддерживается ROCm (например, RX 6700, RX 6600, RX 7600 и т.д.), вы можете использовать переменные окружения для принудительного включения поддержки:

Для GPU архитектуры RDNA2 (например, RX 6700, RX 6600 и т.д.):

HSA_OVERRIDE_GFX_VERSION=10.3.0 comfy launch

Для GPU архитектуры RDNA3 (например, RX 7600 и т.д.):

HSA_OVERRIDE_GFX_VERSION=11.0.0 comfy launch

Если вы используете метод установки из исходного кода:

# GPU RDNA2
HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py
 
# GPU RDNA3
HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.py
Советы по оптимизации производительности GPU AMD

В последних версиях PyTorch вы можете попробовать включить экспериментальный механизм эффективного внимания памяти для улучшения производительности (включен по умолчанию на GPU RDNA3):

TORCH_ROCM_AOTRITON_ENABLE_EXPERIMENTAL=1 comfy launch -- --use-pytorch-cross-attention

Вы также можете попробовать установить следующую переменную окружения, которая может повысить скорость (но первый запуск будет медленнее):

PYTORCH_TUNABLEOP_ENABLED=1 comfy launch

Только CPU

Если запуск только с CPU:

# Установить версию PyTorch для CPU
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu

Шаг 5: Запуск ComfyUI

После завершения установки запустите ComfyUI:

comfy launch

По умолчанию ComfyUI будет работать на http://localhost:8188.

Общие опции запуска

# Указать адрес прослушивания и порт
comfy launch -- --listen 0.0.0.0 --port 8080
 
# Использовать режим CPU
comfy launch -- --cpu
 
# Режим низкой VRAM
comfy launch -- --lowvram
 
# Режим сверхнизкой VRAM
comfy launch -- --novram

Примечание: Параметр --background может больше не поддерживаться в некоторых версиях ComfyUI. Если вам нужно запустить в фоне, рассмотрите использование системных инструментов, таких как nohup или screen.

Метод 2: Установка из исходного кода ComfyUI

Если вы предпочитаете традиционный метод установки, вы также можете установить напрямую из исходного кода:

1. Клонирование репозитория ComfyUI

git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI

2. Создание виртуальной среды

python3 -m venv venv
source venv/bin/activate

3. Установка зависимостей

pip install -r requirements.txt

4. Установка поддержки GPU

Установите соответствующую версию PyTorch на основе вашего типа GPU (см. шаги выше).

5. Запуск ComfyUI

python main.py

Если вы используете GPU AMD и сталкиваетесь с проблемами, пожалуйста, обратитесь к разделу устранения неполадок GPU AMD ниже.

Послеустановленная настройка

Установка базовых моделей

ComfyUI требует базовые модели для корректной работы. Вы можете:

  1. Скачать модели с Hugging Face
  2. Поместите файлы моделей в директорию models/checkpoints/
  3. Скачайте с помощью comfy-cli:
comfy model download --url https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors --relative-path models/checkpoints

Устранение неполадок

Распространенные проблемы

1. Проблемы с разрешениями

Если вы столкнетесь с проблемами разрешений, убедитесь, что у вас достаточно прав для записи в директорию установки:

# Если используется директория по умолчанию, убедитесь, что директория ~/comfy доступна для записи
ls -la ~/comfy

2. Проблемы с версией Python

Убедитесь, что вы используете правильную версию Python:

python3 --version  # Должно быть 3.9 или выше

3. Проблемы с сетевым подключением

Если загрузки медленные, попробуйте использовать домашнюю зеркальную страницу:

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple comfy-cli

4. Проблемы с обнаружением GPU

Проверьте, правильно ли распознан GPU:

import torch
print(torch.cuda.is_available())  # NVIDIA GPU
print(torch.version.cuda)         # Версия CUDA

5. Проблемы с GPU AMD

Проблема: Сообщение об ошибке о том, что драйвер NVIDIA не найден при запуске

Причина: Даже после установки версии PyTorch с ROCm, если система обнаруживает драйверы NVIDIA или неправильную конфигурацию, эта ошибка все еще может возникнуть.

Решения:

  1. Убедитесь, что у вас установлена правильная версия ROCm PyTorch:

    python -c "import torch; print(torch.__version__)"

  2. Проверьте, находитесь ли вы в виртуальном окружении:

    # Убедитесь, что виртуальное окружение активировано
source comfy-env/bin/activate  # или путь к вашему виртуальному окружению

  3. Для GPU AMD, не официально поддерживаемых, используйте переменные окружения:

    # GPU RDNA2
HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py
 
# GPU RDNA3
HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.py

  4. Если проблема сохраняется, попробуйте запустить в режиме CPU:

    python main.py --cpu

  5. Обратитесь к официальной документации: Для получения дополнительной информации о GPU AMD, пожалуйста, обратитесь к разделу GPU AMD официального репозитория ComfyUI.

Проблема: Ссылка ROCm не работает

Если вы столкнулись с проблемой неработающей ссылки ROCm 6.0, пожалуйста, попробуйте:

  • Использовать версию ROCm 6.4
  • Посетить веб-сайт PyTorch для получения последних команд установки

6. Проблемы с путем виртуального окружения

Проблема: Не удается найти путь виртуального окружения после закрытия ComfyUI

Решения:

  1. Запомните полный путь виртуального окружения:

    # При создании виртуального окружения используйте абсолютный путь или запомните относительный путь
cd ~/your-workspace
python3 -m venv comfy-env

  2. Активируйте виртуальное окружение перед каждым использованием:

    # Перейдите в директорию виртуального окружения
cd ~/your-workspace
source comfy-env/bin/activate

  3. Используйте comfy-cli для управления (рекомендуется): comfy-cli автоматически управляет виртуальными окружениями, ручная активация не требуется.

  4. Создайте скрипт запуска:

    # Создать start-comfy.sh
#!/bin/bash
cd ~/your-workspace
source comfy-env/bin/activate
comfy launch

    Затем добавьте права на выполнение с помощью chmod +x start-comfy.sh.

7. Проблемы с установкой PyTorch

Проблема: Загрузка PyTorch прервана (Killed)

Решения:

  1. Увеличьте системный файл подкачки (если памяти недостаточно)
  2. Используйте домашнее зеркало: 
    pip install -i https://pypi.tuna.tsinghua.edu.cn/simple torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124
  3. Установите поэтапно: 
    pip install torch --index-url https://download.pytorch.org/whl/cu124
pip install torchvision --index-url https://download.pytorch.org/whl/cu124
pip install torchaudio --index-url https://download.pytorch.org/whl/cu124

Итог

Использование Comfy CLI - лучший способ установки ComfyUI на Linux, предлагая:

  • Простой процесс установки: Полная установка с одной командой
  • Полное управление зависимостями: Автоматически обрабатывает все зависимости
  • Мульти-рабочие пространства: Может управлять несколькими экземплярами ComfyUI
  • Кросс-платформенная совместимость: Работает корректно на Windows, macOS и Linux

Если вы новичок в ComfyUI, мы настоятельно рекомендуем использовать Comfy CLI для установки и управления.

Следующие шаги

После установки вы можете:

Связанные ссылки

1.3 Mac1.5 Run on Cloud