Synology에서 docker-tvheadend 실행 방법

(wiserain/docker-tvheadend)

이 문서는 Synology DSM에서 docker-tvheadend를 실행하는 방법을 설명한다.

작성 시점이 오래 되어 상세 내용은 조금 다를 수 있으니

README의 내용을 우선으로 한다.

1) putty접속 자동으로 docker용 tvheadend 설치 하기

============= 시놀로지 도커 이용 자동으로 tvheadend 설치 하기 ========

1)xmltv.xml 만들기 =======================

시놀로지 작업스케쥴러에 추가하여 xmltv.xml의 epg파일을 만듬니다

/usr/bin/php /volume1/web/epg2xml/epg2xml.php -l 3 -o /volume1/web/epg2xml/xmltv.xml

2)dcoker용 tvheadend 자동 설치 ( 버전및 폴더 수정 : 레지스터 wise 검색 다운로드 태그선택 버전)=========

#wiserain/tvheadend:stable-4.2.6-39 설치 폴더 만들기

mkdir /volume1/web/epg2xml

mkdir /volume1/video/recordings

mkdir /volume1/docker

mkdir /volume1/docker/tvheadend

mkdir /volume1/docker/tvheadend/wiserain-tvheadend_stable-4.2.7-39

mkdir /volume1/docker/tvheadend/wiserain-tvheadend_stable-4.2.7-39/config

#도커 컨테이너만들기

docker run -d \

--name=wiserain-tvheadend_stable-4.2.7-39 \

--network=host \

-v "/volume1/web/epg2xml:/epg2xml" \

-v "/volume1/video/recordings:/recordings" \

-v "/volume1/docker/tvheadend/wiserain-tvheadend_stable-4.2.7-39/config:/config" \

-e PUID=0 -e PGID=0 -e TZ=Asia/Seoul \

-e EPG2XML_VER=web_epg2xml \

wiserain/tvheadend:stable-4.2.7-39

3) putty에서 docker 접속하기 ====

docker ps

# 확인하여 id변경

docker exec -it 614df905fce5 bash

4)도커 접속후 epg그래버모듈 putty에서 복사 후 만들기 ====

cp tv_grab_docker_cat* /usr/bin

chmod 777 /usr/bin/tv_grab_docker_cat*

chmod +x /usr/bin/tv_grab_docker_cat*

5) 도커에서 해당버전 tvheadend 재시작후 tvheadend 접속

6) http://192.168.0.11:9981

===================

상기 사용버전 확인및 다운 하지 안아도 됩

====================================

최종 버전은 내용 수정 상위 참조

====================================

2)DSM의 GUI를 이용하는 방법 사이트 참조 자료

https://github.com/wiserain/docker-tvheadend/blob/epgkr/assets/how-to-run-on-synology.md

사이트는 참조만 하고 DSM 패키지 접속 docker 조회 설치 합니다

wiserain/docker-tvheadend의 장점은 epg2xml 설치가 자동으로 epg그래머모듈까지 자동으로 설치 됩니다

상기 사이트 기준으로 저의 시스탬기준 dsm6.1 으로 설치 사례 입니다.

[]docker tvheadennd 설치시 참조
>> 폴더를 3 개 만들고 docker 에서 마운트 합니다.
/volume1/docker/wiserain-tvheadend/recordings 는 /recordings
/volume1/docker/wiserain-tvheadend/epg2xml 는 /epg2xml
/volume1/docker/wiserain-tvheadend/config 는 /config
[]환경변수 추가 PGID PUID

>> PGID 와 PUID 를 0 으로 입력 합니다.DSM 6.1.4-15217 Update 3 사용중입니다

==========

최종 설치 버전

삭제후 재설치

연속 error없이 화면 가끔 끊기는 증상 없네요

docker-tvheadend 정보만 참조 하세요

그리고 아래 설치 참조 드립니다.

https://hub.docker.com/r/wiserain/tvheadend/

이미지 태그 네이밍 규칙

latest: 최신 이미지 버전. 대부분의 유저에게 권장 됨. 새로운 기능을 체험할 수 있는 개발 버전으로 약간 불안정할 수 있다. 비유를 들자면 Firefox나 LineageOS의 Nightly 빌드, 아니면 iOS의 Public Beta와 유사하다.
ver-build: 과거 이미지 버전으로 tvheadend 버전을 따른다. 예를 들어 4.1-2533.
stable: 최신 tvheadend release 버전 참고
vaapi: latest 빌드에서 vaapi 관련 옵션을 활성화 한 버전 (실험적)
testing: docker 이미지 테스트 버전 (개발용)

네트워크 모드

docker는 멀티캐스트 패킷 라우팅이 안되기 때문에 tvheadend를 이용해 IPTV를 보기 위해서는 무조건 hosted network를 사용해야 한다. 일부 낮은 docker engine 버전(예를 들어 Synology DSM 5.2)에서는 지원하지 않으니 참고. hosted network란 포트 포워딩이나 매핑을 하지 않고 호스트의 네트워크에 그대로 붙인다는 의미이므로 tvheadend가 사용하는 포트를 바꾸고 싶다면 앱 실행 시 옵션을 주어서 변경해야 한다. docker에서는 다음과 같이 환경 변수를 추가해주면 된다. RUN_OPTS=--http_port <port number> --htsp_port <port number>

환경변수

docker-tvheadend의 동작을 제어하는 환경변수와 가능한 옵션을 설명한다. 참고로 환경변수는 컨테이너 생성 시점에 그 값이 고정 되므로 변경을 원한다면 컨테이너를 삭제/재생성 해야한다. 먼저 필수로 지정해야하는 환경변수=기본값는 다음과 같다.

PUID, PGUI: 컨테이너 내부의 앱이 외부의 볼륨에 접근할 수 있도록 하는 권한에 대한 것이다. 여기를 참고하여 설정한다. 적절하게 설정하지 않으면, EPG 관련 스크립트가 동작하지 않거나 녹화가 안될 수 있다.
TZ="Asia/Seoul": docker-tvheadend에 적용되는 timezone 설정이다. 이게 제대로 안되면 EPG에 시간차가 발생한다.
EPG2XML_VER="latest": 이 값을 활용해서 epg2xml (latest release)을 다운로드 받는다. 만약 과거 버전에 머무르고 싶다면 값을 지정해 준다. 예를 들어 EPG2XML_VER=1.2.1 더이상 epg2xml 폴더의 내용이 변경되지 않기를 원한다면 값을 비워둔다. EPG2XML_VER=.

추가로 사용 가능한 환경변수는 다음과 같다.

UPDATE_CHANNEL: epg2xml의 채널 정보를 담고 있는 Channel.json 파일을 업데이트 한다. 더이상 업데이트 하지 않기를 원하면 false를 입력한다.
RUN_OPTS=--http_port <port number> --htsp_port <port number>: tvheadend 바이너리에 직접 전달되는 실행옵션. 대표적으로 tvheadend의 동작 포트를 바꿀때 쓸 수 있다.
TVH_URL=http://username:password@localhost:9981: tvhProxy는 tvheadend의 영상 스트림을 Plex의 DVR (녹화)에서 활용할 수 있도록 도와주는 프록시이다. tvheadend와 같이 내장했으므로 localhost가 맞고 그 외 username, password, port는 자신의 환경에 맞게 수정해서 사용한다. 참고로 이것을 활성화 하면 컨테이너 시작시 여러가지 의존성 설치를 위해 시간이 약간 걸린다.

어쩌면 도움이 될지도 모르는 정보

컨테이너를 시작할 때마다 /etc/cont-init.d/와 /etc/services.d/ 안의 스크립트를 이용해서 초기화를 진행하고 프로그램을 실행한다. 무슨 일이 일어났는지 궁금하거나 생각대로 되지 않으면 로그를 확인하자.
epg2xml 동작 언어는 php이다. 성능은 python이 약간 좋지만 그 차이가 미미한 반면, docker로 deploy할 때 php가 꽤 유용한 기능을 제공한다.
epg2xml.json은 경로에 파일이 없는 경우에만 다운로드하여 설치하고 경로에 있으면 원래 것을 보존한다. 따라서 같이 업데이트하고 싶으면 파일들을 지우고 컨테이너 삭제/생성/실행하면 된다. 그것도 싫으면 그냥 수동으로 받아서 복사/붙여넣기 하면 된다.
예전에는 내부적으로 epg2xml를 실행할 때 다음의 arguments -i {KT/SK/LG} -d를 썻으나 이제는 -i {KT/SK/LG} -o /epg2xml/xmltv.xml로 실행한 다음 cat /epg2xml/xmltv.xml로 불러온다. 중간에 파일로 저장하는 과정이 추가된 것이다.
EPG를 /epg2xml/xmltv.xml에 한 번 저장하는 이유는 이 경로를 웹서버로 노출시켜 다른 앱에서도 가져다 쓰기 쉽게 하기 위함이다. php 내장 기능을 이용해 /epg2xml 폴더의 내용이 http://<tvheadend ip>:9983/으로 서비스 되므로, tvheadend가 실행되면서 주기적으로 파일로 저장해 놓은 EPG 정보를 http://<<tvheadend ip>:9983/xmltv.xml로 접속하여 쓸 수 있다. 원래는 tvhProxy를 위해 짜낸 기능이지만 여러모로 유용하게 사용할 수 있을 것이다.

========

성공)EPG 기능이 포함된 docker-tvheadend 설치 사용기

참조사이트

http://archive.fo/fiRrC#selection-749.0-749.41

https://github.com/wiserain/docker-tvheadend/blob/epgkr/assets/how-to-run-on-synology.md

1) 패키지 센터로 가서 Docker를 설치한다.

2) wiserain/tvheadend 검색 합니다

3)다운로드 합니다

4) 조금있으면 실행 메뉴를 클릭 가능합니다

5) 고급 설정을 합니다

-다음

- 적용

- 볼륨 폴더 생성 설정

중요) docker/???tvheadnd/ 형식의 docker 밑에 ????tvheadend 가 있어야 합니다

마운트 폴더 생성후 마운트 이름 지정

- 컨테이너 내부의 공간(Mount path)과 실제 우리가 사용하는 공간을 서로 링크해준다. /config는 tvheadend의 모든 설정이 저장되는 곳이며, /recordings의 경우는 녹화하게 될 경우를 위한 template 폴더이다. 이런 식으로 원하는 경로를 마운트하고 docker container에서 가져다 쓰면 된다.

- 방법 > 파일 추가로 폴더 생성후 폴더 추가로 마운트 경로 입력 합니다.

* /config 경로 마운트는 docker/???tvheadnd/config

같이 마운트 폴더를 아래 3가지 설정 마운트 합니다

중요) 아래 폴더의 마운트 경로는 docker/???tvheadnd/ 밑에 있어야 합니다

/config 는 설정값 저장 경로

/recordings 는 녹화저장 경로

/epg2xml 는 epg의 epg2xml.json 설정값 불러 옵니다