배포 실패: 리소스 패키지 다운로드 중 오류

ComfyUI 최초 배포 시 리소스 패키지 다운로드 단계에서 발생하는 깃허브 연결 타임아웃 및 프록시 우회 설정 해결 가이드.

30초 판단 분기

아직 ComfyUI의 설치가 완료되지 않은 상태에서 리소스 다운로드 바가 올라가지 않는다면, 이는 전적으로 인터넷 연결 문제 또는 하드디스크 용량 부족 문제이며 ComfyUI 소프트웨어 자체의 에러가 아닙니다.

실행기가 「리소스 패키지 다운로드 중...」 단계에서 진행이 멈추거나 튕긴다면, 원인은 ComfyUI 파이썬 스택이 아닌 깃허브(GitHub) 등 상류 배포 사이트로부터 패키지 아카이브 파일을 땡겨받는 네트워크망 흐름의 문제입니다.

주요 장애 요인:

해결 단계

이미 Clash Verge, v2rayN 등의 로컬 가속 툴을 켜 둔 상태라면, 런타임 환경에 해당 포트를 전달해 주어야 합니다.

가장 대표적인 툴별 기본 로컬 루프백 주소:

프록시 가속 툴	HTTP 프록시 주소	SOCKS5 프록시 주소
Clash	`http://127.0.0.1:7890`	`socks5://127.0.0.1:7891`
v2rayN	`http://127.0.0.1:10809`	`socks5://127.0.0.1:10808`

배포는 Git을 이용해 레포지토리를 복사해 옵니다. 윈도우 Git 콘솔에 직접 프록시 주소를 넘겨 해결할 수 있습니다.

글로벌 HTTP 프록시 지정:

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 --unset http.proxy
git config --global --unset https.proxy

포터블 초기 전개 및 압축 해제에는 최소 5GB 이상의 빈 공간이 있어야 연산 도중 정지하지 않습니다. PowerShell에서 여유 공간을 조회해 봅니다.

Get-PSDrive -PSProvider FileSystem | Select-Object Name, @{N='Free(GB)';E={[math]::Round($_.Free/1GB,2)}}

디스크 용량이 부족하다면 파일을 비우거나, 런타임 설정 메뉴에서 충분한 빈 공간이 있는 D드라이브 등으로 경로를 이전하세요.