LiveKit Meet 연동

원본 다운로드: Markdown · PDF

작성일: 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:

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에 연결합니다.

기동

# 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 를 함께 수정