구성 경로
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_ENDPOINT=https://mirror.ghproxy.com/https://github.com
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 설정 가이드를 참조하세요.
다음 설정은 is_default로 표시된 섹션에 따라 적용됩니다:
custom_nodes: 맞춤형 노드 설치 경로download_model_base: 모델 다운로드 경로
CLI 도구
ComfyUI-Manager는 ComfyUI를 실행하지 않고도 Manager 기능을 사용할 수 있는 명령줄 도구인 cm-cli를 제공합니다. 이는 맞춤형 노드 설치를 자동화하고 헤드리스 환경에서 설치를 관리하는 데 유용합니다.
자세한 cm-cli 문서는 공식 cm-cli 가이드를 참조하세요.
보다 포괄적인 CLI 경험을 원한다면 comfy-cli를 사용해 보세요.
