배포 실패: ComfyUI-Manager 설치 중 오류

실행기가 「ComfyUI-Manager 설치 중...」 단계에서 멈추거나 튕긴다면, 이는 파이썬 패키지 충돌이 아니라 최초 배포 시 플러그인 관리자(ComfyUI-Manager) 소스 코드를 깃 클론(git clone)해 오는 단계의 차단입니다.

주요 장애 요인:

• 깃허브(github.com) 주소 접근망 차단/불안정
• 시스템 가속 프록시 포트가 Git 환경에 미전달됨
• 백신/네트워크 실시간 감시망에 의한 HTTPS SSL 차단
• Windows 시스템의 기본 최대 경로 길이(260글자) 한계 도달
• 로컬 PC에 Git이 설치되지 않았거나 옛날 버전인 경우

해결 단계

1단계: Git 환경에 프록시 지정

Clash Verge, v2rayN 등의 툴을 켜 둔 상태라면, 윈도우 Git에 가속 포트 경로를 인가해 줍니다. 명령 프롬프트나 PowerShell을 열고 실행하세요.

HTTP 프록시 지정 (Clash 기본 포트 7890 기준):

git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

오직 깃허브 도메인 통신에만 가속 프록시 적용 (추천):

git config --global http.https://github.com.proxy http://127.0.0.1:7890
git config --global https.https://github.com.proxy http://127.0.0.1:7890

인가 완료 후 Wonderful Launcher에서 배포를 재시도합니다.

설정 해제:

git config --global --unset http.proxy
git config --global --unset https.proxy

2단계: SSL 인증서 에러 해소

에러 문구에 SSL certificate problem이 적혀 있다면 백신이나 회사 보안망에 의해 HTTPS 패킷이 간섭을 받는 상태입니다.

윈도우 내장 인증서 관리 저장소 사용 설정:

git config --global http.sslBackend schannel

이 명령을 치면 브라우저와 동일한 윈도우 인증 신뢰망을 사용하여 SSL 오류가 쉽게 우회됩니다.

3단계: 파일 경로 길이 제한 해제

Filename too long 에러가 뜬다면 윈도우의 260자 경로 길이 제한 정책을 꺼 주어야 합니다. 관리자 권한으로 명령 프롬프트를 열고 실행하세요.

git config --system core.longpaths true

더불어 ComfyUI를 D:\ComfyUI 처럼 폴더 경로가 깊지 않은 루트 쪽에 깔아 폴더 단계 깊이를 예방하는 것이 좋습니다.

4단계: ComfyUI-Manager 수동 설치

자동 다운로드가 계속 튕긴다면 사용자가 직접 복제해 넣을 수 있습니다.

1. 본인의 ComfyUI 설치 대상 경로 내 custom_nodes 폴더로 이동합니다 (예: D:\ComfyUI에 설치 중인 경우).
2. 명령 프롬프트를 켜고 폴더로 이동하여 직접 클론합니다.

cd D:\ComfyUI\custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git

3. 폴더 내 파일 존재 여부를 체크합니다.

dir D:\ComfyUI\custom_nodes\ComfyUI-Manager

__init__.py 등이 보인다면 성공입니다. 실행기에서 ComfyUI 서버를 구동하십시오.

관련 가이드

• 배포 실패: 리소스 패키지 다운로드 중 오류
• ComfyUI 구동 실패 해결 가이드
• ComfyUI 플러그인 가져오기 실패 복구