> ## 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 문제 해결하기

## 일반적인 문제

### 사용자 지정 git 실행 파일 경로

`git.exe`가 시스템 기본값이 아닌 특정 위치에 설치된 경우:

1. ComfyUI-Manager를 설치하고 ComfyUI를 한 번 실행하세요.
2. `<USER_DIRECTORY>/default/ComfyUI-Manager/config.ini>`를 엽니다.
3. `git_exe =`에 파일 이름을 포함한 전체 경로를 지정하세요.

```ini theme={null}
git_exe = C:\Program Files\Git\bin\git.exe
```

### ComfyUI-Manager 업데이트 실패

ComfyUI-Manager 자체의 업데이트가 실패할 경우, ComfyUI-Manager 디렉터리로 이동하여 다음 명령을 실행하세요.

```bash theme={null}
git update-ref refs/remotes/origin/main a361cc1 && git fetch --all && git pull
```

### Windows: 오버랩된 객체 오류

ComfyUI Manager 로드 시 `Overlapped Object has pending operation at deallocation` 오류가 발생하는 경우:

`config.ini`를 편집하고 다음을 추가하세요.

```ini theme={null}
windows_selector_event_loop_policy = True
```

### SSL 인증서 검증 실패

`SSL: CERTIFICATE_VERIFY_FAILED` 오류가 발생하는 경우:

`config.ini`를 편집하고 다음을 추가하세요.

```ini theme={null}
bypass_ssl = True
```

## 설치 문제

### 잘못된 설치 경로

ComfyUI-Manager 파일은 `ComfyUI/custom_nodes/comfyui-manager`에 위치해야 합니다.

**피해야 할 일반적인 실수:**

| 문제            | 문제                                                    |
| ------------- | ----------------------------------------------------- |
| 잘못된 위치에 파일 있음 | `__init__.py`와 같은 관리자 파일이 직접 `custom_nodes` 디렉터리에 배치됨 |
| 중첩된 폴더        | `custom_nodes/ComfyUI-Manager/ComfyUI-Manager`로 설치됨   |
| 잘못된 폴더 이름     | `custom_nodes/ComfyUI-Manager-main`으로 설치됨             |
| 압축된 형식        | 적절히 압축 해제하지 않고 압축 파일에서 설치됨                            |

<Warning>
  잘못 설치된 경우 ComfyUI-Manager는 작동하는 것처럼 보일 수 있지만 업데이트를 인식하지 못하고 중복 설치를 유발할 수 있습니다. 이를 제거하고 `git clone`을 통해 올바르게 다시 설치하세요.
</Warning>

## 네트워크 문제

### GitHub 접근 문제

GitHub에 대한 접근 권한이 제한된 경우, `GITHUB_ENDPOINT` 환경 변수를 설정하세요.

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

### Hugging Face 접근 문제

Hugging Face에 대한 접근 권한이 제한된 경우, `HF_ENDPOINT` 환경 변수를 설정하세요.

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

## 스캐너 문제 해결

`scan.sh` 스크립트를 실행할 때:

* `custom-node-list.json`에 나열된 커스텀 노드를 `~/.tmp/default`로 가져오거나 복제하여 `extension-node-map.json`을 업데이트합니다.
* GitHub API를 사용해 `github-stats.json`을 업데이트합니다.

| 옵션                   | 설명                              |
| -------------------- | ------------------------------- |
| `--skip-update`      | extension-node-map.json 업데이트 생략 |
| `--skip-stat-update` | github-stats.json 업데이트 생략       |
| `--skip-all`         | 두 가지 업데이트 단계 모두 생략              |

<Tip>
  GitHub API 속도 제한을 피하려면 토큰을 설정하세요: `export GITHUB_TOKEN=your_token_here`
</Tip>

`~/.tmp/default` 대신 다른 경로를 지정하려면 `scan.sh` 대신 `python scanner.py [경로]`를 직접 실행하세요.

## 보안 정책

커스텀 노드를 git URL을 통해 설치하거나 야간 버전을 사용할 때 `This action is not allowed with this security level configuration` 오류가 발생하면 `config.ini` 파일의 보안 레벨을 조정해야 합니다.

`config.ini` 파일의 위치는 다음과 같습니다:

* **ComfyUI v0.3.76+**: `<USER_DIRECTORY>/__manager/config.ini`
* **이전 버전**: `<USER_DIRECTORY>/default/ComfyUI-Manager/config.ini`

여기서 `<USER_DIRECTORY>`는 기본적으로 `ComfyUI/user`입니다. 자세한 내용은 [구성](/ko/manager/configuration)을 참조하세요.

`config.ini`에서 보안 레벨을 구성하세요.

```ini theme={null}
security_level = normal
```

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

### 기능별 위험 레벨

| 위험 레벨   | 기능                                                          |
| ------- | ----------------------------------------------------------- |
| **고위험** | git URL을 통한 설치, pip install, 기본 채널이 아닌 커스텀 노드 설치, 커스텀 노드 수정 |
| **중위험** | 제거/업데이트, 기본 채널의 커스텀 노드 설치, 스냅샷 복원/제거, 재시작                   |
| **저위험** | ComfyUI 업데이트                                                |

<Tip>
  커스텀 노드를 git URL이나 야간 버전을 통해 설치하려면 `config.ini`에서 `security_level = weak`로 설정하세요.
</Tip>

## 도움 받기

아직 문제가 해결되지 않았다면:

1. [ComfyUI-Manager GitHub 이슈](https://github.com/Comfy-Org/ComfyUI-Manager/issues)에서 비슷한 문제 확인
2. 시작 로그 메시지를 살펴보며 오류 상세 정보 확인
3. [ComfyUI Discord](https://discord.com/invite/comfyorg)에 가입해 커뮤니티 지원 받기