ComfyUI-Manager

KO | EN

gitlite — search

#python #golang #android #machine-learning #deep-learning #linux #windows #awesome #cli #kubernetes #vue #pytorch #security #mcp

ComfyUI-Manager

(★ 15,792)

ComfyUI-Manager는 ComfyUI의 사용 편의성을 높이기 위해 제작된 확장 프로그램입니다. ComfyUI의 다양한 커스텀 노드를 설치, 제거, 비활성화 및 활성화할 수 있는 관리 기능을 제공합니다. 나아가 이 확장 프로그램은 ComfyUI 내에서 다양한 정보에 접근할 수 있는 허브 기능과 편리한 기능들을 제공합니다.

ComfyUI-Manager 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ComfyUI Manager
\*\*ComfyUI-Manager\*\*는 [ComfyUI](https://github.com/comfyanonymous/ComfyUI)의 사용성을 향상시키기 위해 제작된 확장 프로그램입니다. ComfyUI의 다양한 커스텀 노드를 \*\*설치, 제거, 비활성화 및 활성화\*\*할 수 있는 관리 기능을 제공합니다. 나아가 이 확장 프로그램은 ComfyUI 내에서 광범위한 정보에 접근할 수 있는 허브 기능과 편의 기능을 제공합니다.
![menu](https://raw.githubusercontent.com/ltdrdata/ComfyUI-extension-tutorials/refs/heads/Main/ComfyUI-Manager/images/dialog.jpg)
## 알림
\* V3.38: \*\*보안 패치\*\* - 관리자 데이터가 보호된 경로로 마이그레이션되었습니다. [Migration Guide](docs/en/v3.38-userdata-security-migration.md)를 참조하세요.
\* V3.16: `uv` 지원이 추가되었습니다. `config.ini`에서 `use\_uv`를 설정하세요.
\* V3.10: `double-click feature`가 제거되었습니다.
\* 이 기능은 https://github.com/ltdrdata/comfyui-connection-helper 로 이전되었습니다.
\* V3.3.2: 개편되었습니다. 공식적으로 [https://registry.comfy.org/](https://registry.comfy.org/)를 지원합니다.
\* 전체 노드 정보는 [ComfyUI Nodes Info](https://ltdrdata.github.io/) 페이지에서 확인할 수 있습니다.
## 설치
### 설치 [방법1] (일반 설치 방법: ComfyUI-Manager 단독 설치)
기존에 설치된 ComfyUI에 ComfyUI-Manager를 추가로 설치하려면 다음 단계를 따르세요:
1. 터미널(cmd)에서 `ComfyUI/custom\_nodes` 디렉터리로 이동합니다.
2. `git clone https://github.com/ltdrdata/ComfyUI-Manager comfyui-manager`
3. ComfyUI를 재시작합니다.
### 설치 [방법2] (포터블 ComfyUI 버전용 설치: ComfyUI-Manager 단독 설치)
1. git 설치
- https://git-scm.com/download/win
- 스탠드알론 버전
- 옵션 선택: use windows default console window
2. 설치된 `"ComfyUI\_windows\_portable"` 디렉터리에 [scripts/install-manager-for-portable-version.bat](https://github.com/ltdrdata/ComfyUI-Manager/raw/main/scripts/install-manager-for-portable-version.bat) 파일을 다운로드합니다.
- 클릭하지 마세요. 링크를 마우스 우클릭하고 '다른 이름으로 저장...'을 선택하세요.
3. `install-manager-for-portable-version.bat` 배치 파일을 더블클릭합니다.
![portable-install](https://raw.githubusercontent.com/ltdrdata/ComfyUI-extension-tutorials/Main/ComfyUI-Manager/images/portable-install.jpg)
### 설치 [방법3] (comfy-cli를 통한 설치: ComfyUI와 ComfyUI-Manager를 한 번에 설치)
> 권장: comfy-cli는 CLI에서 ComfyUI를 관리할 수 있는 다양한 기능을 제공합니다.
\* \*\*필수 조건: python 3, git\*\*
Windows:
```commandline
python -m venv venv
venv\Scripts\activate
pip install comfy-cli
comfy install
```
Linux/macOS:
```commandline
python -m venv venv
. venv/bin/activate
pip install comfy-cli
comfy install
```
\* 참고: https://github.com/Comfy-Org/comfy-cli
### 설치 [방법4] (Linux + venv 환경용 설치: ComfyUI + ComfyUI-Manager)
venv 환경을 사용하는 Linux에서 ComfyUI와 ComfyUI-Manager를 함께 설치하려면 다음 단계를 따르세요:
\* \*\*필수 조건: python-is-python3, python3-venv, git\*\*
1. 빈 설치 디렉터리에 [scripts/install-comfyui-venv-linux.sh](https://github.com/ltdrdata/ComfyUI-Manager/raw/main/scripts/install-comfyui-venv-linux.sh) 파일을 다운로드합니다.
- 클릭하지 마세요. 링크를 마우스 우클릭하고 '다른 이름으로 저장...'을 선택하세요.
- ComfyUI는 지정된 디렉터리의 하위 디렉터리에 설치되며, 해당 디렉터리에는 생성된 실행 스크립트가 포함됩니다.
2. `chmod +x install-comfyui-venv-linux.sh`
3. `./install-comfyui-venv-linux.sh`
### 설치 시 주의사항
\* \*\*권장 사항\*\*: `ComfyUI-Manager` 파일은 반드시 `ComfyUI/custom\_nodes/comfyui-manager` 경로에 정확히 위치해야 합니다.
\* 압축 파일 형식으로 설치하는 것은 권장하지 않습니다.
\* \*\*주의 사항\*\*: `ComfyUI/custom\_nodes` 위치에 직접 압축을 해제하여 `\_\_init\_\_.py` 같은 관리자 파일들이 해당 디렉터리에 바로 위치하게 하지 마세요.
\* `ComfyUI/custom\_nodes`에서 모든 ComfyUI-Manager 파일을 제거해야 합니다.
\* \*\*주의 사항\*\*: `ComfyUI/custom\_nodes/ComfyUI-Manager/ComfyUI-Manager`와 같은 경로에 압축이 해제되는 형태로는 설치하지 마세요.
\* \*\*주의 사항\*\*: 다음과 같은 경로에 압축이 해제되는 형태로는 설치하지 마세요

ch as `ComfyUI/custom\_nodes/ComfyUI-Manager-main`.
\* 이러한 경우 `ComfyUI-Manager`가 작동할 수는 있지만, `ComfyUI-Manager` 내에서 인식되지 않으며 업데이트를 수행할 수 없습니다. 또한 중복 설치의 위험도 있습니다. 이를 제거하고 `git clone` 방식을 통해 올바르게 설치하세요.
시스템 구성에 따라 `./run\_gpu.sh` 또는 `./run\_cpu.sh` 중 하나를 실행하여 ComfyUI를 실행할 수 있습니다.
## Colab Notebook
이 저장소는 ComfyUI-Manager를 포함하여 ComfyUI를 설치하고 사용할 수 있는 Colab 노트북을 제공합니다. ComfyUI를 사용하려면 [이 링크를 클릭하세요](https://colab.research.google.com/github/ltdrdata/ComfyUI-Manager/blob/main/notebooks/comfyui\_colab\_with\_manager.ipynb).
\* ComfyUI 설치 지원
\* ComfyUI-Manager 기본 설치 지원
\* Colab 노트북 재시작 시 커스텀 노드의 종속성을 자동으로 설치하는 기능 지원.
## How To Use
1. 메인 메뉴에서 "Manager" 버튼을 클릭합니다.
![mainmenu](https://raw.githubusercontent.com/ltdrdata/ComfyUI-extension-tutorials/Main/ComfyUI-Manager/images/topbar.jpg)
2. 'Install Custom Nodes' 또는 'Install Models'를 클릭하면 설치 프로그램 대화상자가 열립니다.
![menu](https://raw.githubusercontent.com/ltdrdata/ComfyUI-extension-tutorials/refs/heads/Main/ComfyUI-Manager/images/dialog.jpg)
\* DB 모드에는 `DB: Channel (1day cache)`, `DB: Local`, `DB: Channel (remote)`의 세 가지가 있습니다.
\* `Channel (1day cache)`은 유효 기간이 하루인 채널 캐시 정보를 활용하여 목록을 빠르게 표시합니다.
\* 이 정보는 캐시가 없거나, 캐시가 만료되었거나, Channel (remote)을 통해 외부 정보를 가져올 때 업데이트됩니다.
\* ComfyUI를 새로 시작할 때마다 이 모드가 항상 \*\*기본(default)\*\* 모드로 설정됩니다.
\* `Local`은 ComfyUI-Manager에 로컬로 저장된 정보를 사용합니다.
\* 이 정보는 ComfyUI-Manager를 업데이트할 때만 업데이트됩니다.
\* 커스텀 노드 개발자는 노드를 `custom-node-list.json`에 등록하고 테스트할 때 이 모드를 사용해야 합니다.
\* `Channel (remote)`은 원격 채널에서 정보를 가져와 항상 최신 목록을 표시합니다.
\* 네트워크 오류 등으로 가져올 수 없는 경우, 로컬 정보를 강제로 사용합니다.
\* ```Fetch Updates``` 메뉴는 커스텀 노드의 업데이트 데이터를 로컬로 가져옵니다. 실제 업데이트는 ```Install Custom Nodes``` 메뉴의 ```Update``` 버튼을 클릭하여 적용됩니다.
3. 'Install' 또는 'Try Install' 버튼을 클릭합니다.
![node-install-dialog](https://raw.githubusercontent.com/ltdrdata/ComfyUI-extension-tutorials/Main/ComfyUI-Manager/images/custom-nodes.jpg)
![model-install-dialog](https://raw.githubusercontent.com/ltdrdata/ComfyUI-extension-tutorials/Main/ComfyUI-Manager/images/models.jpg)
\* Installed: 이 항목은 이미 설치되어 있습니다.
\* Install: 이 버튼을 클릭하면 항목이 설치됩니다.
\* Try Install: 설치 정보를 확인할 수 없는 커스텀 노드입니다. 버튼을 클릭하여 설치를 시도하세요.
\* 상단에 빨간색 배경의 `Channel` 표시기가 나타나면 기본 채널이 아님을 의미합니다. 보유한 정보량이 기본 채널과 다르기 때문에, 이 채널 상태에서는 많은 커스텀 노드가 나타나지 않을 수 있습니다.
\* 채널 설정은 노드 목록뿐만 아니라 "모두 업데이트(Update all)"와 같은 모든 기능에 광범위한 영향을 미칩니다.
\* 노란색 배경의 Conflicted Nodes는 해당 확장 프로그램에서 다른 확장 프로그램과 충돌하는 노드 목록을 보여줍니다. 이 문제는 개발자가 해결해야 하며, 사용자는 이러한 충돌로 인해 일부 노드가 제대로 작동하지 않을 수 있으므로 이에 따라 설치해야 한다는 점을 인지해야 합니다.
4. Share
![menu](https://raw.githubusercontent.com/ltdrdata/ComfyUI-extension-tutorials/Main/ComfyUI-Manager/images/topbar.jpg) ![share](https://raw.githubusercontent.com/ltdrdata/ComfyUI-extension-tutorials/Main/ComfyUI-Manager/images/share.jpg)
\* 메인 메뉴 하단의 Share 버튼을 클릭하거나 Share Output을 선택하여 워크플로우를 공유할 수 있습니다.

Image 노드의 Context Menu에서.
\* 현재 [https://comfyworkflows.com/](https://comfyworkflows.com/),
[https://openart.ai](https://openart.ai/workflows/dev), [https://youml.com](https://youml.com) 및 Matrix 채널을 통한 공유를 지원합니다.
![menu](https://raw.githubusercontent.com/ltdrdata/ComfyUI-extension-tutorials/Main/ComfyUI-Manager/images/share-setting.jpg)
\* Manager 메뉴의 Share 설정을 통해 Main 메뉴의 Share 버튼이나 Context Menu의 Share Output 버튼의 동작을 구성할 수 있습니다.
\* `None`: Main 메뉴에서 숨깁니다.
\* `All`: 사용자가 공유할 제목을 선택할 수 있는 대화상자를 표시합니다.
## Paths
V3.38부터 보안 강화를 위해 Manager는 보호된 시스템 경로를 사용합니다.
\* 
\* 옵션 없이 실행하는 경우 경로의 기본값은 ComfyUI/user입니다.
\* --user-directory 를 사용하여 설정할 수 있습니다.
| ComfyUI Version | Manager Path |
|-----------------|--------------|
| v0.3.76+ (with System User API) | `/\_\_manager/` |
| Older versions | `/default/ComfyUI-Manager/` |
\* 기본 설정 파일: `config.ini`
\* 설정 가능한 채널 목록: `channels.list`
\* 설정 가능한 pip 재정의: `pip\_overrides.json`
\* 설정 가능한 pip 블랙리스트: `pip\_blacklist.list`
\* 설정 가능한 pip 자동 수정: `pip\_auto\_fix.list`
\* 저장된 스냅샷 파일: `snapshots/`
\* 시작 스크립트 파일: `startup-scripts/`
\* 컴포넌트 파일: `components/`
> \*\*Note\*\*업그레이드 세부 정보는 [Migration Guide](docs/en/v3.38-userdata-security-migration.md)를 참조하세요.
## `extra\_model\_paths.yaml` Configuration
`is\_default`로 표시된 섹션을 기반으로 다음 설정이 적용됩니다.
\* `custom\_nodes`: 커스텀 노드 설치 경로
\* 가져오기(Import)는 `is\_default`로 설정된 경로를 따를 필요는 없지만, `ComfyUI Nodes Manager`에 의해 커스텀 노드가 설치되는 경로입니다.
\* `download\_model\_base`: 모델 다운로드 경로
## Snapshot-Manager
\* `Manager Menu`에서 `Save snapshot`을 누르거나 `Update All`을 사용하면 현재 설치 상태 스냅샷이 저장됩니다.
\* 스냅샷 파일 디렉토리: `/default/ComfyUI-Manager/snapshots`
\* 스냅샷 파일의 이름을 변경할 수 있습니다.
\* "Restore" 버튼을 누르면 해당 스냅샷의 설치 상태로 되돌립니다.
\* 단, Git으로 관리되지 않는 커스텀 노드의 경우 스냅샷 지원이 불완전합니다.
\* `Restore`를 누르면 다음 ComfyUI 시작 시 적용됩니다.
\* 선택한 스냅샷 파일은 `/default/ComfyUI-Manager/startup-scripts/restore-snapshot.json`에 저장되며, ComfyUI를 다시 시작하면 스냅샷이 적용된 후 삭제됩니다.
![model-install-dialog](https://raw.githubusercontent.com/ltdrdata/ComfyUI-extension-tutorials/Main/ComfyUI-Manager/images/snapshot.jpg)
## cm-cli: 파워 유저를 위한 명령줄 도구
\* ComfyUI를 실행하지 않고도 ComfyUI-Manager의 기능을 사용할 수 있는 도구가 제공됩니다.
\* 자세한 내용은 [cm-cli documentation](docs/en/cm-cli.md)을 참조하세요.
## ComfyUI-Manager에 커스텀 노드를 등록하는 방법
\* ComfyUI-Manager의 루트에 있는 `custom-node-list.json`에 항목을 추가하고 Pull Request를 제출하세요.
\* NOTE: 변경 사항을 적용한 후 PR을 제출하기 전에 `Use local DB`를 체크하고 `Install custom nodes` 대화상자에서 확장 목록이 문제없이 로드되는지 확인하세요. 쉼표가 누락되거나 초과되면 간혹 JSON 구문 오류가 발생할 수 있습니다.
\* 나머지 JSON은 향후 스크립트를 통해 업데이트되므로 신경 쓰지 않으셔도 됩니다.
## 커스텀 노드 지원 가이드
\* \*\*NOTICE:\*\*
- 이제 GitHub 리포지토리 이름이 `custom\_nodes` 아래의 하위 디렉토리 이름과 일치한다고 가정해서는 안 됩니다. `custom\_nodes` 아래의 하위 디렉토리 이름에는 이제 `pyproject.toml`의 `name` 필드에서 가져온 정규화된 이름이 사용됩니다.
- 가능하면 가져오기(import) 시 디렉토리 이름에 의존하지 마세요.
\* https://docs.comfy.org/registry/overview
\* https://github.com/Comfy-Org/rfcs
\*\*특수 목적 파일\*\* (선택 사항)
\* `pyproject.toml` - comfyregistry용 스펙 파일.
\* `node\_lis

t.json` - 커스텀 노드의 NODE\_CLASS\_MAPPINGS 패턴이 일반적이지 않은 경우, 참조용 노드 목록을 수동으로 제공하는 데 사용됩니다. ([예시](https://github.com/melMass/comfy\_mtb/raw/main/node\_list.json))
\* `requirements.txt` - 설치 시, 이 pip 요구 사항이 자동으로 설치됩니다.
\* `install.py` - 설치 시, 자동으로 호출됩니다.
\* \*\*모든 스크립트는 해당 커스텀 노드의 루트 경로에서 실행됩니다.\*\*
## 컴포넌트 공유
\* \*\*복사 & 붙여넣기\*\*
\* [데모 페이지](https://ltdrdata.github.io/component-demo/)
\* 클립보드에서 컴포넌트를 붙여넣을 때, 다음 JSON 형식의 텍스트를 지원합니다. (text/plain)
```
{
"kind": "ComfyUI Components",
"timestamp": ,
"components":
{
: 
}
}
```
\* `` 타임스탬프는 항상 고유하도록 보장해야 합니다.
\* "components"는 `/default/ComfyUI-Manager/components`에 저장된 파일의 내용과 동일한 구조를 가져야 합니다.
\* ``: 이름은 `::` 형식이어야 합니다.
\* ``: 그룹 노드의 노드 데이터 내에 있습니다.
\* ``: `major.minor.patch` 또는 `major.minor`의 두 가지 형식만 허용됩니다. (예: `1.0`, `2.2.1`)
\* ``: 저장된 시간
\* ``: 팩 이름(packname)이 비어 있지 않은 경우, 카테고리가 packname/workflow가 되며 `/default/ComfyUI-Manager/components`의 .pack 파일에 저장됩니다.
\* ``: 카테고리나 팩 이름이 모두 없는 경우, components 카테고리에 저장됩니다.
```
"version":"1.0",
"datetime": 1705390656516,
"packname": "mypack",
"category": "util/pipe",
```
\* \*\*드래그 & 드롭\*\*
\* `.pack` 또는 `.json` 파일을 드래그 앤 드롭하면 해당하는 컴포넌트가 추가됩니다.
\* 팩 예시: [Impact.pack](misc/Impact.pack)
\* 단일 컴포넌트를 드래그 앤 드롭하거나 붙여넣으면 노드가 추가됩니다. 단, 여러 컴포넌트를 추가할 때는 노드가 추가되지 않습니다.
## 누락된 노드 설치 지원
![missing-menu](https://raw.githubusercontent.com/ltdrdata/ComfyUI-extension-tutorials/Main/ComfyUI-Manager/images/missing-menu.jpg)
\* 메뉴에서 ```Install Missing Custom Nodes``` 버튼을 클릭하면, 현재 워크플로우에 존재하지 않는 노드를 포함하는 확장 노드 목록이 표시됩니다.
![missing-list](https://raw.githubusercontent.com/ltdrdata/ComfyUI-extension-tutorials/Main/ComfyUI-Manager/images/missing-list.jpg)
# 설정 (Config)
\* `config.ini` 파일을 수정하여 ComfyUI-Manager의 설정을 적용할 수 있습니다.
\* ComfyUI-Manager가 사용하는 `config.ini`의 경로는 시작 로그 메시지에 표시됩니다.
\* 참고: [https://github.com/ltdrdata/ComfyUI-Manager#paths]
\* 설정 옵션:
```
[default]
git\_exe = 
use\_uv = 
default\_cache\_as\_channel\_url = 
bypass\_ssl = 
file\_logging = 
windows\_selector\_event\_loop\_policy = 
model\_download\_by\_agent = 
downgrade\_blacklist = 
security\_level =  strong|normal|normal-|weak>
always\_lazy\_install = 
network\_mode =  public|private|offline>
```
\* network\_mode:
- public: 일반적인 공용 네트워크를 사용하는 환경입니다.
- private: 폐쇄망을 사용하는 환경으로, `channel\_url`을 통해 프라이빗 노드 DB가 구성됩니다. (가능한 경우 캐시 사용)
- offline: 오프라인 네트워크를 사용할 때 외부 연결을 전혀 사용하지 않는 환경입니다. (가능한 경우 캐시 사용)
## 추가 기능
\* 파일 로깅 기능
\* 이 기능은 기본적으로 활성화되어 있으며, `config.ini`에서 `file\_logging = False`로 설정하여 비활성화할 수 있습니다.
\* 노드 수정 (재생성): 노드를 마우스 우클릭하고 `Fix node (recreate)`를 선택하여 노드를 다시 생성할 수 있습니다. 위젯의 값은 초기화되며, 연결은 동일한 이름을 가진 것들끼리 유지됩니다.
\* 이는 커스텀 노드의 버전 변경과 호환되지 않는, 이전에 생성된 오래된 워크플로우의 노드 오류를 수정하는 데 사용됩니다.
\* 노드 제목 더블 클릭: ComfyUI-Manager 메뉴에서 노드의 더블 클릭 동작을 설정할 수 있습니다.
\* `Copy All Connections`, `Copy Input Connections`: 노드를 더블 클릭하면 가장 가까운 노드의 연결을 복사합니다.
\* 이 작업은 직선 거리 내에서 가장 가까운 노드를 대상으로 합니다.

노드 중심에서 1000픽셀의 선 거리.
\* `Copy All Connections`의 경우 기존 출력을 복제하지만, 중복 연결을 허용하지 않으므로 원본 노드의 기존 출력 연결은 해제됩니다.
\* 이 기능은 이름이 일치하는 입력과 출력만 복사합니다.
\* `Possible Input Connections`: 지정된 범위 내에서 가장 가까운 타입과 일치하는 모든 출력을 연결합니다.
\* 이 연결은 타겟 노드의 왼쪽에 위치한 노드들 중 가장 가까운 출력에 연결됩니다.
\* `Possible(left) + Copy(right)`: 제목의 왼쪽 절반을 더블 클릭하면 `Possible Input Connections`로 작동하고, 오른쪽 절반을 더블 클릭하면 `Copy All Connections`로 작동합니다.
\* 특정 패키지의 다운그레이드 방지
\* `config.ini` 파일의 `downgrade\_blacklist` 섹션에 패키지 이름을 쉼표로 구분하여 나열하세요.
\* 예시
```
downgrade\_blacklist = diffusers, kornia
```
\* 커스텀 pip 매핑
\* `pip\_overrides.json` 파일을 생성하면, 특정 pip 패키지의 설치를 사용자가 정의한 설치 방식으로 변경합니다.
\* `pip\_overrides.json.template` 파일을 참고하세요.
\* 특정 pip 패키지 설치 방지
\* `pip\_blacklist.list` 파일에 패키지 이름을 줄당 하나씩 나열하세요.
\* pip 설치 자동 복구
\* `requirements.txt`와 유사하게 `pip\_auto\_fix.list`에 pip 사양 요구사항을 나열하면, ComfyUI를 시작할 때 또는 다양한 커스텀 노드 설치 과정에서 버전이 일치하지 않을 때 지정된 버전을 자동으로 복구합니다.
\* `--index-url`을 사용할 수 있습니다.
\* 다운로더로 `aria2` 사용
\* [howto](docs/en/use\_aria2.md)
## Environment Variables
환경 변수를 사용하여 다음 기능들을 설정할 수 있습니다:
\* \*\*COMFYUI\_PATH\*\*: ComfyUI의 설치 경로
\* \*\*GITHUB\_ENDPOINT\*\*: GitHub 접근이 제한된 환경을 위한 리버스 팩시 설정
\* \*\*HF\_ENDPOINT\*\*: Hugging Face 접근이 제한된 환경을 위한 리버스 팩시 설정
### Example 1:
`https://github.com/ltdrdata/ComfyUI-Impact-Pack`을 `https://mirror.ghproxy.com/https://github.com/ltdrdata/ComfyUI-Impact-Pack`으로 리디렉션
```
GITHUB\_ENDPOINT=https://mirror.ghproxy.com/https://github.com
```
#### Example 2:
`https://huggingface.co/path/to/somewhere`를 `https://some-hf-mirror.com/path/to/somewhere`로 변경
```
HF\_ENDPOINT=https://some-hf-mirror.com
```
## Scanner
`scan.sh` 스크립트를 실행할 때:
\* `extension-node-map.json`을 업데이트합니다.
\* 이를 위해 `custom-node-list.json`에 나열된 커스텀 노드들을 `~/.tmp/default`로 pull하거나 clone합니다.
\* 이 단계를 건너뛰려면 `--skip-update` 옵션을 추가하세요.
\* `~/.tmp/default` 대신 다른 경로를 지정하려면, `scan.sh` 대신 `python scanner.py [path]`를 직접 실행하세요.
\* `github-stats.json`을 업데이트합니다.
\* 이는 GitHub API를 사용하므로, 속도 제한에 빠르게 도달하여 오작동하는 것을 방지하려면 `export GITHUB\_TOKEN=your\_token\_here`로 토큰을 설정하세요.
\* 이 단계를 건너뛰려면 `--skip-stat-update` 옵션을 추가하세요.
\* `--skip-all` 옵션은 `--skip-update`와 `--skip-stat-update` 모두에 적용됩니다.
## Troubleshooting
\* 시스템 git 외의 특정 위치에 `git.exe`가 설치되어 있는 경우, ComfyUI-Manager를 설치하고 ComfyUI를 실행하세요. 그런 다음 생성된 `/default/ComfyUI-Manager/config.ini` 파일의 `git\_exe = `에 파일 이름을 포함한 경로를 지정하세요.
\* ComfyUI-Manager 자체 업데이트가 실패하는 경우, \*\*ComfyUI-Manager\*\* 디렉토리로 이동하여 `git update-ref refs/remotes/origin/main a361cc1 && git fetch --all && git pull` 명령어를 실행하세요.
\* Windows 환경에서 `Overlapped Object has pending operation at deallocation on ComfyUI Manager load` 오류 메시지가 발생하는 경우
\* `config.ini` 파일 편집: `windows\_selector\_event\_loop\_policy = True` 추가
\* `SSL: CERTIFICATE\_VERIFY\_FAILED` 오류가 발생하는 경우.
\* `config.ini` 파일 편집: `bypass\_ssl = True` 추가
##

Security policy (보안 정책)
\* `config.ini` 파일 편집: `security\_level = ` 추가
\* `strong`
\* `high` 및 `middle` 등급의 위험한 기능을 허용하지 않음
\* `normal`
\* `high` 등급의 위험한 기능을 허용하지 않음
\* `middle` 등급의 위험한 기능은 사용 가능
\* `normal-`
\* `--listen`이 지정되어 있고 `127.`로 시작하지 않는 경우 `high` 등급의 위험한 기능을 허용하지 않음
\* `middle` 등급의 위험한 기능은 사용 가능
\* `weak`
\* 모든 기능 사용 가능
\* `high` 등급의 위험한 기능
\* `.safetensors` 형식이 아니거나 `default channel` 모델 목록에 등록되지 않은 모델 다운로드
\* 참고: `Install via git url`, `pip install` 및 `default channel`에 등록되지 않은 커스텀 노드의 설치는 **더 이상 `security\_level`의 통제를 받지 않으며** — 아래에 설명된 전용 설치 플래그의 통제를 받습니다.
\* `middle` 등급의 위험한 기능
\* 제거/업데이트
\* `default channel`에 등록된 커스텀 노드 설치
\* 커스텀 노드 수정
\* 스냅샷 복원/제거
\* 재시작
\* `low` 등급의 위험한 기능
\* ComfyUI 업데이트
### 전용 설치 플래그: `allow\_git\_url\_install` / `allow\_pip\_install`
두 가지 임의 설치 영역은 `security\_level`과 완전히 **분리되어(decoupled)** `config.ini` (`[default]` 섹션)의 전용 부울 키로 제어됩니다:
\* `allow\_git\_url\_install`
\* `Install via Git URL` (`POST /customnode/install/git\_url`) **및** 일괄 설치 대기열의 알 수 없는 git URL 경로(`POST /manager/queue/install`, 재설치 위임 포함)를 제어합니다. 즉, `default channel` 카탈로그에 등록되지 않은 git URL에서 커스텀 노드를 설치하는 경우를 의미합니다.
\* **배치 대기열 경로**에서 이 플래그는 **필요조건이지만 충분조건은 아닙니다**: 대기열의 일반적인 `security\_level` 진입 관문(`middle`)도 통과해야 합니다. `security\_level = strong`인 경우, 플래그가 `true`로 설정되어 있더라도 배치 알 수 없는 URL 설치는 여전히 거부됩니다 (직접 `Install via Git URL` 엔드포인트만 `security\_level`과 완전히 독립적입니다).
\* 팩의 전이적 종속성 pip 설치를 포함하여, 시작된 **전체 설치 트랜잭션**을 다룹니다.
\* `allow\_pip\_install`
\* 독립형 `pip install` 기능(`POST /customnode/install/pip`)**만** 제어합니다.
주요 속성:
\* **`security\_level`과 분리됨 (교체가 아닌 독립)** — 두 개의 **직접 엔드포인트**(`Install via Git URL` 및 `pip install`)에서 `security\_level`은 더 이상 양방향으로 어떠한 영향도 미치지 않습니다. 플래그가 `true`일 때 엄격한 레벨이 이를 거부할 수 없으며, 플래그가 `false`일 때 약한 레벨이 이를 허용할 수 없습니다. (배치 대기열 경로는 플래그 외에도 `security\_level` 진입 관문을 유지합니다 — 위의 범위 글머리 기호 참고.) 다른 모든 제어된 기능은 위에서 설명한 대로 `security\_level`에 의해 계속 제어됩니다.
\* **루프백 전용** — 이 플래그는 서버가 루프백 주소(예: `--listen 127.0.0.1`)에서 수신 대기할 때만 **적용됩니다**. 비루프백 리스너에서는 플래그와 관계없이 이러한 영역이 계속 거부되며, 플래그가 공개 배포의 노출 범위를 넓히지 않습니다.
\* **기본 거부 / 명시적 동의(opt-in)** — 두 플래그 모두 기본값은 `false`입니다. 대소문자를 구분하지 않는 문자열 `true`만 플래그를 활성화하며, 누락되었거나 잘못된 형식의 키는 `false`로 읽힙니다.
동의하려면 `config.ini`를 편집하세요:
```ini
[default]
allow\_git\_url\_install = true
allow\_pip\_install = true
```
변경 사항은 **재시작** 후 적용됩니다 (핫 리로드 없음).
> **마이그레이션 참고**: `security\_level`에서 자동으로 마이그레이션되지 않습니다.
> 이전 버전에서 git URL을 통한 설치/pip 설치를 사용하기 위해 `security\_level = weak`(또는 `normal-`)에 의존했다면, 위의 플래그로 명시적으로 동의(opt-in)해야 합니다. 구형 ComfyUI 배포판에 대한 동작 노트를 포함하여 자세한 내용은 `CHANGELOG.md`를 참고하세요.
# 면책 조항
\* 이 확장 프로그램은 단순히 커스텀 노드 설치의 편의성을 제공할 뿐이며 정상적인 작동을 보장하지 않습니다.
## 크레딧
ComfyUI/[ComfyUI](https://github.com/comfyanonymous/ComfyUI) - 강력하고 모듈화된 스테이블 디퓨전 GUI.
\*\*그리고, 모든 ComfyUI cu

stom node developers\*\*

ComfyUI-Manager

ComfyUI-Manager 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

ComfyUI-Manager

ComfyUI-Manager 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README