> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ComfyUI-Manager 설정

> ComfyUI-Manager 설정 레퍼런스: config.ini 경로 및 옵션, 보안 수준, V3.38에서 도입된 보호 시스템 경로.

## 구성 경로

V3.38부터 Manager는 향상된 보안을 위해 보호된 시스템 경로를 사용합니다.

| ComfyUI 버전 | Manager 경로 |
| - | - |
| v0.3.76+ (시스템 사용자 API 포함) | `<USER_DIRECTORY>/__manager/` |
| 이전 버전 | `<USER_DIRECTORY>/default/ComfyUI-Manager/` |

<Note>
  옵션 없이 실행할 경우, `<USER_DIRECTORY>` 경로의 기본값은 `ComfyUI/user`입니다. `--user-directory <USER_DIRECTORY>`를 사용해 설정할 수 있습니다.
</Note>

### 구성 파일

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

## Config.ini 옵션

`config.ini` 파일을 수정해 설정을 적용하세요. 경로는 시작 로그 메시지에 표시됩니다.

```ini theme={null}
[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 요청을 프록시를 통해 리디렉션:

```bash theme={null}
GITHUB_ENDPOINT=https://mirror.ghproxy.com/https://github.com
```

Hugging Face 엔드포인트 변경:

```bash theme={null}
HF_ENDPOINT=https://some-hf-mirror.com
```

## 고급 구성

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

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

```ini theme={null}
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 설정 가이드](https://github.com/Comfy-Org/ComfyUI-Manager/blob/main/docs/en/use_aria2.md)를 참조하세요.

## extra\_model\_paths.yaml 구성

다음 설정은 `is_default`로 표시된 섹션에 따라 적용됩니다:

* `custom_nodes`: 커스텀 노드 설치 경로
* `download_model_base`: 모델 다운로드 경로

## CLI 도구

ComfyUI-Manager는 ComfyUI를 실행하지 않고도 Manager 기능을 사용할 수 있는 명령줄 도구인 `cm-cli`를 제공합니다. 이는 커스텀 노드 설치를 자동화하고 헤드리스 환경에서 설치를 관리하는 데 유용합니다.

자세한 cm-cli 문서는 [공식 cm-cli 가이드](https://github.com/Comfy-Org/ComfyUI-Manager/blob/main/docs/en/cm-cli.md)를 참조하세요.

보다 포괄적인 CLI 경험을 원한다면 [comfy-cli](/ko/comfy-cli/getting-started)를 사용해 보세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.