這些指南將產業的概念對應到平台目前具備的物件（頻道包、線路、方案、合作夥伴帳號、節點、API）。這些是概念上的對應，並非產業專屬功能，而且合作夥伴帳號是委派帳號，不是隔離的租戶。
概念對應
面板裡沒有任何東西叫住戶或居民。下表說明哪個物件扮演哪個角色；以下各章依該順序進行設定。
| 在您的產業中 | 在平台上 | 在面板中的位置 |
|---|---|---|
| 物業管理員帳號 | 合作夥伴帳號（經銷商）：具備點數、權限與自己線路的委派 dashboard | Users → 新增經銷商；其權限在 Groups 設定 |
| 頻道包 | 頻道包（bouquet）：由方案授予的一組具名頻道、電影或影集 | Bouquets，由 Streams 與 Movies / Series 建立 |
| 頻道或資訊頻道 | 直播頻道：含來源、EPG 與輸出格式的串流 | Streams → 新增直播串流（來源 URL 或 RTMP 推流） |
| 歡迎與公告影片 | VOD 內容目錄：電影與含季和集的影集、分類與中繼資料 | Movies 與 Series，或 VOD 匯入工作 |
| 各戶的存取權 | 線路：一份存取權，含其方案、頻道包、到期日、連線數上限與輸出 | Lines → 新增，或使用啟用碼，或 Reseller API |
| 租約或入住期間 | 線路的到期日，可由方案、點數或 API 續期 | 線路的到期日與方案的期限 |
| 建築節點 | 串流節點：從面板登錄的邊緣伺服器，每個據點或建築一個 | Servers → 新增節點，透過 SSH 安裝 |
前置條件
安裝前需要準備什麼。
- 管理公司的一台伺服器（Ubuntu 22.04 或 24.04）、安裝程式，以及每棟建築一台能連通住戶網路的伺服器。
- 社區可以轉播的頻道訊號（拉流網址或 RTMP）、管理公司的公告與歡迎影片，以及住戶的裝置（機上盒、具播放器應用程式的智慧電視，或瀏覽器）。
- 關於住戶類型（標準、長者、學生），以及管理公司中誰負責開通與續期線路的決定。
基礎架構部署
先部署中央伺服器，再為每棟建築部署一個節點。
- 在中央伺服器上執行安裝程式，並將播放基底網址設為各棟建築都能連線的位址。
- 在 Streams 下新增頻道訊號，在 Movies 下新增公告，並在網頁播放器中確認。
- 從 Servers 為每棟建築登錄一個節點；面板會透過 SSH 安裝它，或節點以一次性代碼登錄，並將該棟的住戶導向它。
- 在 Users → add a reseller 下新增物業管理員，使用允許管理線路但不能更改目錄的群組。
內容整理
每類住戶一套頻道包。
- 依每類住戶的頻道，為每套頻道包建立一個頻道包，並為管理公司的資訊建立一個頻道包。
- 將資訊頻道包加入每個方案，使每位住戶都能收到公告。
- 每類住戶建立一個方案，包含其頻道包，時效與租約或入住期間一致。
- 為頻道排序並設定標誌，使電視上的選單清晰易讀。
合作夥伴（經銷商）設定
物業管理員作為委派帳號。
- 建立一個權限僅限線路、不能存取目錄或伺服器的群組。
- 將每位物業管理員新增為 reseller，使用該群組、其所管住戶的方案與點數餘額。
- 管理多棟建築的管理員可以為每棟建築新增一個子 reseller，各有自己的住戶與點數。
住戶（線路）設定
每戶一條線路，以門牌號命名。
- 在 Lines → add 下為每戶建立一條線路，以戶號作為名稱，使用該類住戶的方案。
- 將最大連線數設為該戶的電視數量。
- 當住戶應在裝置上輸入短碼時，使用啟用碼而不是密碼。
- 一次性設定裝置（使用線路憑證的 Xtream Codes API 或 M3U，或 MAG 或 Enigma2 入口）；在為線路換發新憑證之前，憑證一直跟隨該戶。
歡迎與公告影片
管理公司的隨選影片。
- 將歡迎影片、住戶守則與維修指南作為電影上傳，並依主題分類。
- 把它們放入資訊頻道包，使每個方案都包含它們。
- 資訊變動時在面板中替換影片；住戶會立即看到新版本。
頻道與資訊頻道
頻道包與公告頻道作為直播串流。
- 在 Streams 下新增每個取得授權的頻道及其訊號，並新增一個 EPG 來源，讓電視上的節目表顯示節目。
- 將資訊頻道新增為直播串流，由編碼器透過 RTMP 供流或使用循環播放來源，並將其放入資訊頻道包。
- 有地域限制的頻道，放在只有對應方案才授予的頻道包中。
入住、搬離與到期
入住期間就是線路的有效期。
- 線路在其方案期間結束時到期；租約每進入一個新週期，就隨方案或以點數為其續期。
- 住戶搬離時停用該線路；下一位住戶以新的憑證重新啟用，因此舊住戶不會留下任何東西。
- 讓房產系統或管理員訂閱 webhook，以查看即將到期或已到期的線路。
與房產或計費系統整合
由系統開通存取，由播放器負責播放。
- 為房產或計費系統建立一個 Reseller API 金鑰；它呼叫 create_line、renew_line、enable_line 與 disable_line，每次寫入都傳送請求 ID。
- 住戶線上購買額外方案時使用電商連接器；其他系統使用 Reseller API 與 webhook。
- 沒有面向觀眾的單一登入：住戶使用線路的憑證登入播放器。
安全考量
讓服務留在社區內部。
- 將面板放在具 TLS 的反向代理之後並設定 TRUSTED_PROXIES，使稽核日誌與 IP 規則能看到真實位址。
- 每個管理帳號使用雙重驗證登入；物業管理員取得僅限線路的權限群組。
- 每條線路設定連線數上限，播放連結經過簽章並會過期，裝置有固定位址時綁定位址。
- 啟用附異地副本的加密資料庫備份；線路的憑證存放其中。
疑難排解
常見的初步檢查。
- 某戶沒有電視：檢查其線路已啟用且未到期，然後檢查裝置的憑證與播放位址。
- 某棟建築在晚間卡頓：檢查該棟節點的心跳以及其住戶是否已導向它。
- 某類住戶缺少一個頻道：檢查該方案的頻道包。
- 管理員無法建立線路：檢查該 reseller 的點數餘額、群組權限以及分配給它的方案。