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>
3.9 KiB
3.9 KiB
id, title, category, status, verification_status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, created_at, updated_at, review_reason, merge_history, tags, raw_sources, applied_in, github_commit
| id | title | category | status | verification_status | canonical_id | aliases | duplicate_of | source_trust_level | confidence_score | created_at | updated_at | review_reason | merge_history | tags | raw_sources | applied_in | github_commit | |||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| server-overview---comfyui | Server Overview - ComfyUI | 10_Wiki/Topics | draft | conceptual | B | 0.8 | 2026-05-20 | 2026-05-20 |
|
|
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
\rightarrowClient:server.py에 정의된PromptServer인스턴스의send_sync메서드를 통해 소켓 메시지 형태로 전송됩니다. 이 메시지는api.js에 등록된 소켓 이벤트 리스너에 의해 처리됩니다. - Client
\rightarrowServer:api.js에 정의된api.fetchApi()메서드를 통해 전송되며, 서버에 정의된 http 라우트에 의해 처리됩니다.
- Server
- 워크플로우 제출 및 실행:
- 사용자가 요청을 큐(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 본문에서 초안 생성.