# Caddy 서비스 현황

> 점검: 2026-09-07 19:12 KST
> 실행 중인 Caddy의 관리 API와 저장소 설정을 확인한 시점별 기록입니다. 자동 갱신되는 상태판은 아닙니다.

## 한눈에 보기

Caddy는 현재 4개 도메인에서 HTTPS 요청을 받아 정적 파일을 제공하거나 로컬 서비스로 전달합니다.

| 도메인 | 주요 서비스 | Caddy 뒤의 대상 |
|--------|-------------|------------------|
| [dev.tictechtoeai.com](https://dev.tictechtoeai.com/) | 홈페이지 및 파일 공유 | `homepage/dist`, 포트 8090 |
| [meet.dev.tictechtoeai.com](https://meet.dev.tictechtoeai.com/) | Meet 화상통화 및 LiveKit | 포트 3000, 7880 |
| [api.dev.tictechtoeai.com](https://api.dev.tictechtoeai.com/) | API 프록시 및 법무 문서 | 포트 8081, 8080, `legal/` |
| [overlord.dev.tictechtoeai.com](https://overlord.dev.tictechtoeai.com/) | Operation Overlord | 포트 3001 |

API 도메인의 루트 `/`는 홈페이지가 아니라 404 응답으로 설정되어 있습니다. 아래의 실제 경로로 접근합니다.

## 홈페이지와 파일 공유

도메인: `dev.tictechtoeai.com`, HTTPS 443.

| 요청 경로 | 처리 방식 | 연결 대상 |
|-----------|-----------|-----------|
| `/share/api/*` | 리버스 프록시 | `127.0.0.1:8090` |
| 그 외 경로 | 정적 파일 제공 | `C:/Developments/LivekitDev/homepage/dist` |
| 정적 파일 404 | `/index.html`로 재작성 | 홈페이지의 index.html |

주요 화면: [홈페이지](https://dev.tictechtoeai.com/), [파일 업로드](https://dev.tictechtoeai.com/share), [공개 다운로드](https://dev.tictechtoeai.com/download).

파일 API에는 `/share/api/` 접두사가 유지되어 전달됩니다. 업로드와 다운로드의 권한 처리는 파일 공유 서비스가 담당합니다. 상세 내용은 [파일 공유 가이드](/guides/fileshare/)를 참고합니다.

## Meet와 LiveKit

도메인: `meet.dev.tictechtoeai.com`.

| 외부 포트 | 요청 경로 | 연결 대상 |
|-----------|-----------|-----------|
| HTTPS 443 | `/rtc*`, `/twirp/*` | LiveKit `127.0.0.1:7880` |
| HTTPS 443 | 그 외 경로 | Meet `127.0.0.1:3000` |
| HTTPS 8443 | `/rtc*`, `/twirp/*` | LiveKit `127.0.0.1:7880` |
| HTTPS 8443 | 그 외 경로 | Meet `127.0.0.1:3000` |
| HTTPS/WSS 7443 | 모든 경로 | LiveKit `127.0.0.1:7880` |

- 일반 화상통화 화면: [Meet](https://meet.dev.tictechtoeai.com/)
- 호환 포트 화면: [Meet 8443](https://meet.dev.tictechtoeai.com:8443/)
- LiveKit 시그널링 주소: `wss://meet.dev.tictechtoeai.com:7443`

7443은 화상통화 UI가 아니라 LiveKit 연결용입니다. LiveKit의 미디어 포트는 이 HTTP 프록시 표와 별도로 관리합니다.

현재 활성 설정에는 Flutter `/videocall/*` 전용 정적 파일 경로가 없습니다. 이 주소도 Meet의 기본 프록시로 전달됩니다. 초기 데모 문서의 Flutter 배포 설명과 현재 설정을 구분해야 합니다.

## API와 법무 문서

도메인: `api.dev.tictechtoeai.com`, HTTPS 443.

| 요청 경로 | 연결 대상 | 설명 |
|-----------|-----------|------|
| `/v1/*` | `127.0.0.1:8081` | 설정 주석상 CelloTutor 프록시 |
| `/healthz` | `127.0.0.1:8081` | CelloTutor 헬스 확인 |
| `/api/*` | `127.0.0.1:8080` | 설정 주석상 기존 KHEngine 경로 |
| `/legal/*` | `C:/Developments/LivekitDev/legal` | 접두사를 제거한 뒤 정적 파일 제공 |
| 그 외 경로 | Caddy가 직접 응답 | `404 Not Found` |

법무 문서는 `handle_path`를 사용하므로 `/legal` 접두사가 제거됩니다.

```text
/legal/cellotutor/privacy.html
  -> C:/Developments/LivekitDev/legal/cellotutor/privacy.html
```

[CelloTutor 개인정보처리방침](https://api.dev.tictechtoeai.com/legal/cellotutor/privacy.html)은 홈페이지 빌드 폴더와 분리되어 있습니다.

API 접근 로그: `C:/Developments/LivekitDev/logs/api-proxy.log`.
설정된 로그 회전 크기는 10 MiB, 보존 파일 수는 5개입니다.

## Operation Overlord

[overlord.dev.tictechtoeai.com](https://overlord.dev.tictechtoeai.com/)의 모든 요청은 `127.0.0.1:3001`로 전달됩니다. 설정 주석에는 Vite 개발 서버로 기록되어 있습니다.

## 공통 연결 흐름

```text
외부 사용자
  -> Caddy :80 -> 같은 도메인의 HTTPS로 301 이동
  -> Caddy :443
       +-- dev      -> homepage/dist 또는 :8090
       +-- meet     -> :3000 또는 :7880
       +-- api      -> :8081, :8080 또는 legal/
       +-- overlord -> :3001
  -> Caddy :7443 -> LiveKit :7880
  -> Caddy :8443 -> Meet :3000 또는 LiveKit :7880
```

4개 도메인 모두 HTTP 80 요청을 같은 도메인의 HTTPS로 영구 리다이렉트합니다. TLS는 Caddy가 처리합니다. 홈페이지와 API 도메인에는 nosniff 및 strict-origin-when-cross-origin 헤더 설정이 있습니다.

## 이번 점검 결과

| 점검 대상 | 확인 결과 |
|-----------|-----------|
| Caddy 관리 API `127.0.0.1:2019/config/` | 활성 설정 조회 성공 |
| 활성 HTTP 서버 수신 설정 | 80, 443, 7443, 8443 |
| Windows 서비스 | LivekitDevCaddy, LivekitDevMeet, LivekitDevServer, LivekitDevFileShare 모두 Running |
| Meet `127.0.0.1:3000/` | HTTP 200 |
| Overlord `127.0.0.1:3001/` | HTTP 200 |
| LiveKit `127.0.0.1:7880/` | HTTP 200 |
| CelloTutor `127.0.0.1:8081/healthz` | HTTP 200 |
| FileShare `127.0.0.1:8090/share/api/health` | HTTP 200 |
| 8080의 `/api/*` 기능 | 활성 라우팅만 확인, 업무 API 호출은 미점검 |

위 결과는 이 머신에서 확인한 기록입니다. 외부 인터넷에서의 DNS·방화벽·영상 통화 성공을 보장하는 점검은 아닙니다.

## 설정 파일과 문서 사이트 위치

| 경로 | 역할 |
|------|------|
| `Caddyfile` | 홈페이지, Meet, LiveKit, Overlord 및 API 설정 import |
| `proxyserver/api.dev.tictechtoeai.com.caddy` | API 도메인의 경로별 프록시 및 법무 문서 |
| `homepage/dist/` | Caddy가 제공하는 정적 홈페이지 |
| `legal/` | API 도메인에서 제공하는 법무 문서 |
| `docs-site/` | 현재 읽고 있는 Astro 문서 사이트 |

문서 사이트는 `http://127.0.0.1:4321/`에서 실행되며, 현재 Caddy 활성 설정에는 문서 사이트용 도메인이나 경로가 없습니다.

설정이 바뀌면 이 문서의 원본 `docs-site/public/downloads/caddy-services.md`를 갱신하고 PDF와 Astro 페이지에도 반영합니다. 관련 운영 절차는 [Windows 서비스 가이드](/guides/stack-windows-services/)를 참고합니다.