這些指南將產業的概念對應到平台目前具備的物件(頻道包、線路、方案、合作夥伴帳號、節點、API)。這些是概念上的對應,並非產業專屬功能,而且合作夥伴帳號是委派帳號,不是隔離的租戶。
概念對應
面板裡沒有任何東西叫訂閱或接入點。下表說明哪個物件扮演哪個角色;以下各章依該順序進行設定。
| 在您的產業中 | 在平台上 | 在面板中的位置 |
|---|---|---|
| 經銷商或區域合作夥伴帳號 | 合作夥伴帳號(經銷商):具備點數、權限與自己線路的委派 dashboard | Users → 新增經銷商;其權限在 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 安裝 |
前置條件
安裝前需要準備什麼。
- 核心機房裡的一台伺服器(Ubuntu 22.04 或 24.04)、安裝程式、用戶可連線的網域或位址,以及每個接入點用於部署節點的一台伺服器。
- 取得授權的頻道訊號、VOD 片庫,以及訂閱所在的計費系統。
- 關於級別、計費週期多長,以及哪些經銷商取得合作夥伴帳號的決定。
基礎架構部署
先部署核心機房,再部署各接入點。
- 在核心伺服器上執行安裝程式;將面板放在您的反向代理之後並設定 TRUSTED_PROXIES,使日誌與 IP 規則能看到用戶的真實位址。
- 將播放基底網址設為用戶連線的公開位址,並在伺服器上設定授權金鑰。
- 從 Servers 為每個接入點登錄一個節點;面板會透過 SSH 安裝它,或節點以一次性代碼登錄,並將靠近它的用戶導向它。
- 為客服或計費團隊建立一個僅擁有線路權限的合作夥伴帳號(reseller)。
內容整理
級別與附加包是頻道包。
- 在 Streams 下新增頻道,在 Movies 與 Series 下新增 VOD 片庫,並設定分類與 EPG 來源。
- 為基本頻道包、付費頻道與 VOD 片庫建立頻道包。
- 每個訂閱級別建立一個方案:它授予的頻道包、作為時效的計費週期,以及以點數計的價格。
- 為促銷或新客戶建立一個較短的試用方案。
合作夥伴(經銷商)設定
使用點數的經銷商。
- 為經銷商建立一個群組,擁有管理自己線路的權限,不能存取目錄或設定。
- 將每位區域經銷商新增為合作夥伴帳號,使用該群組、其可銷售的方案與點數餘額;一位經銷商最多可有五層子 reseller。
- webhook credits.low 與低點數通知會提醒經銷商在停止銷售之前儲值。
用戶線路設定
每個訂閱一條線路。
- 訂閱開始時,計費系統透過連接器,或透過 Reseller API 的 action=create_line 搭配該級別的方案與請求 ID,建立一條線路。
- 依級別設定最大連線數,即一個家庭可同時使用的螢幕數。
- 當產品僅限您的網路使用時,將線路綁定到用戶的位址、國家或 ISP。
- 試行或處理客服個案時,透過 Lines → add 新增線路並發放憑證。
VOD 片庫
隨選目錄。
- 新增含季與集的電影與影集,以 VOD 匯入工作匯入或上傳,並以 TMDB 中繼資料提供海報與說明。
- 依級別或附加包把內容歸入頻道包,使方案恰好授予訂閱所含的內容。
- 節點會快取 VOD 檔案,因此熱門內容由靠近用戶的接入點提供。
直播頻道
頻道包。
- 在 Streams 下新增每個取得授權的頻道及其訊號,並僅在權利允許之處啟用回看或時移。
- 新增一個 EPG 來源,讓應用程式與機上盒顯示節目表。
- 每個節點只從來源伺服器拉取一次直播頻道,再分送給它的用戶。
到期、續期與取消
計費週期就是線路的有效期。
- 線路在其方案期間內有效;計費系統在每個週期以 action=renew_line 或透過連接器為其續期。
- 訂閱失效或被取消時,計費系統呼叫 action=disable_line,重新啟用時再啟用該線路。
- 讓計費系統訂閱 webhook,以將即將到期與已到期的線路與其紀錄核對。
與計費系統整合
由計費系統驅動存取,由播放器負責播放。
- 在計費系統端安裝其連接器(WHMCS、Blesta、Odoo 等),或從您自己的系統以金鑰與請求 ID 呼叫 Reseller API。
- 沒有面向觀眾的單一登入:用戶使用線路的憑證登入應用程式或機上盒,計費系統可以在客戶中心顯示這些憑證。
- 為報表工具使用帶唯讀旗標、IP 允許清單與到期日的 Admin API 金鑰。
安全考量
讓服務只留給用戶。
- 將面板放在具 TLS 的反向代理之後並設定 TRUSTED_PROXIES;讓節點的管理流量走專用網路。
- 每個面板帳號使用雙重驗證登入,為客服與經銷商設定權限群組;在登入頁啟用 reCAPTCHA 或 Turnstile。
- 播放連結經過簽章並會過期,每個訂閱設定連線數上限,並在合適時綁定位址、國家或 ISP。
- 加密的資料庫備份並保留異地副本,以稽核日誌記錄線路與點數的每一次變更。
疑難排解
常見的初步檢查。
- 某位用戶沒有電視:檢查線路已啟用且未到期,然後在 Reseller API 呼叫日誌中檢查計費系統的呼叫。
- 某個級別缺少一個頻道:檢查該級別方案的頻道包。
- 某個接入點卡頓:檢查其節點的心跳以及其用戶是否已導向它。
- 經銷商無法建立線路:檢查其點數,以及該方案是否在其可銷售範圍內。