구성 - ComfyUI

구성 경로

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`	표준 공개 네트워크 환경
`private`	`channel_url`를 통해 구성된 개인 노드 DB가 있는 폐쇄 네트워크 (캐시 사용 가능 시)
`offline`	외부 연결 없음 (캐시 사용 가능 시)

보안 레벨

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

기능별 위험 레벨

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

환경 변수

변수	설명
`COMFYUI_PATH`	ComfyUI 설치 경로
`GITHUB_ENDPOINT`	GitHub 접속용 리버스 프록시
`HF_ENDPOINT`	Hugging 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를 사용해 보세요.

​구성 경로

​구성 파일

​Config.ini 옵션

​네트워크 모드

​보안 레벨

​기능별 위험 레벨

​환경 변수

​예시

​고급 구성

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

​맞춤형 pip 매핑

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

​pip 설치 자동 복구

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

​extra_model_paths.yaml 구성

​CLI 도구

구성 경로

구성 파일

Config.ini 옵션

네트워크 모드

보안 레벨

기능별 위험 레벨

환경 변수

예시

고급 구성

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

맞춤형 pip 매핑

특정 pip 패키지의 설치 방지

pip 설치 자동 복구

aria2를 다운로더로 사용하기

extra_model_paths.yaml 구성

CLI 도구