Files
2nd/10_Wiki/Comfyui/위키 Server Overview - ComfyUI 2026-05-20.md
T
koriweb a3f63e56e2 Add ComfyUI wikified docs and youtube extracts; tidy raw→Topics
- 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>
2026-05-20 18:41:10 +09:00

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
web
wikify
https enough://docs.comfy.org/development/comfyui-server/comms_overview

Server Overview - ComfyUI

🎯 한 줄 통찰 (One-line insight)

ComfyUI 서버는 aiohttpasyncio를 기반으로 하며, 클라이언트와 서버 간의 메시지 송수신 및 http 라우트를 통해 워크플로우 데이터를 처리하는 구조를 가집니다.

🧠 핵심 개념 (Core concepts)

  • 서버 프레임워크: aiohttpasyncio 기반의 구동 환경.
  • 메시지 통신 (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)
  • ComfyUI Server - 서버의 전반적인 구조와 역할을 설명합니다.
  • aiohttp - 서버가 구동되는 기반 프레임워크입니다.
  • asyncio - 비동기 처리를 위한 핵심 기술 스택입니다.
  • PromptServer - 서버 메시지 전송을 담당하는 클래스입니다.
  • api.js - 클라이언트 측 통신 로직이 구현된 파일입니다.

📝 변경 이력 (Change history)