인스턴스 관리

Comfy Desktop에서는 선택기 화면에서 여러 ComfyUI 인스턴스를 관리할 수 있습니다.

인스턴스 유형

Comfy Desktop은 네 가지 인스턴스 유형을 지원합니다. 각 유형은 카드와 제목 표시줄에 고유한 아이콘을 표시합니다.

유형	아이콘	설명
독립형	💻	Comfy Desktop이 생성한 자체 완비형 ComfyUI 인스턴스입니다. 번들 Python, 자동 업데이트, 전체 스냅샷 지원이 포함됩니다. 새 설치를 클릭했을 때의 기본값입니다.
클라우드	☁️	Comfy Cloud 인스턴스입니다. Comfy Cloud 계정이 필요합니다. 클라우드 인스턴스는 Comfy 서버에서 실행되며 별도로 청구됩니다.
원격	🌐	네트워크의 다른 컴퓨터에서 실행되는 ComfyUI 인스턴스에 연결합니다. 설정 중에 원격 호스트와 포트를 구성합니다.
추적형	📁	Comfy Desktop이 추적하는 기존 ComfyUI 설치(Git 클론 또는 포터블 버전)입니다. 업데이트는 수동으로 관리합니다. 기존 설치 추적하기를 참조하세요.

아래 이미지는 각 인스턴스 카드에서 사용할 수 있는 주요 작업을 표시합니다.

새 설치: 완전히 새로운 ComfyUI 인스턴스를 만듭니다. 새 인스턴스 생성하기를 참조하세요. 스냅샷 파일에서 인스턴스 생성하기도 가능합니다.
⋮ 메뉴: 세 점 아이콘을 클릭하여 인스턴스 작업 메뉴를 엽니다.
관리: 관리 패널을 열어 인스턴스를 구성합니다(경로, 실행 인자, 모델 디렉터리, 환경 변수). 관리 페이지를 참조하세요.
스냅샷 복원: 인스턴스를 이전 스냅샷으로 되돌립니다. 스냅샷 페이지를 참조하세요.
공유: 인스턴스의 스냅샷을 내보내 다른 사람과 공유합니다.
설치 복사: 기존 독립형 설치를 자체 Python 환경과 사용자 정의 노드를 포함하여 복제합니다. 설치 복사하기를 참조하세요.
Forget: 파일을 삭제하지 않고 선택기에서 인스턴스를 제거합니다(Untrack과 동일).
Uninstall: 인스턴스와 모든 파일을 디스크에서 영구히 삭제합니다. Forget과 Uninstall에 대한 자세한 내용은 인스턴스 제거하기를 참조하세요.

새 인스턴스 생성하기

선택기 화면에서 + 카드(왼쪽 상단)를 클릭하여 새 ComfyUI 인스턴스를 추가합니다.

Comfy Desktop 구성하기

Windows
macOS

설치 이름: 인스턴스의 이름입니다. 기본값은 “ComfyUI”입니다.
설치 위치: ComfyUI를 설치할 위치를 선택합니다. Windows에서는 SSD를 사용하고 C: 드라이브의 루트를 피할 것을 강력히 권장합니다.
고급: 클릭하여 추가 옵션에 접근합니다.
독립형: 권장 옵션입니다. 번들 Python, 자동 업데이트, 스냅샷 지원이 포함된 자체 완비형 설치입니다.
원격 연결: 다른 컴퓨터에서 실행되는 ComfyUI 인스턴스에 연결합니다.

설치 중

Comfy Desktop이 나머지 작업을 처리합니다: Python 다운로드, 환경 설정, ComfyUI 설치. 진행 화면에 현재 단계가 표시됩니다.

템플릿 선택하기

설치가 완료되면 Comfy Desktop에서 템플릿 라이브러리를 열어 시작할 워크플로 템플릿을 선택할 수 있습니다.

기존 설치 추적하기

이미 ComfyUI 설치가 있는 경우(Git 저장소에서 수동으로 설정했거나 포터블 버전으로 다운로드한 경우) 새로 만들지 않고 Comfy Desktop에 추가할 수 있습니다. 대시보드에서 새 설치를 클릭하여 설치 메뉴를 연 다음 기존 설치 추가를 선택합니다.

새 설치를 클릭하여 설치 옵션을 엽니다.
기존 설치 추가를 선택하여 추적 대화 상자를 엽니다.

설치 감지하기

추적 대화 상자에서 찾아보기를 클릭하여 ComfyUI 디렉터리를 선택합니다. Comfy Desktop이 폴더를 조사하여 설치 유형을 자동으로 감지합니다. Windows 포터블 설치의 경우 다음과 같은 항목을 찾습니다.

standalone-env 디렉터리 — 번들 Python 환경
ComfyUI/main.py — ComfyUI 진입점

수동으로 클론한 Git 저장소의 경우 다음과 같은 항목을 찾습니다.

models/ 및 user/ 디렉터리 — 구성된 ComfyUI의 흔적
.venv 디렉터리 — Python 가상 환경

경로 설정하기

디렉터리를 선택하면 대화 상자에 감지된 경로가 표시됩니다. 필요에 따라 조정할 수 있습니다.

ComfyUI 디렉터리: main.py가 포함된 ComfyUI 폴더 경로입니다. 포터블 설치의 경우 일반적으로 포터블 패키지 내부의 폴더입니다.
- 포터블 예: D:\ComfyUI_windows_portable\ComfyUI
Python 환경: Python 환경 폴더 경로입니다. Comfy Desktop이 자동으로 감지하며 필요에 따라 재정의할 수 있습니다.
- 포터블 예: D:\ComfyUI_windows_portable\python_embeded
- Git 저장소 예: <ComfyUI_dir>/.venv

추적형 vs 독립형

추적형(기존 설치 추가) 설치와 독립형 설치의 주요 차이점은 업데이트 관리 방식입니다.

측면	추적형 (기존)	독립형
업데이트	자동 업데이트 없음 — Git을 통해 수동으로 ComfyUI 버전 관리	기본 제공 자동 업데이트
Python	기존 Python 환경 사용(`.venv`, `python_embeded` 등)	번들 Python, 자동 의존성 관리
격리	기존 경로와 환경 공유	완전히 자체 완비된 격리 설치
스냅샷	스냅샷 지원 가능	스냅샷 지원 가능
용도	이미 ComfyUI를 설정하고 사용자 정의한 경우	처음부터 새로 설치하는 경우

참고: 추적형 설치는 launchMode: 'external'을 사용합니다 — Comfy Desktop이 기존 ComfyUI 프로세스를 내부 관리 없이 시작합니다. 스냅샷은 복원 메커니즘으로 계속 작동하지만 버전 관리는 사용자의 책임입니다.

인스턴스 제거하기

↩ 개요로 돌아가기 인스턴스를 제거할 때 파일을 유지할지 모두 삭제할지에 따라 세 점 메뉴에 두 가지 옵션이 제공됩니다.

Forget / Untrack: 파일을 삭제하지 않고 선택기 목록에서 인스턴스를 제거합니다. 설치 폴더와 모든 데이터는 디스크에 남습니다. 목록을 정리하고 싶지만 나중에 인스턴스가 다시 필요할 수 있을 때 사용하세요.
Uninstall / Delete: 설치와 모든 파일을 디스크에서 영구히 제거합니다. 공유 디렉터리의 모델 파일은 영향을 받지 않습니다.

메뉴에 표시되는 이름은 인스턴스 유형에 따라 다릅니다. 스탠드얼론 설치의 경우 Forget이 표시되고(로컬 설치이므로 untrack은 적용되지 않음), 수동으로 추가한 설치의 경우 Untrack이 표시됩니다. 둘 다 파일을 삭제하지 않고 목록에서 인스턴스를 제거하는 동일한 작업을 수행합니다.

설치 복사하기

↩ 개요로 돌아가기 기존 독립형 설치를 복제하려면 해당 카드를 마우스 오른쪽 버튼으로 클릭하고 설치 복사를 선택합니다. 이렇게 하면 다음 사항이 포함된 복사본이 생성됩니다.

새로운 Python 환경
동일한 ComfyUI 버전
자체 사용자 정의 노드 설정

복사가 시작되기 전에 새 설치의 이름을 입력하라는 메시지가 표시됩니다.

인스턴스 편집하기

↩ 개요로 돌아가기 인스턴스의 관리 패널에서 다음을 수행할 수 있습니다.

설치 경로 변경
실행 인자 조정
모델 디렉터리 수정
환경 변수 업데이트

인스턴스 카드를 마우스 오른쪽 버튼으로 클릭하고 관리를 선택하여 관리 패널을 엽니다.

오류 상태

설치에 문제가 발생하면 카드에 경고 표시기가 나타납니다. 카드를 마우스 오른쪽 버튼으로 클릭하고 오류 해제를 선택하여 오류 상태를 지웁니다. 문제가 지속되면 데이터 위치에서 로그를 확인하세요.

​인스턴스 유형

​새 인스턴스 생성하기

​기존 설치 추적하기

​설치 감지하기

​경로 설정하기

​추적형 vs 독립형

​인스턴스 제거하기

​설치 복사하기

​인스턴스 편집하기

​오류 상태