메인 콘텐츠로 건너뛰기

​
일반적인 문제

​
사용자 지정 git 실행 파일 경로

git.exe가 시스템 기본값이 아닌 특정 위치에 설치된 경우:
  1. ComfyUI-Manager를 설치하고 ComfyUI를 한 번 실행하세요.
  2. <USER_DIRECTORY>/default/ComfyUI-Manager/config.ini>를 엽니다.
  3. git_exe =에 파일 이름을 포함한 전체 경로를 지정하세요.
git_exe = C:\Program Files\Git\bin\git.exe

​
ComfyUI-Manager 업데이트 실패

ComfyUI-Manager 자체의 업데이트가 실패할 경우, ComfyUI-Manager 디렉터리로 이동하여 다음 명령을 실행하세요. 
git update-ref refs/remotes/origin/main a361cc1 && git fetch --all && git pull

​
Windows: 오버랩된 객체 오류

ComfyUI 매니저 로드 시 Overlapped Object has pending operation at deallocation 오류가 발생하는 경우: config.ini를 편집하고 다음을 추가하세요. 
windows_selector_event_loop_policy = True

​
SSL 인증서 검증 실패

SSL: CERTIFICATE_VERIFY_FAILED 오류가 발생하는 경우: config.ini를 편집하고 다음을 추가하세요. 
bypass_ssl = True

​
설치 문제

​
잘못된 설치 경로

ComfyUI-Manager 파일은 ComfyUI/custom_nodes/comfyui-manager에 위치해야 합니다. 피해야 할 일반적인 실수:
문제문제
잘못된 위치에 파일 있음__init__.py와 같은 관리자 파일이 직접 custom_nodes 디렉터리에 배치됨
중첩된 폴더custom_nodes/ComfyUI-Manager/ComfyUI-Manager로 설치됨
잘못된 폴더 이름custom_nodes/ComfyUI-Manager-main으로 설치됨
압축된 형식적절히 압축 해제하지 않고 압축 파일에서 설치됨
잘못 설치된 경우 ComfyUI-Manager는 작동하는 것처럼 보일 수 있지만 업데이트를 인식하지 못하고 중복 설치를 유발할 수 있습니다. 이를 제거하고 git clone을 통해 올바르게 다시 설치하세요.

​
네트워크 문제

​
GitHub 접근 문제

GitHub에 대한 접근 권한이 제한된 경우, GITHUB_ENDPOINT 환경 변수를 설정하세요. 
GITHUB_ENDPOINT=https://mirror.ghproxy.com/https://github.com

​
Hugging Face 접근 문제

Hugging Face에 대한 접근 권한이 제한된 경우, HF_ENDPOINT 환경 변수를 설정하세요. 
HF_ENDPOINT=https://some-hf-mirror.com

​
스캐너 문제 해결

scan.sh 스크립트를 실행할 때:
  • custom-node-list.json에 나열된 커스텀 노드를 ~/.tmp/default로 가져오거나 복제하여 extension-node-map.json을 업데이트합니다.
  • GitHub API를 사용해 github-stats.json을 업데이트합니다.
옵션설명
--skip-updateextension-node-map.json 업데이트 생략
--skip-stat-updategithub-stats.json 업데이트 생략
--skip-all두 가지 업데이트 단계 모두 생략
GitHub API 속도 제한을 피하려면 토큰을 설정하세요: export GITHUB_TOKEN=your_token_here
~/.tmp/default 대신 다른 경로를 지정하려면 scan.sh 대신 python scanner.py [경로]를 직접 실행하세요.

​
보안 정책

커스텀 노드를 git URL을 통해 설치하거나 야간 버전을 사용할 때 This action is not allowed with this security level configuration 오류가 발생하면 config.ini 파일의 보안 레벨을 조정해야 합니다. config.ini 파일의 위치는 다음과 같습니다:
  • ComfyUI v0.3.76+: <USER_DIRECTORY>/__manager/config.ini
  • 이전 버전: <USER_DIRECTORY>/default/ComfyUI-Manager/config.ini
여기서 <USER_DIRECTORY>는 기본적으로 ComfyUI/user입니다. 자세한 내용은 구성을 참조하세요. config.ini에서 보안 레벨을 구성하세요. 
security_level = normal
레벨설명
strong고위험 및 중위험 기능을 허용하지 않음
normal고위험 기능을 허용하지 않음; 중위험 기능 사용 가능
normal---listen이 지정되고 127.로 시작하지 않는 경우 고위험 기능을 허용하지 않음; 중위험 기능 사용 가능
weak모든 기능 사용 가능

​
기능별 위험 레벨

위험 레벨기능
고위험git URL을 통한 설치, pip install, 기본 채널이 아닌 커스텀 노드 설치, 커스텀 노드 수정
중위험제거/업데이트, 기본 채널의 커스텀 노드 설치, 스냅샷 복원/제거, 재시작
저위험ComfyUI 업데이트
커스텀 노드를 git URL이나 야간 버전을 통해 설치하려면 config.ini에서 security_level = weak로 설정하세요.

​
도움 받기

아직 문제가 해결되지 않았다면:
  1. ComfyUI-Manager GitHub 이슈에서 비슷한 문제 확인
  2. 시작 로그 메시지를 살펴보며 오류 상세 정보 확인
  3. ComfyUI Discord에 가입해 커뮤니티 지원 받기