OBS 유튜브 라이브 HLS 출력 스트림 디버그 캡처

유튜브 라이브 스트림 캡처를 위한 hosts 파일 수정

유튜브 HLS 라이브는 기본 주소로 a.upload.youtube.com과 b.upload.youtube.com를 사용한다. OBS가 이 도메인으로 데이터를 전송하려 하면 운영체제(OS)는 먼저 도메인에 대응하는 IP 주소를 확인한 다음, 확인된 IP 주소의 서버로 OBS를 연결해 준다.

대부분의 OS는 도메인의 IP 주소를 확인할 때 로컬의 hosts 파일을 가장 먼저 확인한다. 따라서 hosts 파일에 유튜브 주소가 PushCap 서버의 IP 주소로 지정되어 있다면 OBS가 유튜브로 전송한 데이터는 실제로 PushCap 서버로 전송되게 된다. (이를 악용한 것인 hosts 파일 변조(Hosts file tampering) 공격이다.)

hosts 파일은 별도의 확장자가 없는 텍스트 파일로, 윈도우와 리눅스 모두 같은 이름을 사용한다. 이 파일이 있는 기본 경로는 다음과 같다.

윈도우

C:\Windows\System32\drivers\etc\hosts

리눅스

/etc/hosts

메모장이나 nano 같은 텍스트 편집기를 이용해 유튜브 업로드 주소가 바라볼 IP 주소를 PushCap이 실행 중인 호스트의 IP로 변경해 준다. 아래는 윈도우의 hosts 파일을 수정한 예이다.

# Copyright (c) 1993-2009 Microsoft Corp.
#
# This is a sample HOSTS file used by Microsoft TCP/IP for Windows.
#
# This file contains the mappings of IP addresses to host names. Each
# entry should be kept on an individual line. The IP address should
# be placed in the first column followed by the corresponding host name.
# The IP address and the host name should be separated by at least one
# space.
#
# Additionally, comments (such as these) may be inserted on individual
# lines or following the machine name denoted by a '#' symbol.
#
# For example:
#
#      102.54.94.97     rhino.acme.com          # source server
#       38.25.63.10     x.acme.com              # x client host
127.0.0.1	a.upload.youtube.com
# 127.0.0.1	b.upload.youtube.com
# localhost name resolution is handled within DNS itself.
#	127.0.0.1       localhost
#	::1             localhost

위의 예에서는, 메인 업로드 주소인 a.upload.youtube.com만 PushCap이 실행 중인 PC로 설정했다. 127.0.0.1은 루프백 주소로 자기 자신을 가르킨다. 즉, OBS와 PushCap이 동일한 서버에서 동작할 것이란 의미다.

예비 주소의 경우, 줄 앞에 #이 붙어있다. 이것은 주석을 의미하며, 예비 주소에 대해서는 변경하지 않겠다는 의미이다. 리눅스 시스템의 hosts 역시 동일한 방식으로 수정해 주면 된다.

OBS HLS PUSH 출력 캡처

hosts 파일을 수정한 다음 OBS에서 YouTube HLS 스트리밍을 시작하면, 유튜브 인제스트 도메인으로 전송되는 HLS 데이터가 PushCap 서버로 전달된다.

1. HLS PUSH 서비스 선택

   OBS 프로그램의 설정 화면에서 방송(Stream)을 선택한 다음, 타겟 서비스 목록에서 YouTube-HLS를 선택해 준다.

   

2. 스트림 키 설정

   스트림키 사용(Use Stream Key)을 선택해 스트림 키 입력 모드로 진입한 뒤, Stream Key 항목에 임의의 키 번호를 입력해 준다. 여기에서 입력하는 항목은 굳이 자리수를 맞출 필요는 없다. 예시화면의 내용은 본 필자가 임의로 생성한 내용이다.

   

3. 방송 시작

   방송 시작(Start Streaming)을 선택하여 스트리밍을 시작한다. 연결에 성공하면 OBS가 전송한 플레이리스트와 미디어 세그먼트가 PushCap에 차례로 업로드되고, 콘솔에는 수신한 파일의 이름과 크기가 출력된다.

   

HLS 캡처 데이터 확인

OBS의 스트리밍을 종료한 후, PushCap.py 파일이 있는 디렉토리를 확인해 보면 uploads라는 하위 디렉토리가 생성된 것을 확인할 수 있다. 해당 디렉토리 안에는 위에서 사용한 키 이름의 디렉토리가 있고, 그 안에는 OBS가 전송한 HLS 데이터를 캡처한 파일이 들어있다.

확장자가 .ts인 파일은 동영상 데이터로, OBS가 업로드한 파일이 그대로 저장된다. 플레이리스트인 .m3u8 파일은 OBS가 업로드할 때마다 번호를 붙여 저장한다.

번호가 없는 .m3u8 파일은 OBS가 가장 마지막으로 전송한 플레이리스트이고, 가장 큰 번호가 붙은 .m3u8 파일과 내용이 같다. 번호가 붙은 파일들을 순서대로 비교하면 스트리밍이 진행되는 동안 미디어 시퀀스와 세그먼트 목록이 어떻게 변경되었는지 확인할 수 있다.

데이터 검증

캡처가 끝나면 플레이리스트와 미디어 세그먼트가 정상적으로 생성되었는지 확인한다. 먼저 .m3u8 파일에 기록된 세그먼트 이름과 실제 .ts 파일이 일치하는지 확인하고, 미디어 시퀀스 번호가 순서대로 증가하는지, 각 세그먼트의 재생 시간이 올바르게 표시되는지 살펴본다.

유튜브로 전송할 HLS 스트림을 검증할 때에는 유튜브 HLS 라이브 콘텐츠 명세서를 기준으로 플레이리스트의 태그, 세그먼트 길이, 코덱과 컨테이너 형식 등을 확인한다.

실행 환경의 준비

1. 파이썬 설치

   PushCap은 파이썬을 기반으로 작동되는 프로그램이다. 서버로 사용할 PC에 파이썬을 설치한다.

2. 추가 패키지 설치

   프로그램 실행에 필요한 추가 패키지를 설치해 준다. flask 패키지와 tornado 패키지가 필요하며, 다음 명령을 통해 설치가 가능하다.

   py -m pip install flaskpy -m pip install tornado
3. HTTPS 인증서 생성

   현대 HLS 프로토콜은 HTTPS를 이용해 이루어진다. 때문에 인증서 파일이 필요하다. 생성한 cert.pem 파일과 key.pem 파일을 PushCap.py와 같은 경로에 복사해 둔다.

   인증서 파일을 생성하는 방법은 와우자 스트리밍 엔진에 HTTPS 사설 인증서를 적용하는 방법을 참고하기 바란다.

   cert.pem

   HTTPS 서버가 제공하는 인증서 파일

   key.pem

   인증서와 함께 사용하는 개인 키 파일

프로그램 파일 생성과 실행

1. 코드 파일 다운로드

   GitHub의 PushCap 프로젝트에서 PushCap.py을 다운로드 받는다.

2. PushCap.py 저장

   적당한 디렉토리에 PushCap.py를 저장한다.

3. PushCap 실행

   콘솔 창에서 PushCap.py가 있는 디렉토리로 이동해 PushCap.py를 실행시켜 준다. 앞에서 준비한 cert.pem과 key.pem도 같은 디렉토리에 둔다.

아래와 같이 스트림을 쏘세요!라는 메시지가 출력되면 프로그램이 실행되어 HLS를 수신할 준비가 완료되었다는 뜻이다.

Microsoft Windows [Version 10.0.20348.4052]
(c) Microsoft Corporation. All rights reserved.
D:\HLSWEB>py PushCap.py
Starting PushCap HTTPS server on port 443...
스트림을 쏘세요!

PushCap은 BSD 3-Clause License에 따라 배포한다. 사용자는 저작권 고지와 라이선스 조건을 준수하는 범위에서 소스 및 바이너리 형태로 프로그램을 사용·수정·재배포할 수 있다. 이 프로그램은 어떠한 보증 없이 현재 상태 그대로 제공되며, 사용에 따른 모든 책임은 사용자에게 있다.