---
id: server-overview---comfyui
title: "Server Overview - ComfyUI"
category: "10_Wiki/Topics"
status: "draft"
verification_status: "conceptual"
canonical_id: ""
aliases: []
duplicate_of: ""
source_trust_level: "B"
confidence_score: 0.8
created_at: 2026-05-20
updated_at: 2026-05-20
review_reason: ""
merge_history: []
tags: ["web", "wikify"]
raw_sources: ["https enough://docs.comfy.org/development/comfyui-server/comms_overview"]
applied_in: []
github_commit: ""
---

# [[Server Overview - ComfyUI]]

## 🎯 한 줄 통찰 (One-line insight)
[[ComfyUI]] 서버는 [[aiohttp]]와 [[asyncio]]를 기반으로 하며, 클라이언트와 서버 간의 메시지 송수신 및 [[http]] 라우트를 통해 워크플로우 데이터를 처리하는 구조를 가집니다.

## 🧠 핵심 개념 (Core concepts)
- **서버 프레임워크**: [[aiohttp]] 및 [[asyncio]] 기반의 구동 환경.
- **메시지 통신 (Server to Client)**: `PromptServer` 인스턴스의 `send_sync` 메서드를 통한 소켓 메시지 전달.
- **통신 경로 (Client to Server)**: `api.fetchApi()` 메서드를 통한 [[http]] 라우트 처리.
- **데이터 일관성**: 큐(Queue) 요청 시 전체 워크플로우(위젯 값 포함)를 제출하며, 요청 이후의 변경 사항은 서버에 반영되지 않음.

## 🧩 추출된 패턴 (Extracted patterns)
- **양방향 통신 구조**: 서버에서 클라이언트로의 소켓 메시지 전송과 클라이언트에서 서버로의 HTTP 요청 처리가 분리되어 존재함.
- **상태 고정성**: 클라이언트가 큐에 요청을 제출하는 시점에 워크플로우 데이터가 결정되며, 실행 중 발생하는 수정 사항은 서버에 영향을 미치지 않는 구조적 특성을 보임.

## 📖 세부 내용 (Details)
### [[ComfyUI]] 서버 통신 메커니즘
- **서버 구동 환경**: Comfy 서버는 [[aiohttp]] 프레임워크 위에서 실행되며, 이는 [[asyncio]]를 사용합니다.
- **메시지 전달 (Messages)**:
    - **Server $\rightarrow$ Client**: `server.py`에 정의된 `PromptServer` 인스턴스의 `send_sync` 메서드를 통해 소켓 메시지 형태로 전송됩니다. 이 메시지는 `api.js`에 등록된 소켓 이벤트 리스너에 의해 처리됩니다.
    - **Client $\rightarrow$ Server**: `api.js`에 정의된 `api.fetchApi()` 메서드를 통해 전송되며, 서버에 정의된 [[http]] 라우트에 의해 처리됩니다.
- **워크플로우 제출 및 실행**:
    - 사용자가 요청을 큐(Queue)에 추가할 때 위젯 값을 포함한 전체 워크플로우를 제출합니다.
    - 서버는 큐에 요청을 보낸 이후에 발생하는 변경 사항을 수신하지 않습니다.
    - 실행 중 서버의 동작을 수정하려면 별도의 라우트(Routes)가 필요합니다.

### Documentation Index 정보
- 전체 문서 인덱스는 다음 경로에서 확인할 수 있습니다: `https://docs.comfy.org/llms.txt`

## ⚖️ 모ikan 및 업데이트 (Contradictions & updates)
본문에서 확인되지 않음.

## 🛠️ 적용 사례 (Applied in summary)
본문에서 확인되지 않음.

## ✅ 검증 상태 및 신뢰도
- **상태:** draft
- **검증 단계:** conceptual
- **출처 신뢰도:** B (Primary Source — 웹사이트 본문 직접 추출)
- **중복 검사 결과:** 신규 생성 (New discovery)

## 🔗 관련 문서 링크 (Related document links)
- [[ComfyUI Server]] - 서버의 전반적인 구조와 역할을 설명합니다.
- [[aiohttp]] - 서버가 구동되는 기반 프레임워크입니다.
- [[asyncio]] - 비동기 처리를 위한 핵심 기술 스택입니다.
- [[PromptServer]] - 서버 메시지 전송을 담당하는 클래스입니다.
- [[api.js]] - 클라이언트 측 통신 로직이 구현된 파일입니다.

## 📝 변경 이력 (Change history)
- 2026-05-20: Astra /wikify 로 https://docs.comfy.org/development/comfyui-server/comms_overview 본문에서 초안 생성.