Caddy 서비스 현황

원본 다운로드: Markdown · PDF

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

한눈에 보기

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

도메인	주요 서비스	Caddy 뒤의 대상
dev.tictechtoeai.com	홈페이지 및 파일 공유	homepage/dist, 포트 8090
meet.dev.tictechtoeai.com	Meet 화상통화 및 LiveKit	포트 3000, 7880
api.dev.tictechtoeai.com	API 프록시 및 법무 문서	포트 8081, 8080, legal/
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

주요 화면: 홈페이지, 파일 업로드, 공개 다운로드.

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

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
• 호환 포트 화면: Meet 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 접두사가 제거됩니다.

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

CelloTutor 개인정보처리방침은 홈페이지 빌드 폴더와 분리되어 있습니다.

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

Operation Overlord

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

공통 연결 흐름

외부 사용자
  -> 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 서비스 가이드를 참고합니다.