这些指南把行业概念对应到平台目前已有的对象（频道包、线路、套餐、分销商账户、节点、API）。它们只是概念上的对应，并非行业专属功能，分销商账户是委托账户，而不是相互隔离的租户。
概念对应
面板中没有任何东西叫作客房或住宿。下表说明哪个对象扮演什么角色；下面的各章按此顺序进行设置。
| 在您的行业中 | 在平台上 | 在面板中的位置 |
|---|---|---|
| 酒店运营商或授权分销商 | 分销商账户（reseller）：拥有积分、权限和自有线路的委托后台 | Users → 添加分销商；其权限在 Groups 中设置 |
| 频道套餐 | 频道包：由一个套餐授予的、已命名的频道、电影或剧集集合 | Bouquets，由 Streams 和 Movies / Series 组成 |
| 客房或设备 | 线路：一份访问权限，包含其套餐、频道包、到期时间、连接数上限和输出 | Lines → 添加，或激活码，或 Reseller API |
| 酒店信息视频 | 点播目录：带季和集的电影与剧集、分类和元数据 | Movies 和 Series，或点播入库任务 |
| 获授权的电视频道 | 直播频道：带有信号源、EPG 和输出格式的流 | Streams → 添加直播流（源 URL 或 RTMP 推流） |
| 住宿时长 | 线路的到期日期，通过套餐、积分或 API 续期 | 线路的到期日期和套餐的时长 |
| 每栋楼或侧楼一个节点 | 流媒体节点：从面板登记的边缘服务器，每个场地或每栋楼一个 | Servers → 添加节点，通过 SSH 安装 |
前提条件
安装前需要准备什么。
- 酒店网络内的一台服务器（Ubuntu 22.04 或 24.04）、安装程序，以及客房设备可以访问的地址。
- 酒店拥有权利的频道信号（拉流 URL 或 RTMP）、酒店的信息视频，以及客房设备（Android TV 盒子、MAG 或 Enigma2 盒子、带播放器应用或浏览器的智能电视）。
- PMS 能在入住和退房时调用 HTTP API，或者有前台在面板中操作的流程。
基础设施部署
中心服务器和每栋楼一个节点。
- 在中心服务器上运行安装程序；把播放基础地址设为酒店的内部地址，使客房保持在本地网络中。
- 在 Streams 下添加频道信号，在 Movies 下添加信息视频；在网页播放器中检查。
- 在 Servers 中为每个侧楼或楼栋登记一个节点；面板通过 SSH 安装它，并把该楼的客房路由到它。
- 在服务器上设置许可证密钥；激活在本地完成，服务在没有上行网络时也能运行。
内容组织
频道套餐和酒店视频。
- 用酒店的频道为每个频道套餐（标准客房、套房、会议）创建一个频道包。
- 创建一个酒店视频（欢迎、设施、安全）的频道包，并将其加入每个套餐。
- 为每个房型创建一个套餐，包含其授予的频道包，时长为一天：入住时，房间的线路按入住的每一晚续期一次（每次续期增加套餐的时长），退房时则被禁用（第 8 章）。
- 为频道排序并设置台标，使电视上的菜单易于阅读。
分销商配置
将酒店，或运营多家酒店的运营商，作为委托账户。
- 创建一个权限仅限于线路（客房）、不能修改目录的分组。
- 用该分组和客房套餐，把酒店前台或运营商添加为分销商。
- 运营多家酒店的运营商，每家酒店获得一个分销商，各有自己的客房和积分。
客房（线路）配置
每间客房一条线路，以房间号命名。
- 在 Lines 下为每间客房创建一条线路，以房间号作为名称，并使用该房型的套餐。
- 将最大连接数设为 1（一台电视），或设为客房内的屏幕数。
- 当网络为设备分配固定地址时，把线路绑定到客房设备的地址。
- 只需配置一次设备（使用线路凭据的 Xtream Codes API 或 M3U，或 MAG / Enigma2 门户）；凭据随客房保留。
酒店信息视频
酒店自有的点播视频。
- 把欢迎和信息视频作为电影上传，酒店的各语言版本作为单独条目或音轨。
- 把它们放进酒店视频频道包，使每个房型都能收到。
- 信息变更时在面板中更新它们；客房会立即看到新版本。
获授权的电视频道
酒店的频道作为直播流。
- 在 Streams 下添加每个获授权的频道及其信号；仅在授权允许时才启用时移或回看。
- 添加 EPG 来源，使电视上的节目指南显示节目。
- 把地域受限的频道放在只有相应套餐才会授予的频道包中。
入住、退房与到期
以住宿时间作为线路的有效期。
- 入住时启用该客房的线路，并按住宿时长为其续期（通过 API 由 PMS 完成，或由前台在面板中完成）。
- 退房时禁用线路；新的住宿会再次启用它，因此凭据从不离开客房。
- 让 PMS 或前台订阅 webhook，以查看已启用、已禁用和已到期的线路。
与 PMS 集成
入住和退房驱动客房。
- 为 PMS 创建一个 Reseller API 密钥，并保存在 PMS 的配置中。
- 入住时，PMS 使用请求 ID 对该客房的线路调用 action=enable_line 和 action=renew_line;退房时调用 action=disable_line。
- 宾客服务应用（呼叫员工、客房清洁、快速退房、客房送餐）及其后台连接属于 Enterprise 套餐，并与酒店共同界定范围。
安全注意事项
让频道留在酒店内部。
- 让播放基础地址和节点保留在酒店网络中；不要向互联网暴露客房不需要的任何内容。
- 每间客房一个连接，并绑定到设备；带签名的链接会过期，因此被复制的链接将失效。
- 面板启用双重验证登录；前台获得受限的权限分组。
- 开启加密的数据库备份；客房凭据就保存在其中。
故障排查
常见的首要检查项。
- 某间客房没有电视：检查其线路是否已启用且未到期，然后检查设备的凭据和地址。
- 某间客房缺少一个频道：检查该房型套餐所含的频道包。
- 互联网中断时电视停止：检查播放基础地址和信号源是否为内部地址；外部信号依赖上行网络。
- PMS 调用失败：检查 API 密钥、写入是否为 POST，以及重试时的请求 ID。