ComfyUI 모델 폴더 내 Safetensors 파일 배치 및 분류 가이드
ComfyUI에서 safetensors 모델 파일의 정확한 배치 폴더 위치 확인: checkpoints, LoRA, VAE, ControlNet, Flux 확산 모델 및 텍스트 인코더 구성.
테스트 환경
- 운영체제: Windows 10 / 11
- 실행기: Wonderful Launcher v1.x
- ComfyUI: 포터블 버전 / 관리형 설치
- Python: 3.11+
- CUDA / Torch: CUDA 12.x / Torch 2.x
- 마지막 테스트일: 2026-05-19
ComfyUI에서 모델 파일을 다운로드받은 뒤 safetensors 파일을 어디에 저장해야 하나요? 또는 **comfyui 모델 폴더 위치**를 검색하고 계시다면 다음 수칙을 기억해 주십시오. 모든 학습 파일들은 공통적으로 ComfyUI/models/ 하위 영역에 모이지만, 확장자(.safetensors)로 퉁쳐서 배치하는 것이 아니라 각 모델의 고유 역할(종류)별로 하위 폴더를 정확하게 분리해야만 컴파일 인식이 성공합니다.
초보자들이 저지르는 대표적인 실수는 "확장자가 .safetensors로 끝나니까 무작정 models/checkpoints/ 폴더에 몰아넣는다"는 점입니다. LoRA, VAE, Flux 확산 모델, CLIP 텍스트 인코더 또한 동일하게 .safetensors 포맷으로 제공되는 경우가 대부분이지만, 배치되어야 할 실제 물리 폴더 위치는 각각 다릅니다.
기본적으로 모든 모델은 아래 경로 아래에 체계적으로 적재됩니다.
ComfyUI/models/만약 엉뚱한 폴더에 파일을 집어넣는 경우, 서버 기동 자체는 오류 없이 완료되나 웹 UI 화면상의 모델 선택 상자(Dropdown)가 비어 있거나 워크플로 렌더링 과정에서 리소스 인식 불가 예외를 뱉게 됩니다.
모델 종류별 배치 가이드 테이블
| 모델의 실제 역할 | 정확히 보관할 하위 경로 | 주로 연계되는 로딩 노드 |
|---|---|---|
| Checkpoint (베이스 모델 덩어리) | ComfyUI/models/checkpoints/ | Load Checkpoint |
| LoRA | ComfyUI/models/loras/ | Load LoRA |
| VAE (색상 복원 필터) | ComfyUI/models/vae/ | Load VAE |
| ControlNet (뼈대 제어 스택) | ComfyUI/models/controlnet/ | Load ControlNet Model |
| Embedding (Textual Inversion) | ComfyUI/models/embeddings/ | 긍정 프롬프트 텍스트 내에서 명칭 직접 기입 |
| CLIP / 텍스트 인코더 | ComfyUI/models/text_encoders/ 또는 models/clip/ | CLIP 로더 또는 T5 텍스트 입력 노드 |
| Flux 확산 모델 / UNet 단체 | ComfyUI/models/diffusion_models/ 또는 models/unet/ | UNetLoader / 확산 모델 로더 |
| 업스케일러 (초해상도 가속 필터) | ComfyUI/models/upscale_models/ | Upscale Model Loader |
학습 파일을 이동한 다음에는 반드시 ComfyUI 서버창을 껐다 켜거나 웹 UI 드롭다운 상자 바로 옆에 달린 「Refresh」(새로고침) 버튼을 눌러 디렉토리를 다시 스캔해야 목록에 잡힙니다.
흔히 접하는 실물 파일명 배치 예시
| 학습 파일명 형태 | 집어넣어야 할 정확한 하위 폴더 | 상세 원인 분석 |
|---|---|---|
sd_xl_base_1.0.safetensors, realvisxl.safetensors | models/checkpoints/ | 기본이 되는 메인 체크포인트 파일입니다. |
Flux 워크플로용 ae.safetensors | models/vae/ | 오토인코더(VAE) 필터 성격의 리소스입니다. |
clip_l.safetensors | models/clip/ 또는 models/text_encoders/ | CLIP 가중치 단독 파일로 체크포인트가 아닙니다. |
t5xxl_fp16.safetensors, t5xxl_fp8.safetensors | models/text_encoders/ | Flux 생성 시 요구되는 텍스트 인코더용 대용량 가중치입니다. |
umt5_xxl_fp8_e4m3fn_scaled.safetensors | models/text_encoders/ | 신세대 Flux 모델에서 사용되는 텍스트 인코더입니다. |
| 양자화된 Flux 확산 모델(Q8 혹은 FP8 에디션) | models/diffusion_models/ 또는 models/unet/ | 양자화 디퓨전 트랜스포머 레이어로 체크포인트 로더로는 로드되지 않습니다. |
4x_*.safetensors 혹은 ESRGAN 등의 업스케일 가속기 | models/upscale_models/ | 해상도 향상 로더 노드에서 직접 조율됩니다. |
긴급 장애 자가 진단
Q: 파일은 올바른 폴더에 잘 넣었는데 드롭다운 상자에 아예 표기되지 않습니다.
- 체크 1: 실제 편집을 진행한 폴더가 현재 구동 중인 ComfyUI의 폴더가 맞는지 윈도우 파일 경로를 더블체크하십시오 (다른 백업 복사본 폴더에 복사했을 확률이 높습니다).
- 체크 2: 파일 이동 중 윈도우 복사 프로세스가 끊어졌거나, 다운로드가 불완전하게 완료되어 파일 바이트 크기가 깨져 있을 수 있습니다.
- 체크 3: 파일 적재 후 'Refresh'를 누르지 않았거나 서버 프로세스를 리부팅하지 않았을 수 있습니다.
Q: Flux 모델을 기동하려는데 노드가 동작하지 않습니다.
- Flux 기법은 하나의 체크포인트 안에 모든 성분을 담은 '통합본'이 있는 반면,
diffusion_models(확산 연산),text_encoders(자연어 번역),vae(이미지 복원) 3종류로 쪼개어 배포되는 경우도 흔합니다. 분할본을 받아 넣은 경우 체크포인트 로더가 아닌 개별 맵핑 로더 노드를 캔버스에 따로 끌어 배치하셔야 작동합니다.
관련 가이드
실제 ComfyUI 환경에서 생긴 문제라면 먼저 무료로 Wonderful Launcher 로 현재 머신을 확인하세요. 런처 안의 복구 흐름, 작업 로그, 실행 환경 점검을 한곳에서 볼 수 있습니다. 크레딧은 이미지 생성과 사용량 기반 도구용입니다.
Wonderful Launcher 다운로드크레딧 요금제 보기Did this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.