集成注意事项
计费系统通过安装在运营商一侧的开源连接器（WHMCS、Blesta、WISECP、HostBill、ClientExec、FOSSBilling、Paymenter、Odoo 等）或通过 Reseller API 和 webhook 接入；除这些连接器外，没有与特定 OSS 或 BSS 产品的原生集成，也没有面向观众的单点登录。
电信与 ISP
运行在运营商自有网络上的电视服务
您的用户从位于接入点的节点获得频道组合和 VOD 资料库。他们的线路由您的计费系统创建和续期，分销商在自己的后台中用积分销售。
面临的挑战
运营商要解决什么
-
作为订阅一部分的电视
电视套餐必须与宽带套餐一起销售、计费和取消，而不是作为拥有自己账户的独立系统运行。
-
留在您网络内的流量
从远程数据中心提供的频道组合会占用上行链路并影响画质；分发应当从靠近用户的地方开始。
-
分销商与档位
区域分销商负责销售和支持服务，每个套餐限制一个家庭可以同时使用多少块屏幕。
Xtream UI Pro 如何帮助
平台如何适配
-
来自计费系统的套餐
每个订阅档位一个套餐，授予其频道包并带有期限；您的计费系统通过连接器或 Reseller API 创建、续期和禁用用户的线路。
-
每个接入点一个节点
节点在面板中登记并通过 SSH 安装；每个节点只从源站拉取一次直播频道，缓存 VOD 资料库，并为路由到它的用户提供服务。
-
使用积分的分销商
分销商是拥有积分、权限分组和自有线路的分销商账户（reseller）；子 reseller 可以对应分销商网络，连接数限制按订阅设置。
平台能力
该行业会用到什么
下列能力是此部署所依赖的。每一项在当前产品中均已提供；这里没有任何计划中或需按需定制的内容。
-
直播流媒体
来自您自有信号源的直播频道，在信号源允许时提供 EPG、回看和时移，以 HLS 或 MPEG-TS 形式送达观众使用的应用和机顶盒。
每个频道一路上游的源站中心 · RTMP 推流与输出 · ffmpeg 转码
-
订阅用户管理
线路就是一位观众的访问权限：套餐、频道包、到期时间、连接数上限和输出格式；激活码、试用和续期在所有地方遵循同样的规则。
Xtream Codes API、M3U/XMLTV、MAG 和 Enigma2 门户、网页播放器
-
API 与集成
通过 Reseller API 从您自己的系统创建、续期和暂停访问，接收带签名的 webhook，并用现成的连接器接入计费或电商平台。
带幂等请求 ID 的 Reseller API · Admin API 密钥 · 17 个连接器
-
监控与运维
连接与流量视图、审计日志、Prometheus 指标、通过邮件、Telegram 或 webhook 发送的告警、维护模式以及内置的更新检查。
/metrics 端点 · 带租约的任务队列 · 加密的数据库备份
面板中
此部署所使用的页面
装有示例目录的全新安装的管理后台截图，没有任何合成内容。
基础设施架构
部署示例：一家区域 ISP
运营商核心机房里的一台管理服务器、每个接入点一个节点、一套频道组合和一个 VOD 资料库、由 ISP 计费系统驱动的用户线路，以及作为带积分的分销商账户的分销商。
选择示意图的某一部分，查看它的作用。
在运营商部署中，信号源是获授权的频道信号和 VOD 资料库；面板保存套餐、频道包、用户的线路和分销商的积分；源站和每个接入点的节点为用户提供服务；计费系统通过连接器或 Reseller API 接入。
-
安装到核心机房
面板、API、worker 和源站运行在运营商的服务器上；播放基础地址是用户可访问的地址，并为每个接入点在“服务器”中登记一个节点。
-
定义套餐
为基础频道组合、付费频道和 VOD 资料库分别设置频道包；每个订阅档位一个套餐，带有期限和以积分计的价格。
-
连接计费系统
WHMCS、Odoo 或其他连接器，或计费系统自己对 Reseller API 的调用，会在订阅开始时创建线路，每个周期续期，取消时禁用。
-
添加分销商
每位区域分销商获得一个带积分的分销商账户，以及一个仅限管理线路的分组；分销商的销售会消耗该套餐的积分。
配置对应
您的概念，平台的对象
平台没有行业专属的对象：频道包、线路、套餐或分销商账户，会被当作您的行业所需的概念来使用。这些只是概念上的对应，并非该行业的原生功能。
分步部署指南
前提条件、在核心机房和接入点部署、套餐、计费集成、分销商、安全和故障排查，逐步说明。
阅读部署指南| 在您的行业中 | 在平台上 |
|---|---|
| 分销商或区域分销商账户 | 分销商账户（reseller）：拥有积分、权限和自有线路的委托后台 |
| 频道档位或附加包 | 频道包：由一个套餐授予的、已命名的频道、电影或剧集集合 |
| 电视频道 | 直播频道：带有信号源、EPG 和输出格式的流 |
| VOD 资料库 | 点播目录：带季和集的电影与剧集、分类和元数据 |
| 用户的电视访问权限 | 线路：一份访问权限，包含其套餐、频道包、到期时间、连接数上限和输出 |
| 计费周期结束 | 线路的到期日期，通过套餐、积分或 API 续期 |
| 每个订阅的屏幕数 | 线路的最大连接数：允许多少台设备同时观看 |
| 计费和开通集成 | Reseller API 与 webhook:从您自己的系统调用面板的各项操作 |
| 接入点节点 | 流媒体节点：从面板登记的边缘服务器，每个场地或每栋楼一个 |
安全注意事项
用户线路带连接数限制，并可绑定到地址、国家或 ISP;播放链接带签名且会过期；在反向代理之后，TRUSTED_PROXIES 让日志和 IP 规则保留真实地址；面板账户使用双重验证登录、权限分组以及带 IP 白名单的 Admin API 密钥；审计日志和加密备份使其更完整。
内容权利与授权
运营商需要拥有向用户传送的每个频道和节目的权利；平台不提供内容，也不提供权利。适用标准套餐；Enterprise 合作另含集成工作和 SLA。
内容权利与可接受使用帮助中心
来自该行业的问题
运营方在部署前常问的问题。通用问题请见帮助中心。
帮助中心电视套餐可以与宽带套餐一起销售吗？
可以。每个档位一个套餐，再加上连接器或您的计费系统的 API 调用，会在订阅开始时创建线路，结束时禁用。
支持哪些计费系统？
十七个开源连接器覆盖 WHMCS、Blesta、HostBill、FOSSBilling、Odoo 等系统；其他系统使用 Reseller API 和 webhook。没有针对专有 BSS 产品的连接器。
分销商是如何运作的？
分销商是拥有积分和自有线路的分销商账户，下面还可以有子 reseller。它是委托账户，而不是隔离的安装。