메인 콘텐츠로 건너뛰기
다양한 섹션에서 다양한 설치 방법을 통해 ComfyUI 업데이트에 대해 다뤘지만, 이 포괄적인 가이드는 모든 업데이트 절차를 한데 모아 사용자가 ComfyUI를 명확히 업데이트하는 방법을 이해하도록 돕습니다.

ComfyUI를 어떻게 업데이트하나요?

ComfyUI 휴대용 버전은 간편한 일괄 스크립트를 제공해 쉽게 업데이트할 수 있습니다.

업데이트 스크립트 위치

휴대용 설치 디렉토리의 update 폴더에는 다음과 같은 업데이트 스크립트가 있습니다:
ComfyUI_windows_portable
└─ 📂update
   ├── update.py
   ├── update_comfyui.bat                           // 최신 개발 버전으로 업데이트
   ├── update_comfyui_stable.bat                    // 최신 안정 버전으로 업데이트
   └── update_comfyui_and_python_dependencies.bat   // ⚠️ 위험: 의존성 재설치 - 충돌 발생 가능
업데이트 중에는 안정적인 인터넷 연결을 유지하세요.
⚠️ 위험: update_comfyui_and_python_dependencies.bat 스크립트는 매우 신중히 사용하세요!이 스크립트는 일반 업데이트보다 더 철저하며 다음을 수행합니다:
  • ✅ ComfyUI 코드 자체 업데이트
  • ✅ PyTorch 업데이트 (NVIDIA GPU CUDA 12.9용)
  • ✅ 모든 파이썬 의존성 재설치
위험:
  • 기존 설정과의 의존성 충돌을 일으킬 수 있음
  • 특정 패키지 버전에 의존하는 맞춤형 노드를 깨뜨릴 수 있음
  • 수동으로 구성한 패키지를 덮어쓸 수 있음
⚠️ 이 스크립트는 다음 경우에만 사용하세요:
  • 의존성 문제를 해결해야 할 때
  • 주요 버전 업데이트를 수행할 때
  • 매일 업데이트를 원한다면 update_comfyui.bat를 사용하세요
이 스크립트를 실행하기 전에:
  1. ComfyUI 전체 설치본 백업하기
  2. 설치한 맞춤형 패키지 버전 기록하기
  3. 필요하다면 맞춤형 노드를 다시 설치할 준비 갖추기

ComfyUI 버전 유형

설치 방법에 따라 ComfyUI는 여러 가지 설치 버전을 제공합니다. 아래 링크에는 각 버전별 업데이트 지침이 포함되어 있습니다.
ComfyUI Desktop currently supports standalone installation for Windows and MacOS (ARM), currently in Beta
  • Code is open source on Github
Because Desktop is always built based on the stable release, so the latest updates may take some time to experience for Desktop, if you want to always experience the latest version, please use the portable version or manual installation
You can choose the appropriate installation for your system and hardware below

ComfyUI Desktop (Windows) Installation Guide

Suitable for Windows version with Nvidia GPU
Portable version is a ComfyUI version that integrates an independent embedded Python environment, using the portable version you can experience the latest features, currently only supports Windows system

ComfyUI Portable (Windows) Installation Guide

Supports Windows ComfyUI version running on Nvidia GPUs or CPU-only, always use the latest commits and completely portable.

ComfyUI Manual Installation Guide

Supports all system types and GPU types (Nvidia, AMD, Intel, Apple Silicon, Ascend NPU, Cambricon MLU)

ComfyUI를 업데이트할 때 무엇을 업데이트해야 하나요?

ComfyUI 업데이트는 주로 두 가지 요소로 이루어집니다:
  1. ComfyUI 핵심 코드 업데이트
  2. ComfyUI 핵심 의존성 업데이트, 여기에는 필요한 파이썬 의존성과 ComfyUI 기능적 의존성 패키지가 포함됩니다
핵심 코드: 새로운 노드, 새로운 모델 지원, 새로운 기능 등 핵심 의존성: 주로 ComfyUI의 프론트엔드 기능, 워크플로우 템플릿, 노드 도움말 문서 등이 포함됩니다
comfyui-frontend-package   # ComfyUI 프론트엔드 기능
comfyui-workflow-templates # ComfyUI 워크플로우 템플릿  
comfyui-embedded-docs      # ComfyUI 노드 도움말 문서
comfy-kitchen              # ComfyUI 핵심 유틸리티
comfy-aimdo                # ComfyUI 핵심 유틸리티
이러한 핵심 의존성은 별도의 저장소에서 관리됩니다: 개발(야간) 버전과 안정(릴리스) 버전 간의 차이점을 이해하는 것이 중요합니다:
  • 개발 버전(야간): 최신 커밋 코드로, 가장 최신 기능을 이용할 수 있지만 잠재적 문제를 포함할 수 있습니다.
  • 안정 버전(릴리스): 안정적인 릴리스 기반으로 구축되며, 보통 개발 버전보다 늦지만 더 높은 안정성을 제공합니다. 기능이 테스트되고 안정화된 후에 안정 버전을 지원합니다.
많은 사용자가 릴리스 버전이나 데스크탑 버전을 사용하다가 필요한 기능이 개발 버전에서만 제공됨을 발견합니다. 이런 경우 로컬 ComfyUI/requirements.txt야간 버전 의존성과 일치하는지 확인해 모든 의존성이 최신 기능을 지원하는지 판단하세요.

일반적인 업데이트 문제

업데이트 후 프론트엔드, 워크플로우 템플릿, 노드가 누락되거나 오래된 상태로 남아있는 경우

사용자들은 종종 git pull 명령어만 사용해 ComfyUI 코드를 업데이트하지만 핵심 의존성 업데이트를 소홀히 해서 다음과 같은 문제가 발생합니다:
  • 프론트엔드 기능이 누락되거나 비정상적으로 작동함
  • 새로 추가된 워크플로우 템플릿을 찾을 수 없음
  • 오래된 또는 누락된 노드 도움말 문서
  • 새 기능에 해당하는 프론트엔드 지원이 부족함
git pull 명령어를 사용한 후, 해당 ComfyUI 환경에서 pip install -r requirements.txt를 사용해 의존성을 업데이트하세요.

핵심 의존성 제대로 업데이트하는 방법

Recommended Method: Use the ComfyUI_windows_portable\update\update_comfyui.bat batch script, which will update both ComfyUI code and all Python dependencies.Manual Dependency Update: If you need to manually update dependencies, use the following command:
# Open command line in portable version directory
.\python_embeded\python.exe -m pip install -r ComfyUI\requirements.txt

핵심 의존성 업데이트 문제 해결

핵심 의존성 업데이트가 실패하면 다음 문제 해결 단계를 따르세요:
1

네트워크 연결 확인

중국 본토에 있다면 PyPI에 접속하거나 국내 미러를 설정했는지 확인하세요:
# 칭화대학 미러 사용
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
2

핵심 패키지 개별 설치

일괄 설치가 실패하면 패키지를 개별적으로 설치해보세요. 먼저 ComfyUI/requirements.txt에서 버전 요구사항을 확인하세요:그런 다음 지정된 버전에 따라 설치하세요 (requirements.txt의 버전 번호를 사용하세요):
pip install comfyui-frontend-package==<version> 
pip install comfyui-workflow-templates==<version>
pip install comfyui-embedded-docs==<version>
pip install comfy-kitchen==<version>
pip install comfy-aimdo==<version>
ComfyUI/requirements.txt에 명시된 정확한 버전 번호를 사용하는 것이 좋습니다. 독립적으로 최신 버전으로 업그레이드하지 마세요. 호환성 문제가 발생할 수 있습니다.

업데이트 후 새로운 기능을 찾을 수 없는 이유는 무엇인가요?

이것은 가장 흔한 문제 중 하나입니다:
  • 데스크탑 버전을 사용하고 있다면 기능이 늦게 업데이트될 수 있습니다. 데스크탑 버전은 안정 릴리스 기반으로 구축되기 때문입니다.
  • **개발 버전(야간)**을 사용하고 있는지 확인하세요. **안정 버전(릴리스)**이 아닌 것입니다.
또한 업데이트 과정에서 해당 의존성들이 성공적으로 업데이트되었는지 확인하세요. 업데이트 후에도 문제가 지속된다면 의존성 업데이트 문제 해결 섹션을 참고해 문제를 진단하세요.

개발(야간) 버전과 안정(릴리스) 버전 간에 어떻게 전환하나요?

버전 간의 차이점:
  • 특징: 최신 커밋 코드 포함
  • 장점: 최신 기능과 개선사항을 가장 먼저 경험할 수 있음
  • 위험: 아직 발견되지 않은 버그나 불안정한 요소를 포함할 수 있음
  • 적합한 사용자: 개발자, 테스터, 최신 기능을 경험하고 싶은 사용자
update_comfyui_stable.bat 대신 update_comfyui.bat를 사용하세요:
# 개발 버전 (최신 기능)
더블클릭: update_comfyui.bat

# 안정 버전
더블클릭: update_comfyui_stable.bat

업데이트 후 오류가 발생하면 어떻게 해야 하나요?

  1. 의존성 확인: pip install -r requirements.txt를 실행해 모든 의존성이 업데이트되었는지 확인하세요
  2. 맞춤형 노드 확인: 일부 맞춤형 노드가 새 버전과 호환되지 않을 수 있습니다
  3. 버전 롤백: 문제가 심각하다면 이전 안정 버전으로 롤백할 수 있습니다
문제가 발생하면 당사의 문제 해결 페이지를 참고해 해결하세요.

문제 해결

ComfyUI 문제 해결 방법 알아보기

최신 기능을 어떻게 계속 확인할 수 있나요?