이 가이드는 산업의 개념을 플랫폼에 현재 있는 객체(부케, 라인, 패키지, 파트너 계정, 노드, API)에 대응시킵니다. 이는 개념적 대응이며 산업 전용 기능이 아닙니다. 또한 파트너 계정은 위임 계정이며 격리된 테넌트가 아닙니다.
개념적 대응
패널에는 세대나 주민이라는 이름의 항목이 없습니다. 표는 어떤 객체가 어떤 역할을 하는지 보여주며, 아래 장들은 그 순서대로 설정합니다.
| 내 산업에서는 | 플랫폼에서는 | 패널에서의 위치 |
|---|---|---|
| 시설 관리자 계정 | 파트너 계정(리셀러): 크레딧, 권한, 자체 라인을 가진 위임 대시보드 | Users → 리셀러 추가, 권한은 Groups에서 설정 |
| 채널 구성 | 부케: 패키지가 부여하는 채널, 영화, 시리즈의 이름 있는 묶음 | Bouquets, Streams와 Movies / Series에서 생성 |
| 채널 또는 안내 채널 | 실시간 채널: 소스, EPG, 출력 형식을 가진 스트림 | Streams → 실시간 스트림 추가(소스 URL 또는 RTMP 푸시) |
| 환영·공지 영상 | VOD 카탈로그: 시즌과 에피소드가 있는 영화와 시리즈, 카테고리, 메타데이터 | Movies와 Series, 또는 VOD 인제스트 작업 |
| 세대 액세스 | 라인: 패키지, 부케, 만료일, 연결 제한, 출력을 가진 하나의 액세스 | Lines → 추가, 또는 활성화 코드, 또는 Reseller API |
| 임대 또는 거주 기간 | 라인의 만료일. 패키지, 크레딧 또는 API로 갱신됩니다 | 라인의 만료일과 패키지의 기간 |
| 건물 노드 | 스트리밍 노드: 패널에서 등록하는 엣지 서버. 현장 또는 건물당 하나 | Servers → 노드 추가(SSH로 설치) |
사전 준비
설치 전에 준비할 것.
- 관리사무소용 서버(Ubuntu 22.04 또는 24.04), 설치 프로그램, 주민 네트워크에 접속할 수 있는 건물별 서버.
- 단지가 재송신할 수 있는 채널 피드(풀 URL 또는 RTMP), 관리사무소의 공지와 환영 영상, 주민의 기기(셋톱박스, 플레이어 앱이 있는 스마트 TV, 또는 브라우저).
- 세대 유형(표준, 시니어, 학생)에 대한 결정과, 관리사무소에서 누가 라인을 열고 갱신할지에 대한 결정.
인프라 구축
중앙 서버, 그다음 건물마다 노드.
- 중앙 서버에서 설치 프로그램을 실행하고 재생 기본 주소를 각 건물에서 접속할 수 있는 주소로 설정합니다.
- 채널 피드를 Streams에, 공지를 Movies에 추가하고 웹 플레이어에서 확인합니다.
- Servers에서 건물마다 노드를 등록합니다. 패널이 SSH로 설치하거나 노드가 일회용 코드로 등록하며, 그 건물의 주민을 노드로 보냅니다.
- Users → 리셀러 추가에서 시설 관리자를 추가하고, 라인은 허용하되 카탈로그 변경은 허용하지 않는 그룹을 지정합니다.
콘텐츠 정리
세대 유형별 채널 구성.
- 세대 유형별 채널로 구성마다 부케 하나를 만들고, 관리사무소 안내용 부케도 하나 만듭니다.
- 안내 부케를 모든 패키지에 추가해 모든 주민이 공지를 받게 합니다.
- 세대 유형마다 해당 부케와, 임대 또는 거주 기간에 맞는 기간을 가진 패키지 하나를 만듭니다.
- 텔레비전의 메뉴가 잘 보이도록 채널의 순서를 정하고 로고를 지정합니다.
파트너(리셀러) 설정
시설 관리자를 위임된 계정으로.
- 라인으로 권한을 제한하고 카탈로그나 서버에는 접근할 수 없는 그룹을 만듭니다.
- 각 시설 관리자를 그 그룹, 담당 세대의 패키지, 크레딧 잔액을 가진 리셀러로 추가합니다.
- 여러 건물을 관리하는 관리자는 건물마다 서브 리셀러를 추가할 수 있으며, 각각 자기 세대와 크레딧을 가집니다.
세대(라인) 설정
세대마다 라인 하나, 호수로 이름 붙이기.
- Lines → 추가에서 세대마다 라인 하나를 만들고, 이름은 호수로, 패키지는 해당 세대 유형의 것으로 지정합니다.
- 최대 연결 수를 세대 안의 텔레비전 수로 설정합니다.
- 주민이 기기에서 짧은 코드를 입력하게 하려면 비밀번호 대신 활성화 코드를 사용합니다.
- 기기는 한 번만 설정합니다(라인의 자격 증명을 쓰는 Xtream Codes API 또는 M3U, 혹은 MAG나 Enigma2 포털). 자격 증명은 라인에 새 자격 증명을 줄 때까지 그 세대에 남습니다.
환영·공지 영상
관리사무소의 영상을 주문형으로.
- 환영 영상, 주거 규칙, 보수 안내를 영화로 업로드하고 주제별 카테고리를 붙입니다.
- 이를 안내 부케에 넣어 모든 패키지에 포함되게 합니다.
- 정보가 바뀌면 패널에서 영상을 교체합니다. 주민에게는 새 버전이 바로 보입니다.
채널과 안내 채널
채널 구성과 공지 채널을 실시간 스트림으로.
- Streams에서 라이선스를 받은 각 채널을 피드와 함께 추가하고, 텔레비전의 가이드에 프로그램이 표시되도록 EPG 소스를 추가합니다.
- 안내 채널을 RTMP 인코더 또는 반복 소스가 공급하는 실시간 스트림으로 추가하고 안내 부케에 넣습니다.
- 지역 제한이 있는 채널은 해당 패키지만 부여하는 부케에 둡니다.
입주, 퇴거, 만료
거주 기간이 곧 라인의 유효 기간.
- 라인은 패키지 기간이 끝나면 만료됩니다. 임대의 새 기간마다 패키지 또는 크레딧으로 갱신합니다.
- 주민이 퇴거하면 라인을 비활성화합니다. 다음 주민은 새 자격 증명으로 다시 활성화하므로 이전 가구에 남는 것이 없습니다.
- 주거 관리 시스템이나 관리자를 웹훅에 등록해 만료가 임박했거나 이미 만료된 라인을 확인합니다.
주거 관리·청구 시스템과의 연동
시스템이 액세스를 열고 플레이어가 재생합니다.
- 주거 관리 또는 청구 시스템용 Reseller API 키를 만듭니다. 이 시스템이 create_line, renew_line, enable_line, disable_line을 호출하고 쓰기마다 요청 ID를 보냅니다.
- 주민이 추가 패키지를 온라인으로 구매한다면 커머스 커넥터를 사용합니다. 다른 시스템은 Reseller API와 웹훅을 사용합니다.
- 시청자용 싱글 사인온은 없습니다. 주민은 라인의 자격 증명으로 플레이어에 로그인합니다.
보안 고려 사항
서비스를 단지 안에 둡니다.
- 패널은 TLS가 적용된 리버스 프록시 뒤에서 제공하고 TRUSTED_PROXIES를 설정해 감사 로그와 IP 규칙이 실제 주소를 보게 합니다.
- 모든 관리 계정에 2단계 로그인을 적용하고, 시설 관리자에게는 라인으로 제한된 권한 그룹을 부여합니다.
- 라인별 연결 제한, 서명되고 만료되는 재생 링크, 기기에 고정 주소가 있는 경우의 주소 고정.
- 오프사이트 사본이 있는 암호화된 데이터베이스 백업을 켜세요. 라인의 자격 증명이 그 안에 있습니다.
문제 해결
가장 먼저 확인할 일반적인 항목.
- 세대에서 텔레비전이 나오지 않음: 라인이 활성 상태이고 만료되지 않았는지 확인한 다음, 기기의 자격 증명과 재생 주소를 확인합니다.
- 저녁에 건물에서 버퍼링: 건물 노드의 하트비트와 주민이 그 노드로 연결되는지 확인합니다.
- 한 세대 유형에서 채널이 없음: 그 패키지의 부케를 확인합니다.
- 관리자가 라인을 만들지 못함: 리셀러의 크레딧 잔액, 그룹 권한, 배정된 패키지를 확인합니다.