메인 콘텐츠로 건너뛰기

​
구성 경로

V3.38부터 Manager는 향상된 보안을 위해 보호된 시스템 경로를 사용합니다.
ComfyUI 버전Manager 경로
v0.3.76+ (시스템 사용자 API 포함)<USER_DIRECTORY>/__manager/
이전 버전<USER_DIRECTORY>/default/ComfyUI-Manager/
옵션 없이 실행할 경우, <USER_DIRECTORY> 경로의 기본값은 ComfyUI/user입니다. --user-directory <USER_DIRECTORY>를 사용해 설정할 수 있습니다.

​
구성 파일

파일설명
config.ini기본 구성
channels.list구성 가능한 채널 목록
pip_overrides.json맞춤형 pip 패키지 매핑
pip_blacklist.list설치를 방지할 패키지
pip_auto_fix.list자동 복구할 패키지
snapshots/저장된 스냅샷 파일
startup-scripts/시작 스크립트 파일
components/구성 요소 파일

​
Config.ini 옵션

config.ini 파일을 수정해 설정을 적용하세요. 경로는 시작 로그 메시지에 표시됩니다. 
[default]
git_exe = <git 실행 파일 경로>
use_uv = <True/False - pip 대신 uv 사용>
default_cache_as_channel_url = <True/False - 시작 시 DB를 channel_url로 지정해 가져오기>
bypass_ssl = <True/False - 오류 발생 시 SSL 비활성화>
file_logging = <True/False - 로그 파일 생성>
windows_selector_event_loop_policy = <True/False - Windows에서 이벤트 루프 오류 수정>
model_download_by_agent = <True/False - 모델 다운로드에 에이전트 사용>
downgrade_blacklist = <쉼표로 구분된 다운그레이드 방지 패키지 목록>
security_level = <strong|normal|normal-|weak>
always_lazy_install = <True/False - 재시작 시 의존성 설치 수행>
network_mode = <public|private|offline>

​
네트워크 모드

모드설명
public표준 공개 네트워크 환경
privatechannel_url를 통해 구성된 개인 노드 DB가 있는 폐쇄 네트워크 (캐시 사용 가능 시)
offline외부 연결 없음 (캐시 사용 가능 시)

​
보안 레벨

레벨설명
strong고위험 및 중위험 기능 허용 안 함
normal고위험 기능 허용 안 함; 중위험 기능 사용 가능
normal---listen이 지정되고 127.로 시작하지 않는 경우 고위험 기능 허용 안 함; 중위험 기능 사용 가능
weak모든 기능 사용 가능

​
기능별 위험 레벨

위험 레벨기능
고위험git url을 통한 설치, pip install, 기본 채널에 없는 커스텀 노드 설치, 커스텀 노드 수정
중위험제거/업데이트, 기본 채널 내 커스텀 노드 설치, 스냅샷 복원/제거, 재시작
저위험ComfyUI 업데이트

​
환경 변수

변수설명
COMFYUI_PATHComfyUI 설치 경로
GITHUB_ENDPOINTGitHub 접속용 리버스 프록시
HF_ENDPOINTHugging Face 접속용 리버스 프록시

​
예시

GitHub 요청을 프록시를 통해 리디렉션: 
GITHUB_ENDPOINT=https://mirror.ghproxy.com/https://github.com
Hugging Face 엔드포인트 변경: 
HF_ENDPOINT=https://some-hf-mirror.com

​
고급 구성

​
특정 패키지의 다운그레이드 방지

config.ini의 downgrade_blacklist 섹션에 쉼표로 구분된 패키지 이름을 나열하세요: 
downgrade_blacklist = diffusers, kornia

​
맞춤형 pip 매핑

pip_overrides.json 파일을 만들어 특정 pip 패키지의 설치를 사용자 정의 설치로 변경하세요. 형식은 pip_overrides.json.template을 참고하세요.

​
특정 pip 패키지의 설치 방지

pip_blacklist.list 파일에 한 줄씩 패키지 이름을 나열하세요.

​
pip 설치 자동 복구

pip_auto_fix.list에 pip spec 요구사항을 나열하세요 (requirements.txt와 유사). ComfyUI를 시작하거나 커스텀 노드 설치 중 버전이 불일치할 경우 자동으로 지정된 버전을 복구합니다. --index-url를 사용할 수 있습니다.

​
aria2를 다운로더로 사용하기

빠른 다운로드를 위해 ComfyUI-Manager를 aria2로 설정할 수 있습니다. aria2 설정 가이드를 참조하세요.

​
extra_model_paths.yaml 구성

다음 설정은 is_default로 표시된 섹션에 따라 적용됩니다:
  • custom_nodes: 커스텀 노드 설치 경로
  • download_model_base: 모델 다운로드 경로

​
CLI 도구

ComfyUI-Manager는 ComfyUI를 실행하지 않고도 Manager 기능을 사용할 수 있는 명령줄 도구인 cm-cli를 제공합니다. 이는 커스텀 노드 설치를 자동화하고 헤드리스 환경에서 설치를 관리하는 데 유용합니다. 자세한 cm-cli 문서는 공식 cm-cli 가이드를 참조하세요. 보다 포괄적인 CLI 경험을 원한다면 comfy-cli를 사용해 보세요.