ComfyUI Manager가 설치된 커스텀 노드를 인식하지 못하는 문제 해결

ComfyUI에 커스텀 노드를 설치했고 custom_nodes 폴더에 분명히 있는데, ComfyUI Manager가 완고하게 "미설치"로 표시합니다. 다시 설치를 클릭하면 중복이 생성됩니다. 또는 업데이트하려고 해도 새 버전이 존재한다는 것을 알고 있는데도 업데이트할 것이 없다고 표시됩니다.

빠른 답변: ComfyUI Manager가 설치된 노드를 인식하지 못하는 것은 일반적으로 데이터베이스 비동기화, 부적절한 설치 방법 또는 캐시된 메타데이터 충돌로 인해 발생합니다. 해결책은 일반적으로 Manager의 노드 데이터베이스 캐시를 지우고, 수동 git clone이 아닌 Manager를 통해 노드가 설치되었는지 확인하고, 폴더 구조가 Manager의 기대에 부합하는지 검증하는 것을 포함합니다. Manager 재시작 또는 데이터베이스 재구축으로 대부분의 경우 몇 분 내에 해결됩니다.

이 문제는 사용자들이 보고하는 가장 흔한 ComfyUI 불만 중 하나입니다. 특히 짜증나는 것은 워크플로에서 노드가 완벽하게 작동한다는 것입니다. 정상적으로 로드되고 오류 없이 실행되는데 Manager는 존재하지 않는다고 생각합니다. 체계적으로 해결해 봅시다.

ComfyUI Manager가 노드를 인식하지 못하는 이유는?

근본 원인을 이해하면 이를 올바르게 수정하고 재발을 방지할 수 있습니다.

Manager가 설치를 추적하는 방법

ComfyUI Manager는 단순히 custom_nodes 폴더를 보는 것이 아닙니다. 무엇을 설치했는지, 어디서, 어떤 버전인지 추적하는 내부 데이터베이스를 유지합니다. 이 데이터베이스는 Manager 자체의 디렉토리 구조에 있습니다.

git을 사용하여 노드 저장소를 수동으로 클론하면, ComfyUI 자체가 custom_nodes에서 Python 파일을 스캔하기 때문에 노드가 작동합니다. 하지만 Manager의 데이터베이스를 업데이트한 것이 없기 때문에 Manager는 이를 알지 못합니다.

반대의 경우도 발생합니다. Manager의 데이터베이스가 무언가가 설치되었다고 하지만 폴더가 삭제되거나 이동된 경우, Manager는 실제로는 없는데도 설치됨으로 표시합니다.

비동기화의 일반적인 원인

수동 git 작업이 주요 원인입니다. Manager를 거치지 않고 노드 폴더를 클론, 풀 또는 제거하면 추적이 깨집니다.

실패한 설치는 부분적인 데이터베이스 항목을 남길 수 있습니다. Manager가 무언가를 설치하려다 중간에 실패했지만 실패 전에 설치됨으로 기록한 경우입니다.

ComfyUI 설치 이동 또는 복사는 종종 Manager의 데이터베이스가 잘못된 경로를 가리키거나 이전 시스템에 대한 오래된 정보를 가지게 됩니다.

Manager 업데이트는 때때로 데이터베이스 스키마 변경을 도입합니다. 이전 데이터베이스 형식은 Manager 자체를 업데이트한 후 올바르게 파싱되지 않을 수 있습니다.

안티바이러스 간섭은 때때로 Manager가 설치 완료를 기록한 후 설치 중에 파일을 삭제합니다. Manager는 성공했다고 생각하지만 파일이 사라졌습니다.

캐시 계층

Manager는 또한 사용 가능한 업데이트 및 저장소 정보와 같은 노드 메타데이터를 캐시합니다. 이 캐시는 오래되거나 손상될 수 있으며, 기본 데이터베이스가 정확하더라도 오래되거나 부정확한 상태를 표시합니다.

캐시 문제는 "업데이트 가능"이 나타나지 않거나 Manager 인터페이스에 부정확한 버전 번호가 표시되는 등의 증상을 유발합니다.

노드 인식 문제를 어떻게 해결하나요?

가장 간단한 해결책부터 시작하여 필요한 경우 단계를 높이세요.

해결책 1: ComfyUI 완전히 재시작

때때로 Manager는 새로운 초기화가 필요합니다. ComfyUI를 완전히 닫으세요 - 새로고침이 아니라 Python 프로세스를 중지하세요.

파일 핸들이 해제될 때까지 몇 초 기다린 다음 ComfyUI를 다시 시작하세요. Manager는 시작 시 재초기화되며 오래 실행된 세션 동안 놓친 노드를 감지할 수 있습니다.

이 간단한 단계는 위험 없이 약 20%의 경우 문제를 해결합니다.

해결책 2: Manager 데이터베이스 강제 재구축

Manager에는 파일 시스템 상태에서 노드 데이터베이스를 재구축하는 내장 기능이 있습니다.

Manager 버튼을 클릭하여 ComfyUI에서 Manager를 엽니다. 설정 또는 고급 옵션으로 이동합니다. "데이터베이스 재구축" 또는 "노드 다시 스캔"이라는 레이블의 옵션을 찾으세요.

이를 클릭하면 Manager가 custom_nodes 디렉토리를 새로 스캔하고 설치 기록을 재구축합니다. 존재하는 모든 노드가 감지되고 적절히 등록됩니다.

재구축 후 변경 사항이 완전히 적용되도록 ComfyUI를 재시작하세요.

해결책 3: 노드 데이터베이스 캐시 지우기

재구축이 도움이 되지 않으면 캐시 파일을 수동으로 지우세요. ComfyUI 설치 디렉토리로 이동합니다.

custom_nodes 내의 ComfyUI-Manager 폴더를 찾으세요. Manager 폴더 내에서 node_db.json, cache.json 또는 유사한 데이터베이스 파일을 찾으세요.

이 캐시 파일을 삭제하세요. 걱정하지 마세요, Manager가 재시작되면 자동으로 다시 생성됩니다. 새 데이터베이스는 현재 설치를 정확하게 반영합니다.

캐시 파일을 삭제한 후 ComfyUI를 재시작하세요. Manager가 모든 것을 처음부터 재구축하므로 첫 로드 시 약간 더 오래 걸립니다.

해결책 4: 문제가 있는 노드를 Manager를 통해 재설치

수동으로 클론한 노드의 경우 가장 깔끔한 해결책은 Manager를 통해 재설치하는 것입니다.

먼저 custom_nodes에서 수동으로 클론한 폴더를 삭제하세요. 이름만 바꾸면 다른 문제를 일으킬 수 있으므로 하지 마세요.

그런 다음 Manager의 커스텀 노드 설치 인터페이스를 사용하여 같은 노드를 설치하세요. Manager가 적절히 클론하고 데이터베이스에 등록합니다.

이 접근 방식은 Manager가 완전한 추적을 가지고 앞으로 업데이트, 종속성 및 제거를 올바르게 처리할 수 있도록 합니다.

해결책 5: 폴더 이름 확인

Manager는 저장소 이름과 일치하는 특정 폴더 이름을 기대합니다. 노드 폴더의 이름을 변경한 경우 Manager는 이를 데이터베이스 항목과 일치시킬 수 없습니다.

폴더 이름이 Manager의 기대와 일치하는지 확인하세요. ComfyUI-Impact-Pack 저장소는 정확히 ComfyUI-Impact-Pack이라는 이름의 폴더가 있어야 하며, Impact-Pack이나 축약된 것이 아닙니다.

폴더 이름을 변경한 경우 다시 원래대로 바꾸거나 Manager를 통해 재설치하여 자동으로 올바른 이름을 얻으세요.

해결책 6: Git 저장소 상태 확인

Manager는 git을 사용하여 버전과 업데이트를 추적합니다. 노드 내의 .git 폴더가 없거나 손상된 경우 Manager는 설치 상태를 결정할 수 없습니다.

문제가 있는 노드의 폴더로 이동하여 .git 디렉토리가 있는지 확인하세요. 없으면 노드가 제대로 추적되지 않습니다.

git init를 실행한 다음 원본 저장소로 리모트를 설정해 볼 수 있지만, 일반적으로 Manager를 통해 재설치하는 것이 더 간단합니다.

해결책 7: 중복 설치 확인

때때로 같은 노드가 약간의 이름 변경으로 두 번 설치됩니다. Manager는 하나를 추적하고 ComfyUI는 다른 것을 로드할 수 있습니다.

custom_nodes 폴더에서 중복을 검색하세요. 유사한 이름이나 동일한 노드 기능을 가진 폴더를 찾으세요. 중복을 제거하고 Manager를 통해 설치된 것만 유지하세요.

일반적인 중복 패턴에는 원본 저장소 이름과 이름이 변경된 버전 모두 또는 같은 노드의 릴리스 브랜치와 개발 브랜치 모두가 포함됩니다.

노드가 잘못된 버전 번호를 표시하면 어떻게 하나요?

버전 감지 문제는 설치 감지와 관련되어 있지만 다릅니다.

버전 추적 메커니즘

Manager는 버전을 결정하기 위해 git 태그와 커밋을 확인합니다. 노드 저장소가 적절한 버전 태깅을 사용하지 않으면 Manager는 "알 수 없음" 또는 부정확한 버전을 표시합니다.

이것은 자신이 만들지 않은 노드에 대해서는 수정할 수 없습니다. 노드 개발자가 git 태그를 적절히 사용해야 합니다.

캐시 노후화

더 흔하게, 잘못된 버전은 캐시된 메타데이터로 인해 발생합니다. 위에서 설명한 대로 Manager의 캐시를 지워 새로운 버전 확인을 강제하세요.

캐시를 지운 후 Manager는 GitHub 또는 GitLab에서 현재 저장소 상태를 가져옵니다. 시간이 조금 걸리지만 정확한 버전 정보를 제공합니다.

네트워크 문제

Manager가 저장소 호스트에 연결할 수 없으면 오래된 버전을 표시합니다. 네트워크 연결과 git 작업을 차단하는 방화벽 규칙을 확인하세요.

기업 네트워크는 종종 git 프로토콜을 차단합니다. 제한된 네트워크에 있다면 Manager는 사용 가능한 버전에 대한 지식을 업데이트할 수 없습니다.

앞으로 이 문제를 어떻게 예방하나요?

좋은 관행은 Manager와 노드를 영구적으로 동기화 상태로 유지합니다.

항상 Manager를 통해 설치

GitHub URL이 있고 git을 알더라도 Manager의 인터페이스를 사용하세요. 수동으로 클론하는 대신 Manager의 사용자 정의 설치 필드에 URL을 붙여넣으세요.

이렇게 하면 처음부터 적절한 데이터베이스 등록이 보장됩니다. 수동 클론은 노드를 디버깅하거나 개발할 때만 해야 합니다.

업데이트에 Manager 사용

노드에 업데이트가 있을 때 직접 git pull을 실행하는 대신 Manager의 업데이트 기능을 사용하세요.

Manager 업데이트는 수동 풀이 건너뛰는 종속성 업데이트, 데이터베이스 버전 추적 및 업데이트 후 후크를 처리합니다.

직접 폴더 조작 피하기

노드 폴더를 수동으로 삭제, 이름 변경 또는 이동하지 마세요. 노드를 깔끔하게 제거하려면 Manager의 제거 기능을 사용하세요.

폴더를 직접 조작해야 하는 경우 나중에 Manager의 데이터베이스를 재구축해야 할 것으로 예상하세요.

정기적인 Manager 업데이트

Manager 자체를 최신 상태로 유지하세요. 새 버전은 데이터베이스 처리 버그를 수정하고 노드 감지를 개선합니다.

노드 문제를 해결할 때 먼저 Manager를 업데이트하세요. 수정 사항이 새 Manager 버전에 이미 존재할 수 있습니다.

이러한 기술적 세부 사항을 관리하지 않고 ComfyUI 기능을 원하는 사용자를 위해 Apatero.com은 전문적으로 관리되는 인프라를 제공합니다. 노드는 항상 적절하게 설치, 업데이트 및 구성되어 이러한 동기화 문제 없이 사용할 수 있습니다.

특정 노드 인식 문제는 어떻게 하나요?

일부 노드에는 특별히 다룰 가치가 있는 고유한 인식 문제가 있습니다.

Impact Pack 인식

ComfyUI-Impact-Pack은 많은 종속성이 있는 복잡한 노드입니다. 인식 문제는 종종 서브모듈 문제에서 비롯됩니다.

impact_pack_models 폴더가 존재하고 필요한 파일이 포함되어 있는지 확인하세요. Impact Pack은 코드가 있어도 모델 파일이 없으면 제대로 설치된 것으로 표시되지 않습니다.

Manager의 일반 설치 대신 Impact Pack의 내장 설치 프로그램을 사용하여 종속성을 처리하세요. 이렇게 하면 모델 파일이 올바르게 처리됩니다.

ControlNet 전처리기 문제

ComfyUI-ControlNet-AUX는 설치 후 모델 다운로드가 필요합니다. Manager는 즉시 설치됨으로 표시하지만 모델이 다운로드될 때까지 실제로 준비되지 않습니다.

전처리 노드가 오류를 내면 모델 다운로드 스크립트를 실행하거나 첫 사용 시 다운로드되도록 하세요. 노드는 Manager에 따르면 설치되었지만 불완전합니다.

Video Helper Suite 인식

VideoHelperSuite에는 인식에 영향을 미치는 특정 ffmpeg 종속성이 있습니다. ffmpeg가 적절하게 접근 가능하지 않으면 Manager가 부분 설치 상태를 표시할 수 있습니다.

ffmpeg가 시스템 PATH에 있고 명령줄에서 접근 가능한지 확인하세요. 그런 다음 Manager의 데이터베이스를 재구축하세요.

자주 묻는 질문

방금 설치한 노드에 대해 Manager가 "업데이트"를 표시하는 이유는 무엇인가요?

이것은 개발 브랜치에서 설치했지만 Manager가 메인 브랜치에서 업데이트를 확인할 때 발생합니다. 버전 번호가 일치하지 않으므로 Manager는 사용 가능한 업데이트를 봅니다. 일반적으로 무시해도 안전하거나 메인 브랜치와 동기화하도록 업데이트할 수 있습니다.

Manager와 수동 git 클론을 함께 사용할 수 있나요?

기술적으로는 가능하지만 수동 클론은 Manager 인터페이스에 나타나지 않습니다. ComfyUI에서는 작동하지만 Manager가 추적하지 않습니다. 가장 깔끔한 경험을 위해 한 가지 방법을 선택하고 그것만 사용하세요.

데이터베이스를 재구축하면 워크플로가 손상되나요?

아니요, 데이터베이스 재구축은 Manager의 추적에만 영향을 미칩니다. 워크플로, 저장된 프롬프트 및 노드 구성은 그대로 유지됩니다. 모든 것이 이전과 정확히 동일하게 작동하며 정확한 Manager 상태만 표시됩니다.

일부 노드가 Manager 목록에 여러 번 나타나는 이유는 무엇인가요?

이것은 여러 설치를 나타내며, 종종 부분적인 데이터베이스 항목을 남긴 실패한 설치 시도에서 비롯됩니다. 데이터베이스를 지우고 중복 노드의 모든 복사본을 삭제한 다음 Manager를 통해 한 번 재설치하세요.

노드가 Manager를 통해 설치되었는지 수동으로 설치되었는지 어떻게 알 수 있나요?

Manager로 설치한 노드는 적절한 버전 및 업데이트 정보와 함께 설치된 노드 목록에 나타납니다. 수동으로 클론한 노드는 전혀 나타나지 않거나 업데이트 기능 없이 "알 수 없음" 버전으로 표시됩니다.

이것이 워크플로에서 노드를 사용하는 능력에 영향을 미치나요?

아니요, 노드 인식 문제는 순전히 Manager 문제입니다. ComfyUI 자체는 custom_nodes 폴더를 독립적으로 스캔하고 찾은 것을 로드합니다. 워크플로는 Manager의 인식 상태에 관계없이 작동합니다.

수십 개가 있는데 Manager가 "설치된 노드 없음"이라고 하는 이유는 무엇인가요?

이것은 완전한 데이터베이스 손상 또는 손실을 나타냅니다. 노드는 정상이고 작동합니다. Manager의 캐시 파일을 완전히 지우고 데이터베이스를 처음부터 재구축하세요. 모든 것이 감지됩니다.

문제 해결 전에 Manager의 데이터베이스를 백업할 수 있나요?

예, 삭제하기 전에 Manager 폴더에서 json 파일을 복사하세요. 문제가 발생하면 복원할 수 있습니다. 그러나 이 파일들이 바로 문제를 해결하려는 것이므로 복원하면 문제도 복원됩니다.

같은 문제가 계속 반복되면 어떻게 하나요?

반복되는 문제는 일반적으로 Manager 재구축 사이에 노드를 수동으로 재설치하는 것과 같은 워크플로 문제를 나타냅니다. 습관을 확인하고 모든 노드 작업에 일관되게 Manager를 사용하고 있는지 확인하세요.

인식 버그를 Manager의 GitHub에 보고해야 하나요?

모든 해결책을 시도했는데도 문제가 지속되면 그렇습니다. ComfyUI 버전, Manager 버전, 운영 체제 및 영향을 받는 특정 노드를 포함하세요. 개발자는 알려진 버그인지 새로운 문제인지 식별할 수 있습니다.

결론 및 예방 전략

ComfyUI Manager의 노드 인식 문제는 거의 전적으로 데이터베이스와 실제 파일 시스템 간의 비동기화에서 비롯됩니다. 해결책은 간단합니다 - 데이터베이스 재구축과 캐시 지우기를 통해 동기화를 강제해야 합니다.

간단한 재시작으로 시작하세요. 그것이 작동하지 않으면 데이터베이스를 재구축하세요. 지속적인 문제의 경우 모든 캐시 파일을 지우고 Manager가 새로 다시 만들도록 하세요.

앞으로 모든 노드 작업에 Manager를 사용하기로 약속하세요. Manager를 통해 설치하고, Manager를 통해 업데이트하고, Manager를 통해 제거하세요. 이렇게 하면 모든 것이 영구적으로 동기화됩니다.

지금 문제 해결에 쓰는 몇 분이 미래의 수 시간의 좌절을 절약합니다. Manager 데이터베이스가 설치를 정확하게 반영하면 업데이트가 원활하게 작동하고 종속성이 올바르게 해결되며 Manager의 상태 표시기를 신뢰할 수 있습니다.

이러한 기술적 관리 작업을 다루지 않으려는 사용자를 위해 Apatero.com은 모든 노드 설치 및 유지 관리를 자동으로 처리합니다. 데이터베이스 동기화 문제나 수동 문제 해결 없이 적절하게 구성된 노드에 액세스할 수 있습니다.

Manager를 최신 상태로 유지하고 일관되게 사용하면 이러한 인식 문제는 과거의 일이 됩니다.