首頁
XtreamUIPro

設定指南

電信與 ISP 部署指南

將平台設定為電信業者的電視服務:位於接入點節點上的頻道包與 VOD 片庫、由計費系統驅動的用戶線路,以及使用點數的經銷商。

這些指南將產業的概念對應到平台目前具備的物件(頻道包、線路、方案、合作夥伴帳號、節點、API)。這些是概念上的對應,並非產業專屬功能,而且合作夥伴帳號是委派帳號,不是隔離的租戶。

概念對應

面板裡沒有任何東西叫訂閱或接入點。下表說明哪個物件扮演哪個角色;以下各章依該順序進行設定。

在您的產業中在平台上在面板中的位置
經銷商或區域合作夥伴帳號合作夥伴帳號(經銷商):具備點數、權限與自己線路的委派 dashboardUsers → 新增經銷商;其權限在 Groups 設定
頻道級別或附加包頻道包(bouquet):由方案授予的一組具名頻道、電影或影集Bouquets,由 Streams 與 Movies / Series 建立
電視頻道直播頻道:含來源、EPG 與輸出格式的串流Streams → 新增直播串流(來源 URL 或 RTMP 推流)
VOD 片庫VOD 內容目錄:電影與含季和集的影集、分類與中繼資料Movies 與 Series,或 VOD 匯入工作
用戶的電視存取權線路:一份存取權,含其方案、頻道包、到期日、連線數上限與輸出Lines → 新增,或使用啟用碼,或 Reseller API
計費週期結束線路的到期日,可由方案、點數或 API 續期線路的到期日與方案的期限
每個訂閱的螢幕數線路的最大連線數:可同時觀看的裝置數量線路的最大連線數
計費與佈建整合Reseller API 與 webhook:從您自己的系統執行面板的各項操作經銷商 dashboard 中的 Reseller API 金鑰與 webhook
接入點節點串流節點:從面板登錄的邊緣伺服器,每個據點或建築一個Servers → 新增節點,透過 SSH 安裝

前置條件

安裝前需要準備什麼。

  1. 核心機房裡的一台伺服器(Ubuntu 22.04 或 24.04)、安裝程式、用戶可連線的網域或位址,以及每個接入點用於部署節點的一台伺服器。
  2. 取得授權的頻道訊號、VOD 片庫,以及訂閱所在的計費系統。
  3. 關於級別、計費週期多長,以及哪些經銷商取得合作夥伴帳號的決定。

基礎架構部署

先部署核心機房,再部署各接入點。

  1. 在核心伺服器上執行安裝程式;將面板放在您的反向代理之後並設定 TRUSTED_PROXIES,使日誌與 IP 規則能看到用戶的真實位址。
  2. 將播放基底網址設為用戶連線的公開位址,並在伺服器上設定授權金鑰。
  3. 從 Servers 為每個接入點登錄一個節點;面板會透過 SSH 安裝它,或節點以一次性代碼登錄,並將靠近它的用戶導向它。
  4. 為客服或計費團隊建立一個僅擁有線路權限的合作夥伴帳號(reseller)。

內容整理

級別與附加包是頻道包。

  1. 在 Streams 下新增頻道,在 Movies 與 Series 下新增 VOD 片庫,並設定分類與 EPG 來源。
  2. 為基本頻道包、付費頻道與 VOD 片庫建立頻道包。
  3. 每個訂閱級別建立一個方案:它授予的頻道包、作為時效的計費週期,以及以點數計的價格。
  4. 為促銷或新客戶建立一個較短的試用方案。

合作夥伴(經銷商)設定

使用點數的經銷商。

  1. 為經銷商建立一個群組,擁有管理自己線路的權限,不能存取目錄或設定。
  2. 將每位區域經銷商新增為合作夥伴帳號,使用該群組、其可銷售的方案與點數餘額;一位經銷商最多可有五層子 reseller。
  3. webhook credits.low 與低點數通知會提醒經銷商在停止銷售之前儲值。

用戶線路設定

每個訂閱一條線路。

  1. 訂閱開始時,計費系統透過連接器,或透過 Reseller API 的 action=create_line 搭配該級別的方案與請求 ID,建立一條線路。
  2. 依級別設定最大連線數,即一個家庭可同時使用的螢幕數。
  3. 當產品僅限您的網路使用時,將線路綁定到用戶的位址、國家或 ISP。
  4. 試行或處理客服個案時,透過 Lines → add 新增線路並發放憑證。

VOD 片庫

隨選目錄。

  1. 新增含季與集的電影與影集,以 VOD 匯入工作匯入或上傳,並以 TMDB 中繼資料提供海報與說明。
  2. 依級別或附加包把內容歸入頻道包,使方案恰好授予訂閱所含的內容。
  3. 節點會快取 VOD 檔案,因此熱門內容由靠近用戶的接入點提供。

直播頻道

頻道包。

  1. 在 Streams 下新增每個取得授權的頻道及其訊號,並僅在權利允許之處啟用回看或時移。
  2. 新增一個 EPG 來源,讓應用程式與機上盒顯示節目表。
  3. 每個節點只從來源伺服器拉取一次直播頻道,再分送給它的用戶。

到期、續期與取消

計費週期就是線路的有效期。

  1. 線路在其方案期間內有效;計費系統在每個週期以 action=renew_line 或透過連接器為其續期。
  2. 訂閱失效或被取消時,計費系統呼叫 action=disable_line,重新啟用時再啟用該線路。
  3. 讓計費系統訂閱 webhook,以將即將到期與已到期的線路與其紀錄核對。

與計費系統整合

由計費系統驅動存取,由播放器負責播放。

  1. 在計費系統端安裝其連接器(WHMCS、Blesta、Odoo 等),或從您自己的系統以金鑰與請求 ID 呼叫 Reseller API。
  2. 沒有面向觀眾的單一登入:用戶使用線路的憑證登入應用程式或機上盒,計費系統可以在客戶中心顯示這些憑證。
  3. 為報表工具使用帶唯讀旗標、IP 允許清單與到期日的 Admin API 金鑰。

安全考量

讓服務只留給用戶。

  1. 將面板放在具 TLS 的反向代理之後並設定 TRUSTED_PROXIES;讓節點的管理流量走專用網路。
  2. 每個面板帳號使用雙重驗證登入,為客服與經銷商設定權限群組;在登入頁啟用 reCAPTCHA 或 Turnstile。
  3. 播放連結經過簽章並會過期,每個訂閱設定連線數上限,並在合適時綁定位址、國家或 ISP。
  4. 加密的資料庫備份並保留異地副本,以稽核日誌記錄線路與點數的每一次變更。

疑難排解

常見的初步檢查。

  1. 某位用戶沒有電視:檢查線路已啟用且未到期,然後在 Reseller API 呼叫日誌中檢查計費系統的呼叫。
  2. 某個級別缺少一個頻道:檢查該級別方案的頻道包。
  3. 某個接入點卡頓:檢查其節點的心跳以及其用戶是否已導向它。
  4. 經銷商無法建立線路:檢查其點數,以及該方案是否在其可銷售範圍內。