> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 구성

> ComfyUI-Manager 설정 구성

## 구성 경로

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)를 사용해 보세요.