RTSP vs RTMP

📌 RTSP (Real Time Streaming Protocol)

🛠️ 용도

"컨트롤" 프로토콜에 가까움.
→ 영상/오디오 데이터를 직접 실어나르기보다는 재생, 일시정지, 중지 같은 명령 제어에 집중.

📦 데이터 전달

보통 RTP(Real-time Transport Protocol)랑 짝꿍으로 사용.
실제 영상 데이터는 RTP로 전달하고, RTSP는 그걸 관리.

⚙️ 사용처

CCTV, IP 카메라, 실시간 모니터링 시스템. (네트워크 카메라 주소가 rtsp://...인 경우가 많음.)

👍 특징

낮은 지연 시간(수백 ms 수준). 다만 방화벽이나 NAT 환경에서 잘 막히기도 함.

📌 RTMP (Real Time Messaging Protocol)

🛠️ 용도

원래 Adobe Flash Player 용으로 만든 "데이터 전송" 프로토콜.
→ 영상/오디오 데이터를 서버로 업로드하거나 내려받을 때 직접 씀.

📦 데이터 전달

TCP 기반, 자체 포맷으로 전송. 지금은 HLS/DASH 같은 표준 스트리밍으로 변환할 때 업로드(ingest) 프로토콜로 자주 사용.

⚙️ 사용처

유튜브 라이브, 트위치, 페이스북 라이브 등 방송 플랫폼 송출.

👍 특징

지연 시간은 RTSP보다 약간 크지만(1~5초), 범용 지원이 좋고 안정적임. 방화벽 우회도 상대적으로 쉬움.

ffmpeg 으로 미디어 스트림 hls 변환

0. libnginx-mod-rtmp 라이브러리

📜 정의

Debian/Ubuntu에서 제공하는 Nginx용 RTMP 동적 모듈 패키지다.
업스트림 오픈소스인 nginx-rtmp-module(일반적으로 arut/nginx-rtmp-module)을 배포판 포맷으로 묶어둔 것이라 보면 됨.

⚙️ 역할

1. Nginx에 rtmp {} 블록과 application {}/live on; 같은 RTMP 서버 기능을 추가
2. OBS 같은 퍼블리셔가 RTMP로 업로드(publish) 하면 이를 받아 중계(play/relay)
3. on_publish, on_play 등 이벤트 콜백(HTTP)로 인증/로깅을 붙일 수 있음. (관련 훅 링크)
4. exec로 FFmpeg를 자동 스폰하여 트랜스코딩/HLS 세그먼팅 파이프라인을 바로 붙일 수 있음.
5. (선택) 모듈 자체의 HLS/DASH 세그먼팅 기능도 있으나, 세밀한 제어·ABR 구성은 보통 FFmpeg가 더 유연함.

⚠️ 주의/제한

1. Nginx 공식 번들 모듈이 아닌 서드파티 모듈임. (배포판에서 편하게 쓰도록 패키징한 것)
2. RTMPS(SSL)를 네이티브로 직접 처리하지 않ㅓ는다.
   필요하면 stunnel/Nginx stream 프록시 등으로 감싸 쓰는 패턴을 사용.
3. 무거운 실시간 트랜스코딩은 FFmpeg(또는 SRS 내장/외부 트랜스코드)로 처리하는 것이 일반적임.

1. RTMP Ingest 방식

패키지 설치

sudo apt update
sudo apt install -y nginx libnginx-mod-rtmp ffmpeg
sudo mkdir -p /var/www/hls
sudo chown -R www-data:www-data /var/www/hls

nginx.conf 작성

동적 모듈 로딩 + RTMP 인젯 + FFmpeg 자동 변환 + HLS 서빙

# 동적 RTMP 모듈 로드 (Ubuntu/Debian 표준 경로)
load_module modules/ngx_rtmp_module.so;

worker_processes auto;

events { worker_connections 1024; }

# ---------- RTMP(Ingest) 이 부분은 아예 새로 추가 ----------
rtmp {
    server {
        listen 1935;          # RTMP default 포트
        chunk_size 4096;

        application live {
            live on;          # publish/play 허용
            record off;

            # (선택) 퍼블리시 인증 HTTP 콜백 예시
            # on_publish http://127.0.0.1:8080/auth?name=$name&key=$arg_key;

            # 스트림이 들어오면 스트림 이름($name)별로 FFmpeg를 띄워 HLS를 생성
            # : ABR(1080/720/480) 3종, 2초 짜리 세그먼트, 오래된 세그먼트 삭제
            exec_kill_signal term;
            exec /usr/bin/ffmpeg -loglevel error -hide_banner \
                -reconnect 1 -reconnect_streamed 1 -reconnect_on_network_error 1 \
                -i rtmp://127.0.0.1/live/$name \
                -c:v libx264 -preset veryfast -profile:v high -level 4.1 -pix_fmt yuv420p \
                -sc_threshold 0 -g 60 -keyint_min 60 \
                -c:a aac -ar 48000 -ac 2 -b:a 128k \
                -filter:v:0 "scale=w=-2:h=1080" -b:v:0 6000k -maxrate:0 6420k -bufsize:0 12000k \
                -filter:v:1 "scale=w=-2:h=720"  -b:v:1 3500k -maxrate:1 3740k -bufsize:1 7000k  \
                -filter:v:2 "scale=w=-2:h=480"  -b:v:2 1200k -maxrate:2 1320k -bufsize:2 2400k  \
                -map 0:v:0 -map 0:a:0 -map 0:v:0 -map 0:a:0 -map 0:v:0 -map 0:a:0 \
                -hls_time 2 -hls_list_size 6 \
                -hls_flags delete_segments+program_date_time+independent_segments \
                -master_pl_name "$name/master.m3u8" \
                -var_stream_map "v:0,a:0 name:1080p v:1,a:1 name:720p v:2,a:2 name:480p" \
                -hls_segment_type mpegts \
                -hls_segment_filename "/var/www/hls/$name/v%v/seg_%06d.ts" \
                "/var/www/hls/$name/v%v/index.m3u8";
        }
    }
}

# ---------- HLS 서빙(HTTP) 일부 옵션 추가 ----------
http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile on;
    tcp_nopush on;
    tcp_nodelay on;

    server {
        listen 80;
        server_name _;

        # HLS 정적 파일 제공
        location /hls/ {
            types {
                application/vnd.apple.mpegurl m3u8;
                video/mp2t ts;
            }
            alias /var/www/hls/;
            add_header Cache-Control no-cache;
            add_header Access-Control-Allow-Origin *;
            add_header Access-Control-Allow-Headers *;
        }
    }
}

적용:

sudo nginx -t && sudo systemctl reload nginx

OBS 설정

• 서버: rtmp://<서버IP 또는 도메인>/live
• 스트림 키: 예) mystream
  (인증을 붙였다면 mystream?key=YOURSECRET 식으로)

푸시가 성공하면 HLS는 다음 경로에 생긴다.

• 마스터 플레이리스트: http://<서버>/hls/mystream/master.m3u8
• 개별 레벨: /hls/mystream/v0/index.m3u8(1080p), v1(720p), v2(480p)

2. RTMP Ingress

exec를 쓰지 않고, 고정 스트림을 별도 서비스로 돌리는 방법
이게 훨씬 보기가 좋음.
대충 -p 옵션으로 /usr/local/bin/rtmp2hls.sh 작성

#!/usr/bin/env bash
set -Eeuo pipefail

IN="rtmp://127.0.0.1/live/mystream"   # OBS가 푸시하는 RTMP
OUTDIR="/var/www/hls/mystream"

mkdir -p "$OUTDIR"
exec /usr/bin/ffmpeg -loglevel error -hide_banner \
  -reconnect 1 -reconnect_streamed 1 -reconnect_on_network_error 1 \
  -i "$IN" \
  -c:v libx264 -preset veryfast -profile:v high -level 4.1 -pix_fmt yuv420p \
  -sc_threshold 0 -g 60 -keyint_min 60 \
  -c:a aac -ar 48000 -ac 2 -b:a 128k \
  -hls_time 2 -hls_list_size 6 \
  -hls_flags delete_segments+program_date_time+independent_segments \
  -f hls -hls_segment_filename "$OUTDIR/seg_%06d.ts" \
  "$OUTDIR/index.m3u8"

권한 추가

sudo chmod +x /usr/local/bin/rtmp2hls.sh

서비스 파일(.ini) 작성

# /etc/systemd/system/rtmp2hls.service
[Unit]
Description=RTMP -> HLS (FFmpeg)
After=network.target nginx.service

[Service]
User=www-data
Group=www-data
ExecStart=/usr/local/bin/rtmp2hls.sh
Restart=always
RestartSec=2
WorkingDirectory=/var/www/hls

[Install]
WantedBy=multi-user.target

데몬 로드 후 서비스 자동 등록 및 실행

sudo systemctl daemon-reload
sudo systemctl enable --now rtmp2hls

3. 체크리스트

권한: /var/www/hls에 www-data(또는 Nginx/FFmpeg가 도는 사용자) 쓰기 권한이 있어야 함.

경로: load_module modules/ngx_rtmp_module.so;가 실패하면 modules 경로(대개 /usr/lib/nginx/modules/)를 확인.

CORS: 웹 플레이어에서 크로스도메인 요청이면 /hls/에 CORS 헤더 추가(위 예시 포함).

키프레임 간격: 세그먼트 길이(예: 2초)의 정수배로 -g(GOP) 맞추는 것이 안정적.

성능: -preset veryfast부터 시작해서 여유되면 faster/fast로 올리기.

브라우저 RTMP: 불가. 웹은 HLS(또는 LL-HLS/WEBRTC)를 사용.