Nginx 스트리밍 서버로 사용하기

nginx를 HLS로 간단한 스트리밍을 할 수 있는 서버로 구축하는법에 대해 정리하려합니다.

nginx를 컴파일하는 방식으로 진행하였고 제가 진행한 스펙은 아래처럼 구성되어있습니다.

OS : Ubuntu 22.04
Nginx : 1.20.2

😎설치

설치경로는 계정 루트 디렉토리에 nginx-source 디렉토리를 만들고 그 안에서 작업하는걸 추천합니다.

• nginx

wget <http://nginx.org/download/nginx-1.12.0.tar.gz>

• nginx-vod-module

git clone <https://github.com/kaltura/nginx-vod-module.git>

😎configure 세팅

압축을 풀고 nginx 디렉토리로 들어가서 configure를 세팅해줘야합니다.

./configure --add-module=../nginx-vod-module --with-file-aio --with-threads --with-cc-opt="-O3"

• with-file-aio 는 asynchronous I/O 를 지원하게 해준다
• with-threads 는 thread pool 을 이용해서 asynchronous 하게 파일을 open 하도록 해준다.
• with-cc-opt="-O3" 는 compiler Optimization 을 위한 옵션이다.

😎Nginx 컴파일

configure를 모두 추가했다면 nginx컴파일을 진행해야합니다.

make && make install

make를 사용했을때 특정 패키지가 없어서 진행못한다고 문구가 많이 나올 수 있습니다.

친절하게 어떤 부분이 없는지 다 알려주니 하나하나씩 다 설치해줍니다.

😎Nginx config 세팅

컴파일이 정상적으로 진행되었다면 nginx는 /usr/local/nginx 이쪽에 설치되었을겁니다.

nginx를 실행하기전에 /usr/local/nginx/conf/nginx.conf 파일을 수정합니다.

worker_processes  1;
events {
    worker_connections  1024;
}
http {
    include       mime.types;
    default_type  application/octet-stream;
	  sendfile        on;
    keepalive_timeout  65;

    vod_mode                           local;
    vod_metadata_cache                 metadata_cache 16m;
    vod_response_cache                 response_cache 512m;
    vod_last_modified_types            *;
    vod_segment_duration               9000; #동영상을 9초 단위로 나눠서 전송
    vod_align_segments_to_key_frames   on;
    vod_dash_fragment_file_name_prefix "segment";
    vod_hls_segment_file_name_prefix   "segment";

    vod_manifest_segment_durations_mode accurate;

    open_file_cache          max=1000 inactive=5m;
    open_file_cache_valid    2m;
    open_file_cache_min_uses 1;
    open_file_cache_errors   on;

    aio on;
server {
        listen       80;
        server_name  localhost;
        
				location ~ ^/videos/.+$ {
            autoindex on;
        }

        location /hls/ {
            vod hls;
            root /{스트리밍해야할 동영상 경로};

            add_header Access-Control-Allow-Headers '*';
            add_header Access-Control-Allow-Origin '*';
            add_header Access-Control-Allow-Methods 'GET, HEAD, OPTIONS';
        }
	}
}

이렇게 세팅을 해주면 된다.

😎Nginx 명령어

서비스 시작 : /usr/local/sbin/nginx
서비스 정지 : /usr/local/sbin/nginx -s stop
서비스 재시작 : /usr/local/sbin/nginx -s reload
설정 파일 syntax 테스트 : /usr/local/sbin/nginx -t
서비스 동작 확인 : netstat -ntlp | grep :80
로그파일경로 : /usr/local/nginx/logs

😎HLS 스트리밍 확인

아무것도 없는 브라우저에서 바로 HLS 스트리밍은 확인이 안될겁니다.

확장프로그램이 설치되있으면 url입력하는것으로 바로 영상 확인이 가능해집니다.

크롬일경우 확장프로그램 검색해서 HLS Player설치하면 바로 확인 가능합니다.

http://{서버IP}/hls(nginx.conf에서 location으로 잡아둠)/{영상명}.mp4/master.m3u8

😎참고내용

혹시 영상이 안나온다면 영상이 저장된 경로의 권한이 충분한지 확인해볼 필요가 있습니다.

그리고 경로의 권한문제와 함께 영상의 권한문제도요.(영상 권한때문에 다른 문제인줄알고 한참 삽질하다가 error log보고 확인해서 처리했었네요😥)

저같은 경우는 다른 프로젝트에서 영상 업로드 하고나면 인코딩까지 진행하고 인코딩된 영상을 스트리밍했어야해서 영상 업로드 디렉토리, 인코딩 후 저장 디렉토리 모두 같은곳에서 경로만 바꿔서 사용했고 권한을 777로 세팅하고 사용했습니다.

😎궁금한점

컴파일한 nginx만 그런지는 모르겠는데 nginx는 컴파일된 상태에서는 모듈추가가 안되는걸로 보였습니다. 무조건 컴파일전에 configure에 어떤 모듈을 추가할 건지 미리 추가를하고 컴파일해야지만 모듈을 추가할 수 있는 걸까요? apache처럼 정해진 공간에 모듈을 배치만 하면 실행하는게 당연하고 좋은거같은데… 제가 모르는거라 생각하니 한번 더 찾아봐야겠습니다.

😎REF

• https://alnova2.tistory.com/1166