Synology 에서 docker-tvheadend 실행 방법(wiserain/docker-tvheadend)

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

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

우선으로 한다.

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 으로 설치 사례 입니다.

DSM 6.1.4-15217 Update 3 사용중입니다

1. 패키지 센터로 가서 Docker 를 설치한다. ( docker 조회 설치후 실행)

2. 왼쪽 Registry 에서 wiserain 를 조회 합니다.

Registry 에서 wiserain/tvheaded 를 선택 다운로드 합니다. / 더블클릭하면 웹사이트 이동 정보 확인 가능

- 다운로드 클릭 시 태그 선택 버전을 선택 합니다

- > stable 추천 합니다....저는 latest 설치 합니다.

3. wiserain/tvheadend를 검색하여 다운로드 한다. 드롭 다운 메뉴를 펼쳐 보면 과거 이미지 버전이 있으니 필요할 경우 예전 버전으로

돌아가는 것도 가능하다. 기본값은 latest 이다. latest 는 새로운 기능을 체험할 수 있는 개발 버전으로 약간 불안정할 수 있으니 stable tag

사용을 권한다.

- stable 버전으로 나중에 다시 설치 했습니다...이하는 latest 버전설치이나 stable 버전 설치와 동일 설정 입니다.

4. 다운로드가 완료되면 Image 섹션에 나타난다. 이제 이 이미지를 활용해서 tvheadend 앱이 돌아가는 가상의 시스템 공간인 Container 를

만든다. 이미지를 선택하고 Launch/실행 를 누르면

5. Container 의 세부 내용을 설정할 수 있다. 먼저 이름을 적당히 정하고, Advanced Settings 를 눌러서 상세 설정을 한다.

6. 이미지/고급설정/....시놀로지가 껐다 켜져도 자동으로 실행하도록 해야하니 Enable auto-restart 에 체크한다.

>> 자동 재시작 활성화 /바탕화면에 바로가기

7. 컨테이너 내부의 공간(Mount path)과 실제 우리가 사용하는 공간을 서로 링크해준다. /config 는 tvheadend 의 모든 설정이 저장되는

곳이며, /recordings 의 경우는 녹화하게 될 경우를 위한 template 폴더이다. 이런 식으로 원하는 경로를 마운트하고 docker container 에서

가져다 쓰면 된다.

추가 알림 2017 년 7 월 이후 업데이트된 epg2xml 정보를 저장하기 위한 볼륨을 추가로 설정해 주어야 한다. 예를 들어, /docker/tvh-

test/epg2xml과 /epg2xml이 쌍을 이루도록.>> filestatio 을 실행하여 폴더를 3 개를 만듭니다

// docker 에서도 파일추가 누르고 폴더 생성 가능 합니다....이하 참조 하고 docker 설치 하면서 docker 에서 폴더 만들면서 지정하세요

/volume1/docker/wiserain-tvheadend/config

/volume1/docker/wiserain-tvheadend/recording

/volume1/docker/wiserain-tvheadend/epg2xml

> 폴더를 3 개 만들고 docker 에서 마운트 합니다.

/volume1/docker/wiserain-tvheadend/recording 는 /recording

/volume1/docker/wiserain-tvheadend/epg2xml 는 /epg2xml

/volume1/docker/wiserain-tvheadend/config 는 /config

폴더를 3 개 만들고 docker 에서 폴더 이름을 마운트 합니다

- 고급설정/볼륨...폴더 선택 마운트 이름 지정 합니다

- 고급설정/볼륨...폴더 선택 마운트 이름 3 가지 지정 합니다

8. 네트워크는 호스트와 동일 네트워크 사용에 체크. README 에서도 언급했지만, docker 는 멀티캐스트 패킷 라우팅이 안되기 때문에

tvheadend 는 무조건 hosted network 를 사용해야 한다. 일부 낮은 버전에서는 지원하지 않으니 참고. (예를 들면 DSM 5.2)

>> 필수조건 > 미체크시 채널 서비스가 생성 되지 않습니다

9. 이제 환경변수를 입력해준다. 이 변수는 그대로 가상 시스템에 전달되어 활용 가능하다. 먼저 TZ 은 시스템이 사용할 시간대 설정이다.

이게 제대로 안되면 EPG 에 시간차가 발생한다. PGID 와 PUID 는 컨테이너 내부의 앱이 외부의 볼륨에 접근할 수 있도록 하는 권한에 대한

것이다. 여기 중간쯤에 잘 설명되어 있는데, 시놀로지에서는 docker 가 root 권한으로 동작하므로 아마 0 이리라 예상은 되지만, 각자 ssh 로

들어가서 확인해보길 바란다.

이 단계에서 환경변수를 추가함으로써 여러가지 addon 을 설치할 수 있다. 예를 들어, tvhProxy 를 설치하고 싶다면 TVH_URL이라는 변수를

만들고 http://username:password@localhost:9981 값을 설정해 준다. 자세한 내용은 README 를 참고바람.

>> PGID 와 PUID 를 0 으로 입력 합니다.

10. OK 를 누르면 설정 내용을 다시 한번 확인하고 create 와 동시에 run 하도록 체크를 해준다. (원하면 따로도 가능)

11. 이제 Container 섹션/비디오 형식을 보면 만들어져 실행되고 있는 것을 확인할 수 있다. 여기서 켜고 끄고 지우고 등등 할 수 있다.

12. 선택 후 Detail 을 누르면 동작하고 있는 정보를 볼 수 있고,

13. Log 탭에 보면 처음 기동 후의 초기화 작업이 진행 중인 것을 알 수 있다.

14. docker_tvheadend 설치 완료 후 http://localhost:9981 로 접속하면 tvheadend 초기 설정 메뉴가 보인다. latest 버전

> 설정 중지 후 언어 및 access,export epg 언어 설정 지정 저장 합니다

- 저장후 tvheadend 설치 버전을 확인 합니다

-설치된 stable 버전 입니다.

15. EPG Grabber Modules 를 보면 미리 마련해둔 KT LG SK 3 사의 Interal XMLTV grabber 가 있으니 각자의 iptv 회사에 맞게 켜서 사용하면

된다....저는 skiptv 사용자로 선택 켜짐 저장

사용자 등록후 암호설정 로그인 접속하여 *아이디 관리자 uncheck 합니다

설정/일반 조건

사용자 인터페이스 전문가로 변경 합니다 //재 로그인 합니다.

system time update / 업데이트 시간,NTP 드라이버 활성 check 합니다.

- 녹화 / 비디오 녹화 프로그램 설정 ...check 항목 참조

- 타임 시프트 설정

저장소 경로 /recordings/ .... 녹화 / 비디오 녹화 프로그램 경로와 동일 장소 지정

이제 iptv 채널 m3u 를 추가 하기 이하여 네트워크/추가 /iptv 자동네트워크 설정 합니다.

iptv 자동네트워크 설정 > 주) 최대 입력스트림 3~4 개 필수 ( iptime 공유기 0 일때 버벅임및 먹통 됩니다)

주) 채널 묶음 생성 check 및 기타 설정 참조

- 서비스는 채널/epg //채널묶음에서 check 되어 있어야 나옴니다

-채널 설정

-epg 그래버 채널 은 현재 지상파 epg 만 나옵니다

>> 변경은 변경 추가 해야 합니다.( 아래 채널은 skbtv 기준 입니다)

"MyChannels" : " 1, 2, 4, 5, 6, 7, 8, 10, 11, 14, 15, 18, 19, 20, 21, 23, 24, 26, 28, 31, 32, 35, 36, 38, 39, 40, 41, 42, 43, 46, 47, 48, 49, 50, 51, 52,

55, 56, 57, 58, 59, 60, 61, 62, 63, 68, 71, 72, 73, 74, 75, 78, 79, 80, 82, 83, 84, 85, 86, 87, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101,

103, 104, 105, 107, 108, 110, 111, 112, 117, 118, 119, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 133, 134, 135, 136, 137, 138, 139, 141,

142, 143, 144, 147, 148, 149, 150, 151, 153, 154, 156, 157, 159, 160, 164, 165, 166, 167, 168, 169, 170, 171, 173, 177, 178, 179, 183, 184, 185,

186, 192, 193, 196, 198, 199, 200, 201, 202, 205, 207, 208, 212, 213, 215, 216, 218, 219, 220, 222, 223, 225, 228, 229, 230, 231, 232, 233, 234,

235, 237, 238, 239, 240, 241, 244, 245, 246, 247, 250, 251, 255, 256, 257, 258, 260, 263, 264, 265, 266, 268, 272, 273, 275, 278, 280, 281, 282,

283, 284, 285, 286, 289, 290, 291, 293, 294, 296, 297, 299, 301, 302, 303, 307, 309, 311, 312, 313, 314, 315, 316, 318, 319, 320, 321, 363, 364,

370, 372, 373, 374, 409, 411, 412, 414, 415, 442, 445, 446, 453, 457, 458, ",

“MyChannels" : "60, 110, 111, 122, 164 ", 채널에 epg 가 나오게 수정하기

- epg2xml.json 에서 mychannel 을 수정후 web 폴더에 복사 합니다

- 그리고 cp 명령으로 putty 에서 복사 합니다

web 폴더의 W:\epg2xml\epg2xml.json 를

/volume1/web/epg2xml 에서

/volume1/docker/wiserai-tvheadend_stable/epg2xml/epg2xml.json 카피 복사 합니다

주) 파일 스테이션에서 업로드 덮어쓰기 합니다.

- 또는 파일스테이션에서 편집 / mychannels 에 보고자하는 방송 epg 를 추가 넣기 하세요

-전자 프로그램 가이드에서 변경이 되지 안고 이전 상태

- 네트어크 강제 시작

- docker-tvheadend 를 장제중지 > 시작점 시작 합니다

- epg 그래버채널이 mychannel 추가된 방송번호가 보임니다

전자가이드는 현제는 채널 검색 서치중으로 나타나지 않고 나중에 끝나고 나타납니다.

epg 그래버에서 OTAEPG 그래버 작동 > 채널이름/번호 업데이트 check 후 작동을 클릭 합니다

- 전자 프로그램 가이드 정상적으로 보임니다.( ...축 성공....)

<<< kodi 에서 설정 >>>>

연결설정 ip 주소 192.168.0.11 입력 // ddns 입력은 공유기 포트포워딩 설정 후 입력

공유기 포트포워딩 설정 후 입력

docker-compose 를 이용하는 방법 ( 제공자 정보 )

putty 등의 프로그램을 이용해 ssh 로 접속한다. docker 는 기본적으로 root 로 동작하므로 root 권한을 획득하고,

sudo -i

접속하여 docker 경로로 이동한다. (시스템마다 다를 수 있음)

cd /volume1/docker

docker-compose.yml 파일을 생성한다. (이미 있으면 적절히 편집)

vi docker-compose.yml

아래 내용을 붙여 넣는다. yml 문법을 따르므로 띄어쓰기와 indent 에 주의한다.

version: '2' services: tvh-test: container_name: tvh-test image: wiserain/tvheadend:latest restart: always network_mode: "host" volumes: - /volume1/docker/tvh-test/config:/config - /volume1/docker/tvh-test/recordings:/recordings - /volume1/docker/tvh-test/epg2xml:/epg2xml environment: - PUID=0 - PGID=0 - TZ=Asia/Seoul - TVH_URL='http://username:password@localhost:9981'

이 내용은 앞에서 DSM GUI 로 설정했던 컨테이너의 설정을 그대로 반영한다. 자신의 환경에 맞게 volumes 나 container_name 등을

수정하여 사용하도록 한다. 나중에 다른 이미지로부터의 컨테이너가 있으면 services 아래에 추가하면 된다. 저장하고 나와서 아래

명령어를 치면 컨테이너를 생성하고 실행한다.

docker-compose up -d <service name e.g. tvh-test>

이후 과정은 동일하게 웹 http://localhost:9981/ 에서 진행한다