컴피UI(ComfyUI)로 로컬 이미지 생성하기 (워크플로, 모델 폴더, VRAM)
컴피UI로 로컬 이미지를 생성한다는 것은 모델 파일을 정해진 models 폴더에 받아 두고, 노드를 이은 워크플로 파일을 불러와 내 컴퓨터의 GPU로 이미지를 만드는 일입니다. 모델마다 라이선스와 필요한 메모리가 달라서 받기 전에 두 가지를 먼저 확인합니다.
같은 말:컴피UI 사용법ComfyUI 모델 폴더ComfyUI 워크플로컴피UI VRAMComfyUI Manager
목차
🤔 공유받은 워크플로를 열었더니 빨간 노드만 가득할 때
컴피UI를 설치하고 다른 사람이 공유한 워크플로를 불러오면, 노드 여러 개가 빨갛게 표시되며 실행이 막히는 일이 자주 생깁니다. 대개 그 워크플로가 쓰는 모델 파일이 내 컴퓨터의 맞는 폴더에 없거나, 필요한 커스텀 노드가 설치되지 않은 경우입니다. 모델을 받아 넣어도 이번에는 그래픽 메모리가 부족하다는 오류가 나기도 합니다.
컴피UI가 무엇이고 노드가 어떻게 이어지는지, 설치 방법과 알려진 보안 사고는 1차 코스의 컴피UI 이해하기에서 다뤘습니다. 지금부터는 실제로 이미지를 만들 때 부딪히는 모델 폴더, 모델 받기와 라이선스, 워크플로 파일, 메모리 옵션, 커스텀 노드 보안 설정을 정리합니다. 경로와 옵션은 2026년 9월 28일 공식 문서와 코드 기준입니다.
🔑 컴피UI 로컬 이미지 생성의 정의
컴피UI로 로컬 이미지를 생성한다는 것은 모델 파일을 정해진 models 폴더에 받아 두고, 노드를 이은 워크플로 파일을 불러와 내 컴퓨터의 GPU로 이미지를 만드는 일입니다.
그래서 실무에서 챙길 것은 세 가지로 좁혀집니다. 모델 파일이 맞는 폴더에 있는지, 그 모델을 써도 되는 조건인지, 내 기기의 메모리로 돌아가는지입니다.
📁 모델 종류별 폴더 구조
컴피UI는 모델 종류마다 ComfyUI/models/ 아래 폴더를 따로 씁니다. 워크플로의 모델 불러오기 노드는 자기 종류의 폴더에 있는 파일만 목록에 보여 주므로, 파일을 엉뚱한 폴더에 넣으면 목록에 나오지 않습니다.
| 폴더 | 넣는 파일 |
|---|---|
checkpoints | 모델 전체가 한 파일로 묶인 체크포인트 |
diffusion_models | 이미지를 만드는 본체만 따로 나뉜 파일 (예전 이름 unet도 인식) |
text_encoders | 프롬프트를 읽는 텍스트 인코더 (예전 이름 clip도 인식) |
vae | 이미지와 잠재 공간을 오가는 변환 모델 |
loras | 화풍이나 인물을 더하는 LoRA 파일 |
controlnet, upscale_models | 구도 제어, 해상도 높이기 모델 |
최신 모델일수록 한 파일짜리 체크포인트 대신 본체, 텍스트 인코더, VAE를 따로 받는 경우가 많습니다. 워크플로 설명에 적힌 파일 이름을 각각 맞는 폴더에 넣어야 합니다. 커스텀 노드가 쓰는 모델은 경로가 다를 수 있어서 공식 문서는 각 노드의 설명서를 따르라고 안내합니다. 커스텀 노드 자체는 models 밖의 custom_nodes 폴더에 들어갑니다.
다른 프로그램과 모델 파일을 함께 쓰고 싶다면 설치 폴더의 extra_model_paths.yaml.example을 복사해 extra_model_paths.yaml로 이름을 바꾸고 경로를 적습니다. 맥의 데스크톱 앱은 공유 모델 폴더로 ~/ComfyUI-Shared를 쓰고, 앱의 설정 메뉴에서 저장 위치를 바꿀 수 있습니다.
📥 모델 받을 때 확인할 것
공식 문서는 모델을 허깅페이스, Civitai, 각 프로젝트의 깃허브에서 받아 models 폴더에 넣으라고 안내합니다. 받기 전에 두 가지를 봅니다.
- 파일 형식:
.safetensors파일을 고릅니다. 예전 형식인 pickle(.ckpt,.pt) 파일은 불러올 때 임의의 코드가 실행될 수 있다고 허깅페이스 보안 문서가 경고합니다 - 라이선스: 모델마다 상업 이용 조건이 다릅니다
라이선스의 좋은 예가 2026년 9월 20일 공개된 Qwen-Image-2.1입니다. 허깅페이스의 LICENSE 파일은 이 모델을 "연구나 평가 목적으로만" 쓰는 비상업 라이선스로 정하고, 상업 이용은 별도 라이선스를 요청하라고 적습니다. 모델 출력으로 다른 AI 모델을 학습시켜 배포하면 "Built with Qwen" 같은 표시를 붙이라는 조건도 있습니다. 같은 큐원의 직전 이미지 모델인 Qwen-Image-2512는 Apache 2.0이라 조건이 다릅니다. 모델 크기도 중요해서 Qwen-Image-2.1은 내려받기만 약 33GB입니다(인사이트 기준). 라이선스 읽는 순서는 오픈 웨이트와 오픈 소스 차이에 정리했습니다.
🧾 워크플로 파일이 저장되는 방식
컴피UI는 워크플로를 JSON 파일로 저장하고 불러옵니다. 생성한 이미지에도 워크플로가 들어가서, 원본 PNG를 화면에 끌어다 놓으면 시드까지 그대로 복원됩니다. 공식 문서 기준으로 파일 안에는 두 가지가 저장됩니다.
workflow: 화면의 노드 배치까지 담은 전체 그래프prompt: 실제 실행에 쓰는 API 형식
저장 위치는 PNG는 이미지의 텍스트 영역(tEXt 청크), WebP 움직이는 이미지는 EXIF, 영상은 컨테이너 메타데이터입니다. 공식 문서는 다른 애플리케이션이 파일을 다시 인코딩하면 메타데이터가 사라질 수 있다고 적습니다. 메신저나 SNS에 올렸다가 받은 이미지로는 워크플로가 열리지 않는 이유입니다. 워크플로를 공유할 때는 JSON 파일을 따로 보내는 편이 확실합니다.
반대로 결과물에 내 워크플로가 담기는 것이 싫다면 실행 옵션 --disable-metadata로 저장을 끕니다. 고객에게 결과 이미지를 보낼 때 내부 프롬프트가 함께 넘어가지 않게 할 때 씁니다.
🧠 그래픽 메모리가 부족할 때
컴피UI 공식 README는 비동기 가중치 스트리밍 기술 덕분에 VRAM 4GB와 RAM 8GB로도 큰 오픈 모델을 비교적 빠르게 돌릴 수 있다고 적습니다. 모델 가중치를 한꺼번에 올리지 않고 필요한 만큼 나눠 옮기는 방식입니다. 그래서 예전 글에서 첫 해법으로 소개하던 옵션의 의미가 달라졌습니다.
| 옵션 | 지금 공식 코드의 설명 |
|---|---|
--lowvram | 동적 VRAM이 켜져 있으면 아무 효과가 없고, 꺼져 있을 때 텍스트 인코더를 CPU에서 돌림 |
--novram | --lowvram으로도 부족할 때 |
--reserve-vram | 다른 프로그램을 위해 비워 둘 VRAM(GB) |
--cpu | 모든 연산을 CPU로 (매우 느림) |
--fp8_e4m3fn-unet | 본체 가중치를 fp8로 저장해 메모리를 줄임 |
메모리 오류가 나면 옵션부터 바꾸기보다 모델 파일 자체를 더 작은 양자화판(fp8, GGUF 등)으로 받는 편이 효과가 큰 경우가 많습니다. 해상도와 한 번에 만드는 장수를 줄이는 것도 메모리를 줄입니다. 기기별 메모리 개념은 로컬 AI 하드웨어 기초에서 다뤘습니다.
맥에서는 MLX가 아니라 PyTorch의 MPS 백엔드로 돌아갑니다. 데스크톱 앱은 macOS 13 이상의 애플 실리콘(M1 이상)을 지원하고, 설치본 하나에 4.85GB 이상의 공간을 권합니다.
🔐 매니저 보안 등급과 커스텀 노드
빨간 노드를 해결하려고 커스텀 노드를 설치할 때 쓰는 것이 ComfyUI-Manager입니다. 지금은 코어에 통합되어 --enable-manager 옵션으로 켭니다. 매니저 설정 파일(config.ini)의 security_level로 위험한 기능을 막을 수 있습니다.
- 보안 등급:
strong,normal,normal-,weak네 가지입니다 normal-의 동작: 컴피UI를127.로 시작하지 않는 주소에 열면 깃 주소로 설치, pip 설치, 기본 목록 밖 노드 설치 같은 고위험 기능을 막습니다- 알려진 취약점: 매니저 3.38 이전 판에는 원격 공격자가 설정과 중요한 데이터를 조작할 수 있는 취약점(CVE-2025-67303, 위험도 7.5)이 있었습니다
공식 문서는 커스텀 노드를 신뢰할 수 있는 작성자의 널리 쓰이는 것만 설치하라고 권합니다. 설치 후 문제가 생기면 --disable-all-custom-nodes로 모든 커스텀 노드를 끄고 원인을 가립니다.
⚠️ 자주 하는 실수
- 본체 모델을
checkpoints에 넣습니다: 본체만 있는 파일은diffusion_models에 넣어야 불러오기 노드 목록에 나옵니다 - 메신저로 받은 이미지로 워크플로를 공유합니다: 메타데이터가 빠질 수 있으니 JSON 파일을 따로 보냅니다
- 라이선스를 확인하지 않고 업무에 씁니다: 연구 전용 모델로 만든 이미지를 상업적으로 쓰면 조건 위반이 됩니다
- 컴피UI를
--listen으로 열고 매니저 보안을 낮춥니다: 같은 망의 누구나 노드를 설치할 수 있게 됩니다
❓ 자주 묻는 질문
모델 파일을 지우려면 어떻게 하나요?
공식 문서 기준으로 화면에 삭제 버튼이 없어서 models 폴더에서 파일을 직접 지웁니다. 큰 모델 파일은 수십 GB라서 쓰지 않는 것은 정리하고, 다시 받을 수 있는 파일은 백업 대상에서 빼는 편이 좋습니다.
맥에서도 큰 이미지 모델이 돌아가나요?
돌아가긴 하지만 같은 크기의 모델이라도 엔비디아 GPU보다 느린 경우가 많습니다. 통합 메모리가 넉넉하면 큰 모델을 올릴 수는 있으므로, 작은 해상도로 한 장 만들어 걸리는 시간을 보고 판단합니다.
공개 서버에 컴피UI를 열어도 되나요?
컴피UI의 기본 주소는 127.0.0.1이고, 공식 README에서 로그인 기능은 찾지 못했습니다. 다른 기기에서 쓰려면 인터넷에 직접 열지 말고 내 기기끼리 묶인 망 안에서만 여는 편이 안전합니다. 방법은 로컬 AI 보안과 백업에 정리했습니다.
📋 3줄 요약
-
컴피UI는 모델 종류마다 ComfyUI/models 아래 checkpoints와 diffusion_models, text_encoders와 vae 같은 폴더를 따로 쓰고 워크플로의 로더 노드는 해당 폴더의 파일만 목록에 보여 줍니다.
-
생성한 PNG에는 워크플로와 실행용 JSON이 함께 저장되어 끌어다 놓으면 시드까지 복원되지만, 다른 앱이 다시 인코딩한 파일은 메타데이터가 빠질 수 있습니다.
-
Qwen-Image-2.1은 연구와 평가 목적으로만 쓸 수 있는 라이선스라서, 모델을 받기 전에 허깅페이스의 LICENSE 파일에서 상업 이용 조건을 먼저 확인합니다.
제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
메신저로 받은 컴피UI 결과 PNG를 끌어다 놓았는데 워크플로가 열리지 않습니다. 공식 문서 기준으로 가장 그럴듯한 이유는 무엇일까요?
