这些指南把行业概念对应到平台目前已有的对象（频道包、线路、套餐、分销商账户、节点、API）。它们只是概念上的对应，并非行业专属功能，分销商账户是委托账户，而不是相互隔离的租户。
概念对应
面板里没有任何东西叫公寓或住户。下表说明哪个对象承担哪个角色；下面各章按该顺序进行设置。
| 在您的行业中 | 在平台上 | 在面板中的位置 |
|---|---|---|
| 物业管理员账户 | 分销商账户（reseller）：拥有积分、权限和自有线路的委托后台 | Users → 添加分销商；其权限在 Groups 中设置 |
| 频道组合 | 频道包：由一个套餐授予的、已命名的频道、电影或剧集集合 | Bouquets，由 Streams 和 Movies / Series 组成 |
| 频道或信息频道 | 直播频道：带有信号源、EPG 和输出格式的流 | Streams → 添加直播流（源 URL 或 RTMP 推流） |
| 欢迎和通知视频 | 点播目录：带季和集的电影与剧集、分类和元数据 | Movies 和 Series，或点播入库任务 |
| 公寓的访问权限 | 线路：一份访问权限，包含其套餐、频道包、到期时间、连接数上限和输出 | Lines → 添加，或激活码，或 Reseller API |
| 租约或入住期限 | 线路的到期日期，通过套餐、积分或 API 续期 | 线路的到期日期和套餐的时长 |
| 楼栋节点 | 流媒体节点：从面板登记的边缘服务器，每个场地或每栋楼一个 | Servers → 添加节点，通过 SSH 安装 |
前提条件
安装前需要准备什么。
- 物业公司的一台服务器（Ubuntu 22.04 或 24.04）、安装程序，以及每栋楼一台能连通住户网络的服务器。
- 社区可以转播的频道信号（拉流 URL 或 RTMP）、物业公司的通知和欢迎视频，以及住户的设备（机顶盒、带播放器应用的智能电视，或浏览器）。
- 关于住户类型（标准、老年、学生），以及物业公司中谁负责开通和续期线路的决定。
基础设施部署
先部署中心服务器，再为每栋楼部署一个节点。
- 在中心服务器上运行安装程序，并把播放基础地址设为各栋楼都能访问的地址。
- 在“流”下添加频道信号，在“电影”下添加通知，并在网页播放器中检查它们。
- 在“服务器”中为每栋楼登记一个节点；面板通过 SSH 安装它，或节点用一次性代码登记，并把该楼的住户路由到它。
- 在“用户 → 添加 reseller”下添加物业管理员，使用允许管理线路但不能更改目录的分组。
内容组织
每类住户一套频道组合。
- 根据每类住户的频道，为每套频道组合创建一个频道包，并为物业公司的信息创建一个频道包。
- 把信息频道包加入每个套餐，使每位住户都能收到通知。
- 每类住户创建一个套餐，包含其频道包，时长与租约或入住期限一致。
- 为频道排序并设置徽标，使电视上的菜单清晰易读。
分销商配置
物业管理员作为委托账户。
- 创建一个权限仅限线路、不能访问目录或服务器的分组。
- 把每位物业管理员添加为 reseller，使用该分组、其所管住户的套餐和积分余额。
- 管理多栋楼的管理员可以为每栋楼添加一个子 reseller，各有自己的住户和积分。
公寓（线路）配置
每套公寓一条线路，以门牌号命名。
- 在“线路 → 添加”下为每套公寓创建一条线路，以公寓号作为名称，使用该类住户的套餐。
- 把最大连接数设为该户的电视数量。
- 当住户应在设备上输入短码时，使用激活码而不是密码。
- 一次性配置设备（使用线路凭据的 Xtream Codes API 或 M3U，或 MAG 或 Enigma2 门户）；在为线路换发新凭据之前，凭据一直跟随该公寓。
欢迎和通知视频
物业公司的点播视频。
- 把欢迎视频、住户守则和维修指南作为电影上传，并按主题分类。
- 把它们放入信息频道包，使每个套餐都包含它们。
- 信息变化时在面板中替换视频；住户会立即看到新版本。
频道和信息频道
频道组合和通知频道作为直播流。
- 在“流”下添加每个获授权的频道及其信号，并添加一个 EPG 源，让电视上的节目指南显示节目。
- 把信息频道添加为直播流，由编码器通过 RTMP 供流或使用循环播放源，并将其放入信息频道包。
- 有地域限制的频道，放在只有对应套餐才授予的频道包中。
入住、搬离与到期
入住期限就是线路的有效期。
- 线路在其套餐的期限结束时到期；租约每进入一个新周期，就随套餐或用积分为其续期。
- 住户搬离时禁用该线路；下一位住户用新的凭据重新启用，因此旧住户不会留下任何东西。
- 让房产系统或管理员订阅 webhook，以查看即将到期或已到期的线路。
与房产或计费系统集成
由系统开通访问，由播放器负责播放。
- 为房产或计费系统创建一个 Reseller API 密钥；它调用 create_line、renew_line、enable_line 和 disable_line，每次写入都发送请求 ID。
- 住户在线购买额外套餐时使用电商连接器；其他系统使用 Reseller API 和 webhook。
- 没有面向观众的单点登录：住户使用线路的凭据登录播放器。
安全注意事项
让服务留在社区内部。
- 把面板放在带 TLS 的反向代理之后并设置 TRUSTED_PROXIES，使审计日志和 IP 规则能看到真实地址。
- 每个管理账户使用双重验证登录；物业管理员获得仅限线路的权限分组。
- 每条线路设置连接数限制，播放链接带签名且会过期，设备有固定地址时绑定地址。
- 启用带异地副本的加密数据库备份；线路的凭据存放其中。
故障排查
常见的首要检查项。
- 某套公寓没有电视：检查其线路已启用且未过期，然后检查设备的凭据和播放地址。
- 某栋楼在晚间卡顿：检查该楼节点的心跳以及其住户是否已路由到它。
- 某类住户缺少一个频道：检查该套餐的频道包。
- 管理员无法创建线路：检查该 reseller 的积分余额、分组权限以及分配给它的套餐。