2026.03.18
조회 526
WebRTC TURN 서버 구축 (coturn + SSL + 실전 적용)
광고
WebRTC 기반 화상 채팅이나 데이터 전송 서비스를 운영하다 보면, 특정 환경에서 연결이 실패하는 문제가 발생합니다. 특히 모바일 네트워크(LTE), 사내망, NAT 환경에서는 P2P 연결이 제대로 이루어지지 않는 경우가 많습니다.
이 문제를 해결하기 위해 TURN 서버를 별도로 구축하고, 실제 서비스에 적용하는 과정을 정리합니다. 이번 글에서는 VPS 서버 + coturn + Let’s Encrypt SSL + WebRTC 연동까지 실제 운영 기준으로 설명합니다.
보안상 IP 및 도메인은 일부 마스킹 처리되었습니다.
1. TURN 서버가 필요한 이유
WebRTC는 기본적으로 STUN을 이용해 P2P 연결을 시도합니다.
- 회사 네트워크 (방화벽)
- LTE / 5G 환경
- CGNAT 환경
- 일부 공유기 환경
TURN 서버는 “P2P 연결이 실패했을 때 데이터를 대신 전달해주는 중계 서버”입니다.
2. 서버 구성
- 서버: 클라우드 VPS
- TURN 서버 IP: XXX.XXX.XXX.XXX
- 도메인: example.com
- TURN 도메인: turn.example.com
turn.example.com → XXX.XXX.XXX.XXX
3. coturn 설치
sudo apt update
sudo apt install coturn -y
sudo systemctl stop coturn
sudo systemctl disable coturn
4. TURN 서버 설정
/etc/turnserver.conf
listening-port=3478
tls-listening-port=5349
listening-ip=0.0.0.0
relay-ip=0.0.0.0
external-ip=XXX.XXX.XXX.XXX
use-auth-secret
static-auth-secret=YOUR_SECRET_KEY
realm=turn.example.com
server-name=turn.example.com
fingerprint
lt-cred-mech
min-port=49152
max-port=65535
cert=/etc/letsencrypt/live/turn.example.com/fullchain.pem
pkey=/etc/letsencrypt/live/turn.example.com/privkey.pem
log-file=/var/log/turnserver.log
5. SSL 인증서 발급
sudo systemctl stop nginx
sudo certbot certonly --standalone -d turn.example.com
sudo systemctl start nginx
인증서는 /etc/letsencrypt/live/turn.example.com/ 경로에 생성됩니다.
6. 방화벽 설정
sudo ufw allow 3478/tcp
sudo ufw allow 3478/udp
sudo ufw allow 5349/tcp
sudo ufw allow 49152:65535/udp
7. TURN 서버 실행
sudo systemctl start coturn
sudo systemctl enable coturn
tail -f /var/log/turnserver.log
8. WebRTC 코드 적용
const pc = new RTCPeerConnection({
iceTransportPolicy: "all",
iceServers: [
{ urls: "stun:stun.l.google.com:19302" },
{
urls: [
"turn:turn.example.com:3478?transport=udp",
"turns:turn.example.com:5349"
],
username: turnUser,
credential: turnCredential
}
]
});
9. TURN 정상 동작 확인
chrome://webrtc-internals
정상 상태
- candidateType: relay
- ICE connection state: connected
- Connection state: connected
10. 실제 테스트 방법
- 모바일 LTE
- 다른 Wi-Fi 환경
- 회사 네트워크
내부 네트워크에서는 TURN이 동작하지 않을 수 있습니다. 반드시 외부 환경에서 테스트하세요.
결론
이번 작업을 통해 다음을 완료했습니다.
- TURN 서버 구축 (coturn)
- SSL 적용 (Let’s Encrypt)
- WebRTC 연동
- relay 동작 확인
핵심은 relay candidate가 나오면 성공입니다.
이 구조를 적용하면 모바일, 회사망, NAT 환경에서도 안정적인 WebRTC 서비스를 운영할 수 있습니다.
광고
광고
글 찾아보기
87개의 글
광고
광고