这些指南把行业概念对应到平台目前已有的对象（频道包、线路、套餐、分销商账户、节点、API）。它们只是概念上的对应，并非行业专属功能，分销商账户是委托账户，而不是相互隔离的租户。
概念对应
面板里没有任何东西叫订阅或接入点。下表说明哪个对象承担哪个角色；下面各章按该顺序进行设置。
| 在您的行业中 | 在平台上 | 在面板中的位置 |
|---|---|---|
| 分销商或区域分销商账户 | 分销商账户（reseller）：拥有积分、权限和自有线路的委托后台 | Users → 添加分销商；其权限在 Groups 中设置 |
| 频道档位或附加包 | 频道包：由一个套餐授予的、已命名的频道、电影或剧集集合 | Bouquets，由 Streams 和 Movies / Series 组成 |
| 电视频道 | 直播频道：带有信号源、EPG 和输出格式的流 | Streams → 添加直播流（源 URL 或 RTMP 推流） |
| VOD 资料库 | 点播目录：带季和集的电影与剧集、分类和元数据 | Movies 和 Series，或点播入库任务 |
| 用户的电视访问权限 | 线路：一份访问权限，包含其套餐、频道包、到期时间、连接数上限和输出 | Lines → 添加，或激活码，或 Reseller API |
| 计费周期结束 | 线路的到期日期，通过套餐、积分或 API 续期 | 线路的到期日期和套餐的时长 |
| 每个订阅的屏幕数 | 线路的最大连接数：允许多少台设备同时观看 | 线路的最大连接数 |
| 计费和开通集成 | Reseller API 与 webhook:从您自己的系统调用面板的各项操作 | 分销商后台中的 Reseller API 密钥和 webhook |
| 接入点节点 | 流媒体节点：从面板登记的边缘服务器，每个场地或每栋楼一个 | Servers → 添加节点，通过 SSH 安装 |
前提条件
安装前需要准备什么。
- 核心机房里的一台服务器（Ubuntu 22.04 或 24.04）、安装程序、用户可访问的域名或地址，以及每个接入点用于部署节点的一台服务器。
- 获授权的频道信号、VOD 资料库，以及订阅所在的计费系统。
- 关于档位、计费周期多长，以及哪些分销商获得分销商账户的决定。
基础设施部署
先部署核心机房，再部署各接入点。
- 在核心服务器上运行安装程序；把面板放在您的反向代理之后并设置 TRUSTED_PROXIES，使日志和 IP 规则能看到用户的真实地址。
- 把播放基础地址设为用户访问的公开地址，并在服务器上设置许可证密钥。
- 在“服务器”中为每个接入点登记一个节点；面板通过 SSH 安装它，或节点用一次性代码登记，并把靠近它的用户路由到它。
- 为客服或计费团队创建一个仅拥有线路权限的分销商账户（reseller）。
内容组织
档位和附加包是频道包。
- 在“流”下添加频道，在“电影”和“剧集”下添加 VOD 资料库，并配置分类和 EPG 源。
- 为基础频道组合、付费频道和 VOD 资料库创建频道包。
- 每个订阅档位创建一个套餐：它授予的频道包、作为时长的计费周期，以及以积分计的价格。
- 为促销或新客户创建一个较短的试用套餐。
分销商配置
使用积分的分销商。
- 为分销商创建一个分组，拥有管理自己线路的权限，不能访问目录或设置。
- 把每位区域分销商添加为分销商账户，使用该分组、其可销售的套餐和积分余额；一位分销商最多可有五级子 reseller。
- webhook credits.low 和低积分通知会提醒分销商在停止销售之前充值。
用户线路配置
每个订阅一条线路。
- 订阅开始时，计费系统通过连接器，或通过 Reseller API 的 action=create_line 配合该档位的套餐和请求 ID，创建一条线路。
- 按档位设置最大连接数，即一个家庭可同时使用的屏幕数。
- 当产品仅限您的网络使用时，把线路绑定到用户的地址、国家或 ISP。
- 试点或处理客服个案时，通过“线路 → 添加”添加线路并发放凭据。
VOD 资料库
点播目录。
- 添加含季和集的电影和剧集，用 VOD 导入任务导入或上传，并用 TMDB 元数据提供海报和说明。
- 按档位或附加包把内容归入频道包，使套餐恰好授予订阅所含的内容。
- 节点会缓存 VOD 文件，因此热门内容由靠近用户的接入点提供。
直播频道
频道组合。
- 在“流”下添加每个获授权的频道及其信号，并仅在权利允许的地方启用回看或时移。
- 添加一个 EPG 源，让应用和机顶盒显示节目指南。
- 每个节点只从源站拉取一次直播频道，再分发给它的用户。
到期、续期与取消
计费周期就是线路的有效期。
- 线路在其套餐的期限内有效；计费系统在每个周期用 action=renew_line 或通过连接器为其续期。
- 订阅失效或被取消时，计费系统调用 action=disable_line，重新激活时再启用该线路。
- 让计费系统订阅 webhook，以将即将到期和已到期的线路与其记录核对。
与计费系统集成
由计费系统驱动访问，由播放器负责播放。
- 在计费系统一侧安装其连接器（WHMCS、Blesta、Odoo 等），或从您自己的系统用密钥和请求 ID 调用 Reseller API。
- 没有面向观众的单点登录：用户使用线路的凭据登录应用或机顶盒，计费系统可以在客户中心显示这些凭据。
- 为报表工具使用带只读标志、IP 白名单和到期日期的 Admin API 密钥。
安全注意事项
让服务只留给用户。
- 把面板放在带 TLS 的反向代理之后并设置 TRUSTED_PROXIES;让节点的管理流量走专用网络。
- 每个面板账户使用双重验证登录，为客服和分销商设置权限分组；在登录页启用 reCAPTCHA 或 Turnstile。
- 播放链接带签名且会过期，每个订阅设置连接数限制，并在合适时绑定地址、国家或 ISP。
- 加密的数据库备份并保留异地副本，用审计日志记录线路和积分的每一次变更。
故障排查
常见的首要检查项。
- 某位用户没有电视：检查线路已启用且未过期，然后在 Reseller API 调用日志中检查计费系统的调用。
- 某个档位缺少一个频道：检查该档位套餐的频道包。
- 某个接入点卡顿：检查其节点的心跳以及其用户是否已路由到它。
- 分销商无法创建线路：检查其积分，以及该套餐是否在其可销售范围内。