這些指南將產業的概念對應到平台目前具備的物件(頻道包、線路、方案、合作夥伴帳號、節點、API)。這些是概念上的對應,並非產業專屬功能,而且合作夥伴帳號是委派帳號,不是隔離的租戶。
概念對應
面板裡沒有任何東西叫門市或加盟商。下表說明哪個物件扮演哪個角色;以下各章依該順序進行設定。
| 在您的產業中 | 在平台上 | 在面板中的位置 |
|---|---|---|
| 門市頻道或訓練專藏 | 頻道包(bouquet):由方案授予的一組具名頻道、電影或影集 | Bouquets,由 Streams 與 Movies / Series 建立 |
| 門市頻道 | 直播頻道:含來源、EPG 與輸出格式的串流 | Streams → 新增直播串流(來源 URL 或 RTMP 推流) |
| 訓練與產品影片 | VOD 內容目錄:電影與含季和集的影集、分類與中繼資料 | Movies 與 Series,或 VOD 匯入工作 |
| 門市螢幕或員工的存取權 | 線路:一份存取權,含其方案、頻道包、到期日、連線數上限與輸出 | Lines → 新增,或使用啟用碼,或 Reseller API |
| 加盟商帳號 | 合作夥伴帳號(經銷商):具備點數、權限與自己線路的委派 dashboard | Users → 新增經銷商;其權限在 Groups 設定 |
| 區域節點 | 串流節點:從面板登錄的邊緣伺服器,每個據點或建築一個 | Servers → 新增節點,透過 SSH 安裝 |
| 每條線路的螢幕或裝置數 | 線路的最大連線數:可同時觀看的裝置數量 | 線路的最大連線數 |
前置條件
安裝前需要準備什麼。
- 總部的一台伺服器(Ubuntu 22.04 或 24.04)、安裝程式,以及門市較多的每個區域一台能從門市連線的伺服器。
- 門市頻道的內容(編碼器或循環播放來源)、到職與產品訓練的錄影,以及門市裡的螢幕或媒體播放器。
- 關於加盟結構的決定:哪些區域設節點,以及每位加盟商中由誰管理線路。
基礎架構部署
先部署總部,再部署各區域。
- 在總部伺服器上執行安裝程式,並將播放基底網址設為門市可以連線的、啟用了 TLS 的位址。
- 在 Streams 下新增門市頻道,在 Movies 下新增訓練錄影,並在網頁播放器中確認。
- 從 Servers 為每個區域登錄一個節點;面板會透過 SSH 安裝它,或節點以一次性代碼登錄,並將該區域的門市導向它。
- 為總部內容團隊建立一個擁有目錄權限、沒有門市線路權限的合作夥伴帳號。
內容整理
門市頻道與訓練片庫。
- 為門市頻道建立一個直播串流,並放入它自己的頻道包。
- 依主題建立分類,每門訓練課程一部影集,每堂課一集;每個職務(銷售人員、經理、新進員工)再建立一個頻道包。
- 為門市螢幕建立一個方案,每個職務再建立一個方案,各自授予其頻道包,並以存取期間作為時效。
- 給加盟商他們可以轉售給門市與員工的方案。
合作夥伴(經銷商)設定
每位加盟商一個合作夥伴帳號。
- 建立一個權限僅限線路、不能更改目錄的群組。
- 在 Users → add a reseller 下新增每位加盟商,使用該群組、其方案與點數餘額。
- 擁有多個區域的加盟商可以為每個區域新增一個子 reseller,各有自己的門市。
門市與職員線路設定
每面螢幕、每位員工一條線路。
- 在 Lines → add 下為每面門市螢幕建立一條線路,以門市名稱命名,使用門市方案;加盟商為自己的門市做同樣的事。
- 將最大連線數設為門市的螢幕數量,員工則設為兩個(賣場與手機)。
- 門市有固定位址時,將門市線路綁定到該位址,這樣憑證在別處無法使用。
- 一次性設定螢幕的播放器(M3U、Xtream Codes API 或網頁播放器位址),並把憑證儲存在門市的檔案中。
訓練與產品影片
面向職員的片庫。
- 將每門訓練課程作為影集上傳,將每部產品影片作為電影上傳,或以 VOD 匯入工作將其匯入媒體根目錄。
- 透過分類把錄影放入對應職務的頻道包。
- 在向加盟商開放片庫之前,以測試線路檢查每個職務看得到什麼。
門市頻道
一個頻道供所有螢幕使用。
- 將門市頻道新增為直播串流,由總部的編碼器透過 RTMP 供流,或使用循環播放來源。
- 對現場直播的訓練課程啟用回看,並在之後把錄影上傳到片庫。
- 各區域的節點只從來源伺服器拉取一次該頻道並服務各自的門市,因此門市的連線不會被占滿。
到期與續期
存取權跟隨門市或合約。
- 線路在其方案期間結束時到期;加盟商以方案或點數為其續期。
- 停用已關閉門市或離職員工的線路。
- 讓加盟管理或人力資源系統訂閱 webhook,以查看即將到期或已到期的線路。
與加盟或人力資源系統整合
由系統驅動線路,由播放器負責播放。
- 為加盟管理或人力資源系統建立一個 Reseller API 金鑰;它呼叫 create_line、renew_line、enable_line 與 disable_line,每次寫入都帶有請求 ID。
- 向加盟商收取服務費用時使用電商連接器;其他系統使用 Reseller API 與 webhook。
- 沒有面向觀眾的單一登入:員工使用其線路的憑證登入播放器。
安全考量
讓每家門市只使用自己的線路。
- 將面板放在具 TLS 的反向代理之後並設定 TRUSTED_PROXIES,使稽核日誌與 IP 規則能看到真實位址。
- 每個總部帳號使用雙重驗證登入;加盟商取得僅限自己線路的權限群組。
- 每條線路設定連線數上限,播放連結經過簽章並會過期,門市螢幕綁定位址。
- 啟用附異地副本的加密資料庫備份,並以稽核日誌檢視線路與目錄的變更。
疑難排解
常見的初步檢查。
- 某面門市螢幕黑畫面:檢查其線路已啟用且未到期、位址綁定,以及第二台裝置使用該線路時的連線數上限。
- 某個區域卡頓:檢查區域節點的心跳以及門市是否已導向它。
- 加盟商無法建立線路:檢查其點數餘額、群組權限以及分配給它的方案。
- 稽核日誌顯示的是代理的位址:將 TRUSTED_PROXIES 設為該代理並重新啟動面板。