> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 서버 개요

> ComfyUI를 서버로 실행하고 REST 및 WebSocket API를 통해 프로그래매틱하게 상호 작용합니다.

ComfyUI는 기본적으로 사용자의 컴퓨터에서 HTTP 서버로 실행됩니다. 브라우저를 열지 않고도 워크플로우 제출, 파일 업로드, 결과 다운로드, 진행 상황 모니터링을 프로그래매틱하게 수행할 수 있습니다.

## 서버 시작하기

ComfyUI를 실행하면 자동으로 `http://127.0.0.1:8188`에서 HTTP 서버가 시작됩니다.

헤드리스 서버(브라우저 없이)로 ComfyUI를 실행하려면:

<CodeGroup>
  ```bash theme={null}
  # Run without opening the browser
  python main.py --disable-auto-launch
  ```

  ```bash theme={null}
  # Specify a custom port
  python main.py --port 8288
  ```

  ```bash theme={null}
  # Listen on all network interfaces (for remote access)
  python main.py --listen 0.0.0.0
  ```
</CodeGroup>

<Tip>
  시작 플래그 전체 목록을 보려면 `python main.py --help`를 실행하거나 [시작 플래그 참조](/ko/development/comfyui-server/startup-flags)를 확인하세요.
</Tip>

## 이 섹션의 주요 페이지

<CardGroup cols={2}>
  <Card title="시작 플래그" icon="terminal" href="/ko/development/comfyui-server/startup-flags">
    main.py 명령줄 인수에 대한 완전한 참조입니다.
  </Card>

  <Card title="API 라우트" icon="route" href="/ko/development/comfyui-server/comms_routes">
    워크플로우 제출, 파일 업로드, 상태 조회를 위한 HTTP 엔드포인트입니다.
  </Card>

  <Card title="API 예제" icon="code" href="/ko/development/comfyui-server/api-examples">
    API 호출 코드 예제: HTTP 전용, WebSocket + History, SaveImageWebsocket.
  </Card>

  <Card title="서버 메시지" icon="comments" href="/ko/development/comfyui-server/comms_messages">
    실행 중에 서버가 클라이언트로 전송하는 WebSocket 메시지 유형입니다.
  </Card>

  <Card title="실행 모델 반전" icon="code-branch" href="/ko/development/comfyui-server/execution_model_inversion_guide">
    고급: 사용자 정의 제어 흐름을 위해 실행을 반전합니다.
  </Card>
</CardGroup>

## 파트너 노드 사용

워크플로우에 유료 파트너 노드가 포함되어 있다면 페이로드에 API 키를 포함할 수 있습니다. 자세한 내용은 [파트너 노드 API 통합](/ko/development/comfyui-server/api-key-integration) 가이드를 참조하세요.

***

## 서버 작동 방식

Comfy 서버는 [aiohttp 프레임워크](https://docs.aiohttp.org/) 위에서 실행되며, 이 프레임워크는 다시 [asyncio](https://pypi.org/project/asyncio/)를 사용합니다.

서버에서 클라이언트로 보내는 메시지는 서버의 `send_sync` 메서드를 통해 소켓 메시지로 전송되며, 이 메서드는 `server.py`에 정의된 `PromptServer` 인스턴스입니다. 이러한 메시지는 `api.js`에 등록된 소켓 이벤트 리스너에 의해 처리됩니다. 자세한 내용은 [메시지](/ko/development/comfyui-server/comms_messages)를 참조하세요.

클라이언트에서 서버로 보내는 메시지는 `api.js`에 정의된 `api.fetchApi()` 메서드를 통해 전송되며, 서버가 정의한 HTTP 라우트에 의해 처리됩니다. 자세한 내용은 [라우트](/ko/development/comfyui-server/comms_routes)를 참조하세요.

<Tip>클라이언트는 요청을 대기열에 넣을 때 전체 워크플로우(위젯 값 및 모든 내용)를 제출합니다. 서버는 요청을 대기열에 보낸 후에 여러분이 수정한 내용은 전혀 수신하지 않습니다. 만약 실행 중에 서버 동작을 변경하고 싶다면 라우트를 사용해야 합니다.</Tip>