# LiveKit Meet 연동 가이드

> 작성일: 2026-07-19  
> 예제: https://github.com/livekit-examples/meet  
> 로컬 경로: `meet/`

## 요약

공식 **LiveKit Meet** (Next.js) 를 클론해 이 머신의 LiveKit **1.13.4** 서버와 연동했습니다.

| 구성요소 | 주소 / 설정 |
|----------|-------------|
| Meet UI (로컬) | http://127.0.0.1:3000 |
| Meet UI (외부) | http://125.131.238.28:3000 |
| LiveKit WS | `ws://125.131.238.28:7880` |
| API Key / Secret | `devkey` / `secret` |
| LiveKit nodeIP | `125.131.238.28` (미디어용) |

`http://…:7880/` 에 브라우저로 들어가면 **`OK`만 보이는 것이 정상**입니다. 화상 UI는 **:3000 Meet** 입니다.

## 설정 파일

`meet/.env.local`:

```env
LIVEKIT_API_KEY=devkey
LIVEKIT_API_SECRET=secret
LIVEKIT_URL=ws://125.131.238.28:7880
```

서버 측 토큰 발급: `meet/app/api/connection-details/route.ts`  
→ 클라이언트가 방 입장 시 JWT를 받아 LiveKit에 연결합니다.

## 기동

```powershell
# LiveKit
cd C:\Developments\LivekitDev\livekit
.\bin\livekit-server.exe --config config.yaml --bind 0.0.0.0 --node-ip 125.131.238.28

# Meet
cd C:\Developments\LivekitDev\meet
pnpm install
pnpm dev -- --hostname 0.0.0.0 --port 3000
```

## 사용 방법

1. 브라우저에서 http://127.0.0.1:3000 (또는 외부 IP:3000)
2. 방 이름 입력 (예: `my-room`)
3. 카메라/마이크 허용 후 입장
4. 다른 기기에서도 같은 방 이름으로 접속해 테스트

## 포트 / 방화벽

| 포트 | 용도 |
|------|------|
| TCP 3000 | Meet Next.js |
| TCP 7880 | LiveKit 시그널링 |
| TCP 7881 | RTC TCP |
| UDP 50000–60000 | ICE 미디어 |

Windows 규칙 예: `LiveKit-Meet-3000`

## 관련

- `meet/README.LivekitDev.md`
- `docs/livekit-external-access.md`
- 공인 IP가 바뀌면 `.env.local` 의 `LIVEKIT_URL` 과 `--node-ip` 를 함께 수정