ComfyUI 커스텀 노드 안전 설치 및 관리 가이드

ComfyUI Manager 및 수동 Git 클론을 이용한 커스텀 노드 안전 설치법. 패키지 의존성 오염 및 시작 불가 에러 예방 가이드.

테스트 환경

운영체제: Windows 10 / 11
실행기: Wonderful Launcher v1.x
ComfyUI: 포터블 버전 / 관리형 설치
Python: 3.11+
CUDA / Torch: CUDA 12.x / Torch 2.x
마지막 테스트일: 2026-05-19

ComfyUI 환경에 새로운 기능(얼굴 세밀 보정, 동영상 생성, 고배율 업스케일러 등)을 덧붙이기 위해 커스텀 노드 플러그인을 깔고자 하는 경우 아래 안전 가이드를 참고하십시오.

커스텀 노드는 훌륭한 기능 확장 통로이지만, 동시에 잘 돌아가던 가상환경을 오염시키는 주범이기도 합니다. 각 플러그인들은 저마다 요구하는 Python 라이브러리가 달라, 무작정 인스톨을 누르다 보면 기존 PyTorch 가속 드라이버 등이 구버전이나 CPU 전용 버전으로 강제 강하되어 꼬이기 쉽습니다.

이미 환경이 깨진 경우

노드 설치 후 서버가 켜지지 않거나 에러 창이 뜬다면 본 페이지 대신 설치 커스텀 노드 후 ComfyUI 훼손? 페이지를 참고하여 복구하십시오.

설치 핵심 규칙 요약

작업 목표	추천하는 가장 안전한 단계
일반적인 대중적 노드 설치	WebUI 화면 우측 하단의 ComfyUI Manager 메뉴 사용
GitHub 주소를 통한 수동 클론	`ComfyUI/custom_nodes/`에 클론한 뒤, 정확한 Python 실행 경로를 지정하여 개별 패키지 설치
워크플로 배치 시 발생하는 붉은색 노드 복구	Manager 메뉴의 「Install Missing Custom Nodes」(누락 노드 설치) 활용 후 재시작
핵심 패키지 오염 예방	`requirements.txt` 내역을 열어 Torch, NumPy가 강제 덮어쓰기 목록에 박혔는지 확인

커스텀 노드 설치 방법

방법 1: ComfyUI Manager 사용 (가장 권장)

최신 ComfyUI 빌드 및 ComfyUI Desktop 에디션에는 매니저 레이어가 기본 적재되어 제공됩니다.

ComfyUI Desktop 사용 시: 서버 실행 후 브라우저 화면의 툴바 사이드바에서 Manager 단추를 누르면 바로 활성화됩니다.

포터블 에디션 사용 시: 포터블 루트 폴더에서 매니저 의존성 패키지를 1회 적재한 다음 실행 옵션을 추가하여 구동합니다.

.\python_embeded\python.exe -m pip install -r .\ComfyUI\manager_requirements.txt
.\python_embeded\python.exe -s .\ComfyUI\main.py --windows-standalone-build --enable-manager

수동 가상환경(venv) 사용 시: 활성 가상환경 셸 내에서 실행합니다.

python -m pip install -r manager_requirements.txt
python main.py --enable-manager

방법 2: 수동 Git clone 설치

본인 PC의 ComfyUI/custom_nodes/ 경로로 이동합니다.
터미널 혹은 명령 프롬프트를 켜고 원하는 리포지토리를 복제합니다.

cd ComfyUI/custom_nodes
git clone https://github.com/[개발자명]/[노드명].git

설치하려는 노드 폴더 내에 requirements.txt가 존재한다면, ComfyUI 구동 파이썬 환경 경로를 정확히 거치도록 지정 설치합니다.

가상 환경 형태	안전한 의존성 설치 명령어 형태
공식 Windows 포터블 버전	포터블 루트 폴더에서: `.\python_embeded\python.exe -s -m pip install -r .\ComfyUI\custom_nodes\[노드명]\requirements.txt`
수동 venv 가상환경	가상환경 활성화 상태에서: `python -m pip install -r custom_nodes/[노드명]/requirements.txt`

설치가 끝나면 ComfyUI 서버를 완전히 껐다 다시 켭니다.

요구 패키지 맹신 금지

가장 위험한 단계는 pip install -r requirements.txt입니다. 실행 전 텍스트 메모장으로 해당 파일을 열어 torch, numpy, opencv-python, pillow 등 런타임 핵심 패키지들이 버전을 고정해 덮어쓰려고 선언했는지 반드시 보십시오.

방법 3: 단일 파이썬 파일 적재

의존성 복제 과정이 없는 단순 보조용 단일 파이썬 스크립트(.py 파일)는 아래와 같이 폴더 바로 밑에 집어넣는 것만으로 정상 불러와집니다.

ComfyUI/
+-- custom_nodes/
    +-- my_node.py

배치 후 ComfyUI 서버를 구동하십시오.

빈번하게 활용되는 핵심 노드팩 안내

노드팩 이름	특징 및 활용군
ComfyUI-Manager	WebUI 화면에서 편리하게 타 플러그인을 다운로드/업데이트할 수 있는 필수 도구
ComfyUI-GGUF	FLUX 등의 고용량 모델을 저사양 VRAM에서 띄울 때 필요한 양자화 모델 로더
ComfyUI-Impact-Pack	얼굴 자동 감지, 크롭 보정(Detailer), 이미지 인페인팅 마스킹 보조
ComfyUI-AnimateDiff	이미지를 비디오 움짤 파일로 렌더링하는 애니메이션 가속 툴
ComfyUI-IPAdapter	텍스트 프롬프트 대신 이미지 스타일(레퍼런스 이미지)을 전사하는 기법
ComfyUI-ControlNet	자세 포즈, 스케치 선화, 깊이 맵 등 다양한 조건 제어 노드
ComfyUI-VideoHelperSuite	비디오 영상 파일 입출력, 프레임 디코딩 보조

설치 핵심 규칙 요약

작업 목표	추천하는 가장 안전한 단계
일반적인 대중적 노드 설치	WebUI 화면 우측 하단의 ComfyUI Manager 메뉴 사용
GitHub 주소를 통한 수동 클론	`ComfyUI/custom_nodes/`에 클론한 뒤, 정확한 Python 실행 경로를 지정하여 개별 패키지 설치
워크플로 배치 시 발생하는 붉은색 노드 복구	Manager 메뉴의 「Install Missing Custom Nodes」(누락 노드 설치) 활용 후 재시작
핵심 패키지 오염 예방	`requirements.txt` 내역을 열어 Torch, NumPy가 강제 덮어쓰기 목록에 박혔는지 확인

커스텀 노드 설치 방법

방법 1: ComfyUI Manager 사용 (가장 권장)

최신 ComfyUI 빌드 및 ComfyUI Desktop 에디션에는 매니저 레이어가 기본 적재되어 제공됩니다.

ComfyUI Desktop 사용 시: 서버 실행 후 브라우저 화면의 툴바 사이드바에서 Manager 단추를 누르면 바로 활성화됩니다.

포터블 에디션 사용 시: 포터블 루트 폴더에서 매니저 의존성 패키지를 1회 적재한 다음 실행 옵션을 추가하여 구동합니다.

.\python_embeded\python.exe -m pip install -r .\ComfyUI\manager_requirements.txt
.\python_embeded\python.exe -s .\ComfyUI\main.py --windows-standalone-build --enable-manager

수동 가상환경(venv) 사용 시: 활성 가상환경 셸 내에서 실행합니다.

python -m pip install -r manager_requirements.txt
python main.py --enable-manager

방법 2: 수동 Git clone 설치

본인 PC의 ComfyUI/custom_nodes/ 경로로 이동합니다.
터미널 혹은 명령 프롬프트를 켜고 원하는 리포지토리를 복제합니다.

cd ComfyUI/custom_nodes
git clone https://github.com/[개발자명]/[노드명].git

설치하려는 노드 폴더 내에 requirements.txt가 존재한다면, ComfyUI 구동 파이썬 환경 경로를 정확히 거치도록 지정 설치합니다.

가상 환경 형태	안전한 의존성 설치 명령어 형태
공식 Windows 포터블 버전	포터블 루트 폴더에서: `.\python_embeded\python.exe -s -m pip install -r .\ComfyUI\custom_nodes\[노드명]\requirements.txt`
수동 venv 가상환경	가상환경 활성화 상태에서: `python -m pip install -r custom_nodes/[노드명]/requirements.txt`

설치가 끝나면 ComfyUI 서버를 완전히 껐다 다시 켭니다.

요구 패키지 맹신 금지

방법 3: 단일 파이썬 파일 적재

의존성 복제 과정이 없는 단순 보조용 단일 파이썬 스크립트(.py 파일)는 아래와 같이 폴더 바로 밑에 집어넣는 것만으로 정상 불러와집니다.

ComfyUI/
+-- custom_nodes/
    +-- my_node.py

배치 후 ComfyUI 서버를 구동하십시오.

빈번하게 활용되는 핵심 노드팩 안내

노드팩 이름	특징 및 활용군
ComfyUI-Manager	WebUI 화면에서 편리하게 타 플러그인을 다운로드/업데이트할 수 있는 필수 도구
ComfyUI-GGUF	FLUX 등의 고용량 모델을 저사양 VRAM에서 띄울 때 필요한 양자화 모델 로더
ComfyUI-Impact-Pack	얼굴 자동 감지, 크롭 보정(Detailer), 이미지 인페인팅 마스킹 보조
ComfyUI-AnimateDiff	이미지를 비디오 움짤 파일로 렌더링하는 애니메이션 가속 툴
ComfyUI-IPAdapter	텍스트 프롬프트 대신 이미지 스타일(레퍼런스 이미지)을 전사하는 기법
ComfyUI-ControlNet	자세 포즈, 스케치 선화, 깊이 맵 등 다양한 조건 제어 노드
ComfyUI-VideoHelperSuite	비디오 영상 파일 입출력, 프레임 디코딩 보조

ComfyUI 커스텀 노드 안전 설치 및 관리 가이드

설치 핵심 규칙 요약

커스텀 노드 설치 방법

방법 1: ComfyUI Manager 사용 (가장 권장)

방법 2: 수동 Git clone 설치

방법 3: 단일 파이썬 파일 적재

빈번하게 활용되는 핵심 노드팩 안내

관련 가이드

목차

ComfyUI 커스텀 노드 안전 설치 및 관리 가이드

설치 핵심 규칙 요약

커스텀 노드 설치 방법

방법 1: ComfyUI Manager 사용 (가장 권장)

방법 2: 수동 Git clone 설치

방법 3: 단일 파이썬 파일 적재

빈번하게 활용되는 핵심 노드팩 안내

관련 가이드

목차