這些指南將產業的概念對應到平台目前具備的物件(頻道包、線路、方案、合作夥伴帳號、節點、API)。這些是概念上的對應,並非產業專屬功能,而且合作夥伴帳號是委派帳號,不是隔離的租戶。
概念對應
面板中沒有任何東西叫做部門或員工。此表說明哪個物件扮演哪個角色;以下各章依此順序進行設定。
| 在您的產業中 | 在平台上 | 在面板中的位置 |
|---|---|---|
| 部門培訓集 | 頻道包(bouquet):由方案授予的一組具名頻道、電影或影集 | Bouquets,由 Streams 與 Movies / Series 建立 |
| 培訓教材 | VOD 內容目錄:電影與含季和集的影集、分類與中繼資料 | Movies 與 Series,或 VOD 匯入工作 |
| 員工存取權 | 線路:一份存取權,含其方案、頻道包、到期日、連線數上限與輸出 | Lines → 新增,或使用啟用碼,或 Reseller API |
| 內部培訓課程 | 直播頻道:含來源、EPG 與輸出格式的串流 | Streams → 新增直播串流(來源 URL 或 RTMP 推流) |
| HR 或 LMS 整合 | Reseller API 與 webhook:從您自己的系統執行面板的各項操作 | 經銷商 dashboard 中的 Reseller API 金鑰與 webhook |
| 每位員工的裝置數 | 線路的最大連線數:可同時觀看的裝置數量 | 線路的最大連線數 |
前置條件
安裝前需要準備的項目。
- 各辦公室都可連到的一台公司伺服器(Ubuntu 22.04 或 24.04)、安裝程式,以及位於反向代理之後的內部位址或網域。
- 培訓錄影、供直播會議使用的大禮堂編碼器,以及 HR 或 LMS 系統呼叫 HTTP API 的能力。
- 針對機密性的決定:哪些教材放進哪個部門集合,以及 HR 與培訓團隊中誰會取得面板帳號。
基礎架構部署
先總部,再辦公室。
- 在總部伺服器上執行安裝程式;將面板放在公司的反向代理之後,並設定受信任代理,讓稽核記錄看到真實位址。
- 將播放基底網址設為內部位址;網路之外的員工透過 VPN 或代理連入。
- 從 Servers 為每間辦公室登錄一個節點;面板會透過 SSH 安裝它,並將該辦公室的觀眾導向它。
- 為培訓團隊建立一個合作夥伴帳號,授予內容目錄的權限,但不授予員工線路的權限。
內容整理
依部門的集合,課程作為影集。
- 依主題建立分類,每個多章節課程一部影集,每場課程一集。
- 為每個部門培訓集合建立一個頻道包,另建一個全體員工頻道包,放置所有人都能看到的教材。
- 為每個職務建立一個方案:只包含該職務所需的頻道包,不含其他,並設定較長的期限(例如一年)作為存取期間;續期會再增加一個期間,合約結束時由 HR 停用線路。
- 在名稱中清楚標示機密集合;一條線路只能看到其方案所授予的頻道包。
合作夥伴(經銷商)設定
培訓團隊,以及集團中的各子公司。
- 為培訓團隊建立一個具內容目錄權限的群組,並為 HR 建立一個具線路權限的群組。
- 將培訓團隊與 HR 以這些群組新增為經銷商;在內部部署中兩者都不需要點數。
- 擁有自己資料庫的子公司,取得自己的經銷商、自己的頻道包與自己的方案。
員工存取權設定
每位員工一條線路,由 HR 建立。
- 為 HR 系統建立一把 Reseller API 金鑰,並儲存在 HR 系統的機密資料中。
- 到職時,HR 系統以該職務的方案和請求 ID 呼叫 action=create_line(方案的期限即為存取期間);離職時呼叫 action=disable_line。
- 將最大連線數設為員工可使用的裝置數(通常為兩台:桌機與手機)。
- 試行階段,可從 Lines → 新增線路,並把憑證交給少數員工。
培訓教材
隨選錄影。
- 將每份錄影上傳為某一集的來源,或用 VOD 匯入工作匯入;保留標題與簡短說明。
- 透過其影集,把錄影歸入正確的部門頻道包。
- 以每個職務的測試線路檢查播放,確認誰能看到什麼。
內部培訓課程
將一場課程作為直播頻道。
- 為大禮堂的編碼器新增一個直播串流(RTMP 推流);把它放進全體員工頻道包或某個部門的頻道包。
- 啟用回看,讓晚進場的人可以倒轉,並在事後將錄影上傳到資料庫。
- 各辦公室的節點只向來源伺服器取用該場課程一次,並在本地服務其人員。
存取到期
存取權隨合約結束。
- 線路在其方案的期間結束時到期;合約期間由 HR 以 action=renew_line 續期,合約結束時由 HR 停用。
- 讓 HR 系統訂閱 webhook,以便將即將到期與已到期的線路與其自身紀錄核對。
- 臨時存取(外包人員、到職週)請使用較短的到期日,而非另設獨立方案。
與 HR 或 LMS 整合
由系統控制存取權;由播放器負責播放。
- HR 透過 Reseller API 建立、續期並停用線路;LMS 可從課程頁面連結到網頁播放器。
- 觀眾沒有單一登入:員工以您的系統核發的線路憑證登入播放器。
- 內部報表工具請使用設有唯讀旗標的 Admin API 金鑰。
安全考量
從網路到線路的機密性。
- 將平台放在內部網路,或放在具 TLS 的反向代理之後;並相應設定 TRUSTED_PROXIES。
- 每個面板帳號都使用雙重驗證登入;以權限群組確保 HR 無法變更內容目錄,培訓團隊也看不到線路。
- 簽章且會過期的播放連結、每條線路較低的連線數上限,以及在裝置固定時綁定位址。
- 加密的資料庫備份並保留異地副本;稽核記錄會記下對線路與內容目錄的每一次變更。
疑難排解
常見的初步檢查。
- 員工看到其他部門的教材:檢查該線路的方案及其授予的頻道包。
- 新進員工沒有存取權:檢查 HR 的呼叫是否成功(Reseller API 的呼叫記錄)以及線路的到期日。
- 直播會議期間某間辦公室出現緩衝:檢查該辦公室節點的心跳,以及觀眾是否被導向它。
- 稽核記錄顯示的是代理的位址:將 TRUSTED_PROXIES 設為該代理並重新啟動面板。