일반적인 문제
사용자 지정 git 실행 파일 경로
git.exe가 시스템 기본값이 아닌 특정 위치에 설치된 경우:
- ComfyUI-Manager를 설치하고 ComfyUI를 한 번 실행하세요.
<USER_DIRECTORY>/default/ComfyUI-Manager/config.ini>를 엽니다.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 Manager 로드 시 Overlapped Object has pending operation at deallocation 오류가 발생하는 경우:
config.ini를 편집하고 다음을 추가하세요.
windows_selector_event_loop_policy = True
SSL 인증서 검증 실패
SSL: CERTIFICATE_VERIFY_FAILED 오류가 발생하는 경우:
config.ini를 편집하고 다음을 추가하세요.
설치 문제
잘못된 설치 경로
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-update | extension-node-map.json 업데이트 생략 |
--skip-stat-update | github-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에서 보안 레벨을 구성하세요.
| 레벨 | 설명 |
|---|
strong | 고위험 및 중위험 기능을 허용하지 않음 |
normal | 고위험 기능을 허용하지 않음; 중위험 기능 사용 가능 |
normal- | --listen이 지정되고 127.로 시작하지 않는 경우 고위험 기능을 허용하지 않음; 중위험 기능 사용 가능 |
weak | 모든 기능 사용 가능 |
기능별 위험 레벨
| 위험 레벨 | 기능 |
|---|
| 고위험 | git URL을 통한 설치, pip install, 기본 채널이 아닌 커스텀 노드 설치, 커스텀 노드 수정 |
| 중위험 | 제거/업데이트, 기본 채널의 커스텀 노드 설치, 스냅샷 복원/제거, 재시작 |
| 저위험 | ComfyUI 업데이트 |
커스텀 노드를 git URL이나 야간 버전을 통해 설치하려면 config.ini에서 security_level = weak로 설정하세요.
도움 받기
아직 문제가 해결되지 않았다면:
- ComfyUI-Manager GitHub 이슈에서 비슷한 문제 확인
- 시작 로그 메시지를 살펴보며 오류 상세 정보 확인
- ComfyUI Discord에 가입해 커뮤니티 지원 받기
