시놀로지 NAS에 Docker(도커)를 이용하여 Tvheadend 설치하기

시놀로지 NAS에 Docker(도커)를 이용하여 Tvheadend 설치하기




참고사이트


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


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


https://hinco114.github.io/2017/07/12/nas_TVHeadend_setting/



위의 사이트를 참고하였습니다. 저도 리눅스나 유닉스를 모르기 때문에, 초보자의 마음에서 설치를 하면서 발생하는 문제점 및 스크린샷을 제공함으로써 여러분들에게 많은 도움을 주려고 합니다. 저도 처음에는 막막하기 그지 없었지만, 구글링을 통해 하나하나씩 해나가니 문제를 해결할 수 있었습니다. 여러 군데 나누어져있는 지식들을 한 곳에 모으려고 노력을 하였습니다. 


우선 도커의 장점은 epg2xml 자동으로 설치되고, epg 그래머모듈까지 자동으로 설치됩니다. 아수스 공유기에 tvheadend를 올릴때, 애를 먹었는데 한방에 해결해준다니 고맙더라구요. 그래서 도커로 설치하려고 합니다. 아~참!! 도커는 최신 시놀로지 나스에만 설치된다고 하니, 도커의 설치 가능 유무를 먼저 확인하시는 것이 좋을 듯 싶습니다. 



시놀로지에서 Docker Tvheadend 설치방법 3가지




1. Docker 명령어 사용하는 방법


2. Docker - Compose 사용 방법


3. Synology DSM 사용방법


위의 3가지 방법이 있습니다. 저는 1/2번은 제외하였습니다. 리눅스 명령어를 잘 모르기 때문이고, 다른 블로그를 따라하면 되지만, 이해가 되지 않을 것 같아 3번의 방법으로 도커에 Tvheadend를 설치하고자 합니다. 


DSM 6.1.4-15217 Update 5 버전이네요. 참고하세요.



DSM을 이용하여 Tvheadend 설치하기


1. 패키지 센터 ▶ 모두 ▶ 제 3자 에서 Docker를 찾아 설치합니다. 





2. 왼쪽 메뉴탭을 클릭하여 도커를 실행합니다. 





3. 도커 레지스트리 항목에서 wiserain/tvheadend 을 검색합니다. 




화살표를 누르면, 웹사이트로 이동하여 도커 이미지에 대한 정보를 확인할 수 있습니다. 

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







4. 위 항목을 선택하고, 다운로드를 누릅니다. 태그 선택 창이 나오는데, 드롭다운 메뉴를 펼쳐서 stable 버전을 설치하시기 바랍니다. latest 최신 개발버전이므로, 불안정할 수 있으니 초보자인 저는 그냥 안정된 버전으로 설치합니다. 






5. 다운로드 완료후, 이미지 항목으로이동합니다. 이 이미지를 이용하여, tvheadend 프로그램이 동작하는 시스템 가상공간이라고 불리는 Container를 생성합니다. 이미지를 선택한 후, 실행을 클릭합니다. 마치 맥북에서 패러럴즈를 사용하는 것과 같다고 생각하시면 됩니다. 






6. 컨테이서 생성화면이 나타납니다. 먼저 일반설정을 진행합니다. 먼저 컨테이너 이름을 입력합니다. 





7. 고급 설정항목을 클릭하면, 아래와 같은 팝업 창이 나타납니다. 

   자동 재시작 활성화, 바탕화면에 바로가기 생성에 체크를 해줍니다. 

   시놀로지가 불가피하게 꺼졌다고 하더라도, tvheadend는 자동으로 재실행하기 위해서입니다.



잠시 파일스테이션으로 이동합니다.







8. 컨테이너 내부 저장 경로와 실제로 사용하는 공간을 서로 연결해 주어야 합니다. 



   /volume1/docker/wiserain-tvheadend/config : tvheadend 모든 설정이 저장되는 곳 

 

   /volume1/docker/wiserain-tvheadend/recording : 녹화 기능을 사용할 경우 임시 폴더


   /volume1/docker/wiserain-tvheadend/epg2xml : epq2xml 정보 저장을 위한 폴더 


파일 스테이션을 실행하여 위의 3개 폴더를 생성해야 합니다. 

volume1 폴더는 눈에는 안보이지만, 하드 드라이브 위치입니다. 

기본은 volume1 으로 되어 있습니다. 



폴더 3개를 모두 만들었습니다. 






9. 폴더를 생성하였으니, 이제는 Docker에서 생성한 폴더 추가하고, 각각의 폴더를 도커에 연결하기 위해 마운트 해줘야 합니다. 


이미지 ▶ 일반설정 ▶ 고급설정 ▶ 볼륨 항목으로 이동합니다. 


폴더 추가를 클릭합니다. 




3개의 폴더를 추가하고, 아래와 같이 마운트 경로를 입력해줍니다.





10. 네트워크 항목으로 이동하면, Docker 호스트와 동일한 네트워크 사용에 체크를 해주세요. 이유는 도커는 멀티캐스트 패킹 라우팅을 할 수 없으므로, 반드시 Hosted networks를 사용해야만 한다고 합니다. 낮은 버전에서는 지원이 불가하다고 합니다. 

체크하지 않을 경우, 채널 서비스가 생성되지 않습니다. 









11. 포트는 기본 포트를 사용합니다. 추가로 공유기에서 포트포워딩을 해줘야겠군요. 아하!!! 근데 도커 호스트와 동일한 네트워크를 사용할 때에는 포트 설정이 필요없다고 알림창이 뜨면서, 활성화가 되지 않는 군요. 








12. 환경 변수 항목으로 이동합니다. 이 항목의 변수들은 가상 시스템에 전달되어집니다. 

TZ: 시스템이 사용할 시간대, 시간대가 우리나라와 맞아야 EPG 시간차가 발생하지 않는다.

PZID/PUID: 컨테이너 내부의 앱이 외부 볼륨에 접근 권한을 주는 것인데, 시놀로지에서 도커는 root 권한으로 동작하므로, 0일 것입니다. ssh 들어가서 권한을 확인해보시기 바랍니다. 저는 이 항목이 없어서 직접 입력해주었습니다. 



시놀로지 버전이 업데이트되면서, 다양한 환경변수들이 추가되었습니다. 나머지 옵션을 그대로 두고, 위의 옵션만 정확하게 입력하여 줍니다. 






13. 이 마법사가 완료 후, 컨테이너 실행을 체크한 후 적용을 클릭합니다. 





14. 비디오 형식을 보면, tvheadend 앱이 실행중임을 확인할 수 있다. tvh 앱을 여러개 만들어, on/off/delete 할 수 있습니다. 혼자 해보시면 쉽습니다. 하지만 그냥 하나만 두는게...









15. 또한 선택후에, 세부사항을 클릭해보시면, 자세한 정보를 확인할 수 있습니다. 






Tvheadend 접속 및 설정하기 



16. dock_tvheadend 설치 완료 후,  http://로컬시놀주소:9981로 접속하면, Tvheadend 초기 설정화면이 보입니다. 






17. 아래 웹인터페이스 egp 언어를 한국어로 설정하고, 마법사를 종료합니다. 일단 마법사를 나가고, 설정하는 것이 훨씬 효율적이기 때문입니다. 아수스 간이 나스때 설정을 좀 해보아서 쉽게 진행할 수 있었습니다. 






18. 설정 ▶ 일반 ▶ 기본 

     Tvheadend 이름을 정하고, 인터페이스 레벨은 전문가

     언어설정은 Korean, 웹 유저 인터페이스 Korean, 테마는 접근을 해주세요. 

     접근을 설정하면, 화면 가독성을 뛰어나더라구요. 




Stable 버전을 설치하였습니다. Tvheadend 4.2.5 버전이네요. 






19. 설정 ▶ 채널/EPG ▶ EPG 그래버 모듈 이동합니다. 

     아수스 간이 나스에서 정말 난해한 부분이었는데, 먼저 확인해보도록 합니다. IPTV 3사 모두 내부 XMLTV 그래버가 있습니다. 자신의 IPTV 회사에 맞는 그래버만 켜서 사용하시면 됩니다. 저는 SK브로드밴드라서, SK만 켜서 설정 저장을 해줍니다.      






20. 설정 ▶ 사용자 ▶ 접근항목

   위로 이동하면, 사용자 아이디를 생성할 수 있고, 각종 권한을 설정할 수 있습니다. 관리자 권한으로 줄 거라, 최대한의 권한을 주시기 바랍니다. 







21. 설정 ▶ 사용자 ▶ 암호 

    사용자 이름과 암호를 설정합니다. 앞서 했던 아이디와 동일하게 입력합니다. 







22. 이제 생성된 아이디로 상단의 (로그인)을 클릭하여, 로그인을 합니다.






23. 로그인해서 들어가면, 생성된 아이디만 관리자 권한으로 만들기 위해, * 아이디에 대한 관리자 항목에 체크 해제를 합니다. 






24. 설정 ▶ 일반 ▶ 기본 

    시계 업데이트 항목 : 업데이트 시간/NTP 드라이버 활성 모두 체크 !!!!





25. 설정 ▶ 녹화 ▶ 디지털 비디오 녹화 프로필

    파일 이름 옵션을 잘 보시고, 원하는 항목에 체크하세요. 녹화 파일 생성시 중요하겠죠?






26. 설정 ▶ 녹화 ▶ 타임시프트 

    예전에 TV에 타임머신 기능이 있었죠? 이것과 비슷한 기능입니다. 티비를 보면서, 앞뒤로 이동할 수 있어 아주 유용한 기능이지만, 시스템 리소스를 조금은 잡아 먹겠죠?

    설정은 아래 그림처럼 하시면 됩니다. 







27. 설정 ▶ DVB 입력 ▶ 네트워크  

     항목으로 이동하여, 추가를 클릭한 후, IPTV 자동 네트워크를 선택합니다. 






IPTV 자동 네트워크 추가 설정하는 방법 


네트워크 이름 : SK BTV

최대 입력 스트림 : 3~4개 정도함. 많을 경우 공유기 부하 상당함!!!

URL : m3u파일이 있는 경로를 적어줍니다. 

채널 묶음 생성/TSID에 값으로 0 허용은 반드시 체크해줍니다. 

캐릭터셋 : UTF-8 한글 깨짐 방지하기 위해

나머지 설정은 그림 보시고 따라해보시기 바랍니다. 







위의 m3u 파일 경로 때문에 한시간 넘게 헤메였습니다. 파일 경로가 맞는거 같은데, 자꾸 안되더라구요. 물론 권한 설정도 해보았지만, 

http:// 혹은 file:// 두가지로 접속이 된다고는 하지만, http://는 안되는 것 같더라구요. 된다는 것도 이상하긴 합니다. 아이디와 비밀번호를 입력하지 않고 접속하는게 안될테니...


어쨋든 아래 도커내 tvheadend 설치 위치를 보고 알아내었습니다. 설치 위치가 기본 설치와는 아마도 조금 다르겠죠? 

결론은 docker 내부 폴더에 tvheadend가 설치되었는데, 그 위치가 /config 입니다. 그래서 아래와 같이 경로를 설정하였더니 되더군요. 파일의 경로를 어디서부터 시작해야할지가 매우 난감하였습니다. 리눅스나, 유닉스를 모르는 초보자에게는....ㅜ.ㅜ

file:///config/channels/btv.m3u










28. 위와 같이 생성을 하면, 아래 그림처럼 채널을 스캔하게 됩니다. 스샷을 보면서, 자신의 설정이 맞는지 확인해보시기 바랍니다.   



총 먹스가 보이고, 서비스가능한 채널이 216이네요. 







서비스 채널이 보입니다. 




위의 서비스 채널은 아래 그림처럼 설정을 해주어야만, 

서비스 항목에 채널들이 보입니다. 




지상파만 EGP 정보가 나오는 것 같습니다. 









29. 아래 그림을 보시면, 정상적인 채널의 EPG 그래버 채널은 5개만 존재합니다. 








30. EPG 그래버 채널에 모든 채널 EPG가 나오도록 epg2xml.json을 수정해야 합니다. 

     /volume1/docker/wiserain-tvheadend_vaapi/epg2xml/epg2xml.json

    파일 탐색기에서 위의 파일을 찾아, 마우스 우클릭하여 텍스트 편집기로 Open합니다. 







그냥 아래 텍스트 파일을 복사하여, 전체 붙여넣기 후, 저장하시면 됩니다. 


{

    "###_COMMENT_###" : "",

    "###_COMMENT_###" : "epg 정보를 가져오는 설정 파일",

    "###_COMMENT_###" : "사용하는 ISP 선택 (ALL, KT, LG, SK)",

    "MyISP": "SK",

    "###_COMMENT_###" : "### # My Channel EPG 정보 가져오는 채널 ID ###",

    "###_COMMENT_###" : "### 채널 ID를 , 로 구분하여 입력 ###",

    "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, ",

    "###_COMMENT_###" : "output 셋팅은 (d, o, s) 셋중에 하나로 선택한다",

    "###_COMMENT_###" : " d - EPG 정보 화면 출력",

    "###_COMMENT_###" : " o - EPG 정보 파일로 저장",

    "###_COMMENT_###" : " s - EPG 정보 소켓으로 출력",

    "output": "d",

    "###_COMMENT_###" : "### TV channel icon url (ex : http://www.example.com/Channels) ###",

    "default_icon_url": "",

    "###_COMMENT_###" : "### 제목에 재방송 정보 출력 ###",

    "default_rebroadcast": "n",

    "###_COMMENT_###" : "#### 제목에 회차정보 출력 ###",     

    "default_episode" : "y",

    "###_COMMENT_###" : "### EPG 정보 추가 출력 ###",

    "default_verbose" : "y",

    "###_COMMENT_###" : "### XMLTV_NS 정보 추가 출력 ###",

    "default_xmltvns" : "n",

    "###_COMMENT_###" : "### epg 데이터 가져오는 기간으로 1에서 7까지 설정가능 ###",

    "default_fetch_limit" : "2",

    "###_COMMENT_###" : "### epg 저장시 기본 저장 이름 (ex: /home/tvheadend/xmltv.xml) ###",

    "default_xml_file" : "xmltv.xml",

    "###_COMMENT_###" : "### # External XMLTV 사용시 기본 소켓 이름 (ex: /home/tvheadend/xmltv.sock) ###",

    "default_xml_socket" : "xmltv.sock",

    "###_COMMENT_###" : ""

}






그런데 저장이 되지 않습니다. 권한이 부족하다고 합니다. 






폴더 및 파일에 대한 권한이 문제일 겁니다. 

먼저 사용자 그룹에서 사용자의 권한을 모두 줍니다. 






그리고  해당 폴더로 가서, 마우스 우클릭 -> 속성탭 선택합니다. 

권한탭으로 이동하여, 그냥 생성을 클릭하여 권한을 추가해주면 됩니다. 



Winscp로 해도 되나, 솔직히 더 간단하지만 DSM으로 설명해보았습니다. 







31. 아래와 같이 EPG 그래버 채널이 업데이트 되었습니다. Mychannel이 모두 추가되었음을 확인하실 수 있습니다. 이제 거의 다 왔습니다. 










32. 설정  채널/EPG  EPG 그래버 

    채널 이름 업데이트, 채널 번호 업데이트 체크해주시고, OTA EPG 그래버 작동 클릭!!!









33. 전자 프로그램 가이드가 정상적으로 보입니다 !!!! 진짜 대박입니다. 







이제 모두 완성하였으니, 다양한 환경에서(PC/모바일/태블릿)에서 접속하는 방법에 대해서 포스팅해보도록 하겠습니다. 


솔직히 저는 나스를 한 목적이 TVHEADEND 기능이 30프로 정도 차지했는데, 이렇게 성공하니 마음이 정말 기쁘네요 



이 글을 공유하기

댓글(54)

  • 이전 댓글 더보기
  • Y
    2018.04.29 19:38 신고

    안녕하세요.
    기존 dsm 및 tvheadend 업데이트시 epg가 자주 날라가서
    Docker를 이용한 방법으로 하니 쉽고 편하게 잘 셋팅했습니다. 감사합니다.

    다름이 아니라 도커로 셋팅한 후로는 나스가 슬립모드로 진입을 안하네요 (1515+ / DSM 및 모든 응용프로그램 최신버전 업데이트)
    혹시 슬립모드 진입 잘 되시나요?

  • 초보
    2018.05.07 16:37 신고

    저는 왜 19번 부터 안돼죠? 모듈이 안나옵니다 ㅠㅠ

    • 초보2
      2018.10.13 04:33 신고

      저두 같은데 .. 해결하셨나여 ?

  • 한명진
    2018.05.26 07:56 신고

    덕분에 쉽게 잘 따라왔습니다.
    감사합니다.
    그런데 공중파 채널이 다중으로 잡히길래
    실제로 보려는 채널빼곤 삭제했는데
    조금 지나면 다시 원래대로 돌아가는데
    무슨 방법이 없을까요 ?

  • 황영민
    2018.06.02 14:23 신고

    정말 유용합니다.
    기존에 패키지센터의 TVh를 이용할때 내부채널정보 가져오는게 안되어서 포기를 했는데
    도커를 이용해서 위 설명대로 하니 잘됩니다. 한가지 제가 추가한건 위에 채널정보를 복사 붙여넣기할때
    자기한테 맞는 IPTV 사업자를 넣어야 해서 저는 KT로 바꾸었구요.
    그레버 모듈에서 KT랑 내부XMLTV : Korea (epg2xml)도 같이 열어주니 땡겨오네요 ^^

  • 빛틀
    2018.06.06 22:38 신고

    댓글을 안 남길 수가 없네요.

    저같은 초보에게 정말 한줄기 희망을 주는 진정한 매뉴얼입니다.

    너무 자세하게 설명돼 있어서 정말 좋았습니다. 감사합니다.

  • 2018.06.09 00:40

    비밀댓글입니다

  • 2018.06.13 23:01

    비밀댓글입니다

  • 어진웅
    2018.06.13 23:01 신고

    kt인데 28번에처럼 채널을 읽어오지못하네요 ㅜㅜ혹시..실례가안되면다면 도움요청부탁드릴게요...사례는 해드리겠습니다...이거때문에 삿는데...이걸못만지고있어요 ㅜㅜ

    parting621
    카톡...으로..배울수있을까요..

  • 새구
    2018.06.25 15:26 신고

    너무 감사합니다. 예전에 한번 포기했는데, 덕분에 EPG 빼고, 잘 실행되네요
    너무너무 감사드립니다.

    • 새구
      2018.06.27 11:02 신고

      하다보니 epg도 성공했습니다.
      감사합니다

  • 김민기
    2018.06.26 22:09 신고

    덕분에 잘 보고 실행했습니다. 이틀이나 걸려서 하긴했는데 epg 채널정보는 안나오네요.

    그래도 여기까지 올수 있게 도와주셔서 너무 감사드려요~ ^^

  • 다큰아이츄
    2018.06.29 15:15 신고

    15번까지 순조롭게 잘 따라왔는데 로컬:9981 초기화면이 안떠서 막히네요.
    공유기 포트포워딩에도 9981~9982 설정도 해주었습니다.
    확인해볼 부분이 있을까요?
    ----------------------------------------------
    나스 자체 포트 방화벽 설정에 추가 하여 해결 됐습니다. 감사합니다.

    • 초보
      2018.10.15 16:58 신고

      혹시 설정하는방법좀 알려주실 수 있을까요?

      그리고 로컬주소라는게..퀵 주소인가요?

  • 감사합니다
    2018.06.30 02:40 신고

    덕분에 잘 따라할수 있었습니다.

  • 폴리76
    2018.07.05 12:45 신고

    이치로님. 덕분에 docker를 제대로 써볼 수 있게 되었습니다. 감사합니다.
    다름이 아니라, USB TV 수신카드를 연결해서 사용도 가능할까요?
    회사라 IPTV가 없어서 USB TV 수신카드로 수년전 구현해서 사용했었는데... docker로도 가능하면 좋을 것 같습니다.

  • 워니
    2018.07.16 07:14 신고

    저는 KT 인데 왜 채널번호와 epg 내용이 다르게 맞춰질까요?

  • 시골닭
    2018.07.17 21:31 신고

    먼저 유익한 정보 감사 드립니다.
    알려 주신데로 27번까지 잘 따라왔는데,
    28번에서 먹스,서비스,매핑정보가 불러와지지 않고 있습니다.
    혹시 가이드좀 주실수 있으신지요?
    LG U+를 사용하고 있습니다.

    • 헐..
      2018.10.16 01:38 신고

      저랑같네요..저도 유플..
      불러오질 못하네요.ㅠㅠ

      dogcat 같이 배워봅시다 카톡친추해주세요

  • 쵸키
    2018.07.19 09:56 신고

    27 성공햇고요
    먹스 서비스. 불러왓는데
    매핑. 불러오지. 못합니다.
    도움 요청 드립니다

  • 미니맵
    2018.07.31 12:03 신고

    큐냅 TS-251 사용중인데 덕분에 docker 이용해서 Tvheadend 녹화까지 완벽하게 구성 했습니다.
    정말 감사합니다. 훌륭한 포스팅이에요!

  • 주녀리
    2018.08.13 16:37 신고

    30번까지 잘 따라같는데.
    31번에서 EPG 그래버채널이 업데이트가 안됩니다.
    무엇을 잘못한건지.ㅠㅠ
    root 권한 처리 부터 다시 진행해 봐야할 것 같습니다.
    좋은 정보 정리 감사드립니다.

  • Joy
    2018.08.24 08:23 신고

    도움덕분에 잘 설정 마쳤습니다.
    docker 이용하는게 더쉽긴한데 메모리를 6백메가 사용하네요?(tvhe자체는 30메가정도긴하지만 도커자체가 500메가 넘는군요)
    TvhE패키지설치로 하는 거보다 리소스를 더먹나요?

  • ccarts
    2018.10.30 15:13 신고

    우선 좋은정보 공유 감사드립니딘

    위의방벙으로 EPG 채널 설정 정보까지는 어렵게 따라했는데
    KODI 에서 tvheadend 설정하면 epg 내용 채널 정보는 따라오늘데 채널 이미지가 안따라와용 ㅠㅠ

    tvheadend 속에서는 이미지 경로 정보 누르면 정상적으로
    나오는데요 무엇이 문제일까요?

Designed by JB FACTORY

티스토리 툴바