Skip to content
Follow me on X
•ComfyUI Wiki
설치 가이드1. ComfyUI 설치1.4 리눅스에 ComfyUI 설치

Qwen-Image-Layered 출시 - 레이어 기반 편집을 지원하는 이미지 생성 모델

2025. 12. 19.

Linux에서 ComfyUI 설치 방법

⚠️ 중요 알림: 이 문서는 항상 최신 상태를 유지하지 않을 수 있습니다. 최신 및 가장 정확한 설치 지침은 ComfyUI 공식 저장소를 우선적으로 참조하세요 특히 AMD GPU 지원과 같은 특정 구성에 대한 자세한 정보는 공식 문서가 최신 정보의 최상의 소스입니다.

Linux에서 ComfyUI를 설치하는 주요 방법은 두 가지입니다:

  1. Comfy CLI를 사용한 설치 (권장) - 가장 간단하고 빠른 방법
  2. ComfyUI 소스 코드로부터 설치 - 전통적인 수동 설치 방법

이 튜토리얼은 Comfy CLI 설치를 권장하면서 두 설치 방법 모두를 자세히 다룹니다.

방법 1: Comfy CLI를 사용한 ComfyUI 설치 (권장)

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 설치

comfy-cli로 ComfyUI를 설치하는 것은 매우 간단하며, 하나의 명령만 필요합니다:

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)

NVIDIA GPU를 사용하는 경우 CUDA 지원을 설치해야 합니다:

# CUDA 지원이 있는 PyTorch 설치
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

참고: CUDA 버전에 따라 해당하는 PyTorch 버전을 선택하세요. 최신 설치 명령은 PyTorch 웹사이트를 참조하세요.

AMD GPU (ROCm)

AMD GPU를 사용하는 경우 ROCm 버전의 PyTorch를 설치해야 합니다:

# ROCm 지원 PyTorch 설치
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4

참고: 최신 ROCm 설치 명령은 PyTorch 웹사이트를 참조하세요.

ROCm에서 공식적으로 지원하지 않는 AMD GPU의 경우

AMD GPU가 ROCm에서 공식적으로 지원되지 않는 경우 (RX 6700, RX 6600, RX 7600 등) 환경 변수를 사용하여 지원을 강제로 활성화할 수 있습니다:

RDNA2 아키텍처 GPU (RX 6700, RX 6600 등)의 경우:

HSA_OVERRIDE_GFX_VERSION=10.3.0 comfy launch

RDNA3 아키텍처 GPU (RX 7600 등)의 경우:

HSA_OVERRIDE_GFX_VERSION=11.0.0 comfy launch

소스 코드 설치 방법을 사용하는 경우:

# RDNA2 GPU
HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py
 
# RDNA3 GPU
HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.py
AMD GPU 성능 최적화 팁

최신 PyTorch 버전에서는 실험적인 메모리 효율적인 주의 메커니즘을 활성화하여 성능을 향상시킬 수 있습니다 (RDNA3 GPU에서는 기본적으로 활성화됨):

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

다음 환경 변수를 설정하는 것도 시도할 수 있으며 속도가 향상될 수 있습니다 (단, 첫 실행은 느려집니다):

PYTORCH_TUNABLEOP_ENABLED=1 comfy launch

CPU만 사용

CPU만으로 실행하는 경우:

# CPU 버전의 PyTorch 설치
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 지원 설치

GPU 유형에 따라 해당하는 PyTorch 버전을 설치합니다 (위의 단계 참조).

5. ComfyUI 실행

python main.py

AMD GPU를 사용하고 문제가 발생한 경우 아래의 AMD GPU 문제 해결 섹션을 참조하세요.

설치 후 구성

기본 모델 설치

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. AMD GPU 문제

문제: 시작 시 NVIDIA 드라이버를 찾을 수 없다는 오류 메시지

원인: ROCm 버전의 PyTorch를 설치한 후에도 시스템이 NVIDIA 드라이버를 감지하거나 구성이 잘못된 경우 이 오류가 발생할 수 있습니다.

해결 방법:

  1. 올바른 ROCm 버전의 PyTorch가 설치되어 있는지 확인:

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

  2. 가상 환경 내에 있는지 확인:

    # 가상 환경이 활성화되어 있는지 확인
source comfy-env/bin/activate  # 또는 가상 환경 경로

  3. 공식적으로 지원되지 않는 AMD GPU의 경우 환경 변수 사용:

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

  4. 문제가 계속되면 CPU 모드로 시작 시도:

    python main.py --cpu

  5. 공식 문서 참조: 더 많은 AMD GPU 정보는 ComfyUI 공식 저장소의 AMD GPU 섹션을 참조하세요.

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를 사용하는 것은 Linux에서 ComfyUI를 설치하는 최고의 방법으로, 다음을 제공합니다:

  • 간단한 설치 프로세스: 하나의 명령으로 완전한 설치
  • 완전한 의존성 관리: 모든 의존성을 자동으로 처리
  • 다중 작업 공간 지원: 여러 ComfyUI 인스턴스를 관리할 수 있음
  • 크로스 플랫폼 호환성: Windows, macOS, Linux에서 올바르게 작동

ComfyUI가 처음이라면 설치 및 관리에 Comfy CLI 사용을 강력히 권장합니다.

다음 단계

설치 후 다음을 할 수 있습니다:

  • 📖 완전한 Comfy CLI 사용자 가이드를 확인하여 더 고급 기능을 학습
  • 🎯 첫 번째 ComfyUI 워크플로우 시작
  • 🔧 사용자 정의 노드 설치 및 관리
  • 📦 모델 다운로드 및 관리

관련 링크

1.3 맥에 ComfyUI 설치1.5 클라우드에서 ComfyUI 실행