koriweb
a3f63e56e2
- 10_Wiki/Comfyui/: ComfyUI docs generated via /wikify - 00_Raw/_youtube/: /youtube extraction outputs - Move some 00_Raw originals into 10_Wiki/Topics_meeting; remove empty canvases and stray files Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
71 lines
3.9 KiB
Markdown
71 lines
3.9 KiB
Markdown
---
|
|
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 본문에서 초안 생성. |