这些指南把行业概念对应到平台目前已有的对象（频道包、线路、套餐、分销商账户、节点、API）。它们只是概念上的对应，并非行业专属功能，分销商账户是委托账户，而不是相互隔离的租户。
概念对应
面板里没有任何东西叫门店或加盟商。下表说明哪个对象承担哪个角色；下面各章按该顺序进行设置。
| 在您的行业中 | 在平台上 | 在面板中的位置 |
|---|---|---|
| 门店频道或培训专藏 | 频道包：由一个套餐授予的、已命名的频道、电影或剧集集合 | Bouquets，由 Streams 和 Movies / Series 组成 |
| 门店频道 | 直播频道：带有信号源、EPG 和输出格式的流 | Streams → 添加直播流（源 URL 或 RTMP 推流） |
| 培训与产品视频 | 点播目录：带季和集的电影与剧集、分类和元数据 | Movies 和 Series，或点播入库任务 |
| 门店屏幕或员工的访问权限 | 线路：一份访问权限，包含其套餐、频道包、到期时间、连接数上限和输出 | Lines → 添加，或激活码，或 Reseller API |
| 加盟商账户 | 分销商账户（reseller）：拥有积分、权限和自有线路的委托后台 | Users → 添加分销商；其权限在 Groups 中设置 |
| 区域节点 | 流媒体节点：从面板登记的边缘服务器，每个场地或每栋楼一个 | Servers → 添加节点，通过 SSH 安装 |
| 每条线路的屏幕或设备数 | 线路的最大连接数：允许多少台设备同时观看 | 线路的最大连接数 |
前提条件
安装前需要准备什么。
- 总部的一台服务器（Ubuntu 22.04 或 24.04）、安装程序，以及门店较多的每个区域一台能从门店访问的服务器。
- 门店频道的内容（编码器或循环播放源）、入职和产品培训的录像，以及门店里的屏幕或媒体播放器。
- 关于加盟结构的决定：哪些区域设节点，以及每位加盟商中由谁管理线路。
基础设施部署
先部署总部，再部署各区域。
- 在总部服务器上运行安装程序，并把播放基础地址设为门店可以访问的、启用了 TLS 的地址。
- 在“流”下添加门店频道，在“电影”下添加培训录像，并在网页播放器中检查它们。
- 在“服务器”中为每个区域登记一个节点；面板通过 SSH 安装它，或节点用一次性代码登记，并把该区域的门店路由到它。
- 为总部内容团队创建一个拥有目录权限、没有门店线路权限的分销商账户。
内容组织
门店频道和培训资料库。
- 为门店频道创建一个直播流，并放入它自己的频道包。
- 按主题创建分类，每门培训课程一个剧集，每节课一集；每个岗位（销售人员、经理、新员工）再创建一个频道包。
- 为门店屏幕创建一个套餐，每个岗位再创建一个套餐，各自授予其频道包，并以访问期限作为时长。
- 给加盟商他们可以转售给门店和员工的套餐。
分销商配置
每位加盟商一个分销商账户。
- 创建一个权限仅限线路、不能更改目录的分组。
- 在“用户 → 添加 reseller”下添加每位加盟商，使用该分组、其套餐和积分余额。
- 拥有多个区域的加盟商可以为每个区域添加一个子 reseller，各有自己的门店。
门店和员工线路配置
每块屏幕、每位员工一条线路。
- 在“线路 → 添加”下为每块门店屏幕创建一条线路，以门店名称命名，使用门店套餐；加盟商为自己的门店做同样的事。
- 把最大连接数设为门店的屏幕数量，员工则设为两个（卖场和手机）。
- 门店有固定地址时，把门店线路绑定到该地址，这样凭据在别处无法使用。
- 一次性配置屏幕的播放器（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 设为该代理并重启面板。