ComfyUI 커스텀 노드 리스트 또는 ComfyRegistry 호출 실패 해결 가이드

만약 검색 결과나 로그에 ComfyUI failed to get custom node list, ComfyUI Manager failed to get custom node list, failed to find the following ComfyRegistry list, cannot connect to ComfyRegistry, failed to fetch versions from ComfyRegistry 또는 the cache may be outdated, or the nodes may have been removed from ComfyRegistry 경고가 출력된다면, ComfyUI Manager가 노드 검색 및 매칭, 업데이트에 활용하는 외부 레지스트리 데이터베이스 목록을 제대로 수집하거나 신뢰하지 못하는 상태입니다.

브라우저에 **Failed to fetch**만 보인다면 Manager, server logs, WebSocket, workflow draft 중 어떤 요청인지 ComfyUI "Failed to Fetch"에서 먼저 구분하세요.

이는 대개 매니저의 임시 네트워크 호출 또는 캐시 충돌 문제이며, ComfyUI 코어 전체가 영구 손상되었음을 뜻하지는 않습니다.

만약 웹 UI 우측에 **Reconnecting...**이 계속 뜨거나 브라우저에 failed to fetch server logs 에러가 출력된다면, 이는 노드 리스트 오류가 아닌 브라우저 연결 문제입니다. 해당 전용 가이드를 참고하세요.

빠른 해결 가이드

만약 "ComfyUI Manager failed to get custom node list" 또는 "failed to find the following ComfyRegistry list" 오류를 만났다면 아래 단계에 따라 처리하세요.

1. ComfyUI 기본 작동에 이상이 없는지 일반 이미지 생성을 먼저 돌려 봅니다.
2. 현재 PC에서 Manager 공식 GitHub 리포지토리 페이지, ComfyRegistry 허ブ 사이트 및 원본 custom-node-list.json URL에 브라우저로 접속해 봅니다.
3. 레지스트리 맵 매칭 에러 로그에 등장하는 텍스트 문자열을 Python 라이브러리로 오인해 pip install을 실행하지 마십시오.
4. 오류 문구에 ComfyRegistry 연결 실패 또는 캐시 만료 등이 등장하면, 플러그인을 변경하기 전에 우선 네트워크 접속성 및 원본 깃허브 링크 정상 여부를 확인하세요.
5. GitHub 및 레지스트리 경로가 브라우저에서 정상 열리는데도 Manager에서만 에러가 난다면, 매니저 캐시 폴더만 삭제한 뒤 다시 시도합니다.

매니저 플러그인을 섣불리 재설치하지 마십시오. 레지스트리 로드 에러와 커스텀 노드 임포트 에러(IMPORT FAILED), 그리고 부팅 크래시 이슈는 완전히 다른 원인입니다.

만약 서버 시작 터미널 로그에 이미 IMPORT FAILED나 ModuleNotFoundError 등이 기록되어 있다면, 매니저가 아니라 해당 커스텀 노드의 유실 의존성부터 해소해야 합니다. 플러그인 변경 후 UI가 불안정해졌다면 ComfyUI 플러그인 가져오기 실패 및 ComfyUI 재연결 오류 가이드를 참조하세요.

정밀 에러 로그

만약 아래 에러 문구 중 하나라도 터미널에 남는다면 본 가이드의 복원 대책이 필요합니다.

failed to get custom node list
cannot connect to comfyregistry
failed to fetch versions from comfyregistry
error connecting to the comfy node registry.
[error] [comfyui-manager] an invalid channel was used: https://raw.githubusercontent.com/ltdrdata/comfyui-manager/main
failed to find the following comfyregistry list. the cache may be outdated, or the nodes may have been removed from comfyregistry.

만약 에러 내용이 정확히 **failed to find the following ComfyRegistry list. the cache may be outdated, or the nodes may have been removed from ComfyRegistry**라면, 임의의 패키지 설치에 들어가기 전 캐시 정리와 연결망부터 검사하세요. 이는 pip나 모델 결함이 아닌 매니저 내부의 탐색 실패 로그입니다.

"ComfyRegistry 목록" 또는 "캐시가 만료되었을 수 있음" 경고 해결법

이러한 로그는 대개 매니저가 유실된 노드명을 레지스트리 매핑 목록에서 찾으려 했으나, 레지스트리 응답 실패나 유실 패키지 쿼리 실패로 인해 매핑 테이블 조회에 실패했을 때 나타납니다.

아래 조치 순서를 따르세요.

1. 오류 문구에 나오는 알 수 없는 텍스트를 pip로 설치하려 하지 마세요. 이는 Python 패키지가 아닌 매니저 등록 정보 ID일 수 있습니다.
2. 다양한 워크플로 전반에 걸쳐 해당 에러가 연속되면 인터넷망 차단을 의심하세요.
3. 인터넷망 연결을 확보한 뒤에 매니저 캐시 폴더를 안전하게 비우세요.
4. 특정 단일 노드만 매핑 실패가 뜬다면 해당 노드 이름을 구글에 쳐서 직접 깃허브에서 클론해 수동 설치하세요.
5. 폴더를 직접 설치했는데도 인식하지 못한다면 시작 터미널 로그의 import fail 원인을 검토하세요.

원격 분석 기반 신속 진단

오류의 근본 원인 분석

ComfyUI Manager는 외부 레지스트리 목록에 기반합니다. 공식 가이드에 의하면 매니저는 워크플로 로드 시 유실된 노드를 찾아서 설치해 주는 핵심 도구입니다.

개발자들이 만든 커스텀 노드들도 매니저가 참조하는 custom-node-list.json 리스트상에 등록되어야 비로소 검색이 가능합니다. 이 JSON 리스트를 호출하지 못하면 매니저는 어떤 GitHub 링크에서 노드를 받아야 하는지 길을 잃게 됩니다.

따라서 아래 버튼을 누를 때 해당 에러가 집중 발생합니다.

• Install Missing Custom Nodes (누락 커스텀 노드 설치)
• Install Custom Nodes
• Search Node
• Update

이는 ComfyUI 핵심 기능 훼손과는 별개인 경우가 많습니다.

1단계: ComfyUI 작동 검증

기본 워크플로가 로드되고 실행 대기열에 들어가 렌더링이 나오는지 체크하십시오. 잘 나온다면 서버 및 가상환경은 정상입니다. 오로지 매니저의 목록 획득망만 고장 난 상태로 규정하고 접근합니다.

시작 시 터미널창이 아예 꺼지거나 에러 로그를 뿜으며 켜지지 않는다면 ComfyUI 시작 실패 가이드를 참조하세요.

2단계: 네트워크 및 깃허브 접속성 확인

ComfyUI가 구동 중인 PC의 웹 브라우저에서 아래 두 링크에 접근해 봅니다.

https://github.com/Comfy-Org/ComfyUI-Manager
https://raw.githubusercontent.com/Comfy-Org/ComfyUI-Manager/main/custom-node-list.json

첫 번째는 열리나 두 번째 raw.githubusercontent.com 주소가 타임아웃이 걸린다면, 사용 중인 인터넷 서비스 망이나 프록시 소프트웨어가 raw 파일 제공 도메인을 임의 차단한 상태입니다.

• 프록시/VPN 설정을 변경해 우회 통로를 확보합니다.
• 임시로 시스템 방화벽 웹 필터링을 조율합니다.
• DNS 주소를 구글 DNS (8.8.8.8) 또는 클라우드플레어 (1.1.1.1)로 변경합니다.

3단계: 매니저 로그 추적

오류 발생 시점의 터미널 텍스트를 유심히 보면 다음과 같은 오류 명칭들이 등장합니다.

• ConnectionError (접속 문제)
• SSLError (보안 인증서 실패 - 프록시 인증 실패 관련)
• TimeoutError (시간 초과)

프록시 오류나 SSL 차단 오류가 감지된다면 네트워크 유틸리티나 시스템 환경 변수의 프록시 포트 설정을 원상 복구하세요.

4단계: 매니저 캐시 수동 정리

인터넷 접근이 원활함에도 에러가 반복된다면 누적된 캐시 파일 손상일 수 있습니다. ComfyUI 설치 루트 내 매니저 유저 캐시 경로를 찾으세요. 대개 아래 중 하나에 위치합니다.

ComfyUI/user/default/ComfyUI-Manager/cache/
ComfyUI/user/__manager__/cache/

경로 안에 아래와 같은 파일이 존재합니다.

• custom-node-list.json
• github-stats.json
• extension-node-map.json

조치 방법:

1. ComfyUI 구동을 중단합니다.
2. 해당 cache 폴더를 다른 안전한 경로로 백업 이동해 둡니다.
3. 기존 경로의 캐시 파일들만 비웁니다. (모델이나 노드 폴더를 건드리지 마십시오.)
4. ComfyUI를 다시 켜고 매니저 창을 로드해 봅니다.

5단계: 수동 설치 전환

매니저 호출이 끝내 동작하지 않는다면, 붉은색 노드 명칭을 깃허브 검색창에 쳐서 나온 주소를 복사해 아래 경로로 직접 수동 클론합니다.

cd ComfyUI/custom_nodes
git clone <복사한_깃허브_주소>

안전한 수동 설치 세부 규격은 커스텀 노드를 환경 손상 없이 설치하는 방법을 참고하십시오.

6단계: 활성 Python 환경 인지

매니저를 수동 업데이트하거나 복구할 때에도 꼭 ComfyUI 구동 Python 경로를 거쳐야 합니다. Windows 포터블 버전인 경우:

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt

수동 venv 환경인 경우:

cd ComfyUI/custom_nodes/ComfyUI-Manager
pip install -r requirements.txt

관련 가이드

• ComfyUI Manager 설치, 열기, 업데이트 및 문제 해결
• 커스텀 노드를 환경 손상 없이 설치하는 방법
• ComfyUI 플러그인 가져오기 실패 복구
• 커스텀 노드 설치 후 손상된 ComfyUI를 재설치 없이 복구
• ComfyUI 재연결 오류: 원인과 빠른 복구

출처 참조

• ComfyUI Manager 공식 노드 관리 정책
• GitHub ComfyUI-Manager custom-node-list