首页
XtreamUIPro

部署指南

公共部门部署指南

把平台配置为公共机构的视频服务:带存档的现场会议、员工培训资料库、面向居民和各部门的线路,并由机构自己运营。

这些指南把行业概念对应到平台目前已有的对象(频道包、线路、套餐、分销商账户、节点、API)。它们只是概念上的对应,并非行业专属功能,分销商账户是委托账户,而不是相互隔离的租户。

概念对应

面板里没有任何东西叫会议、居民或部门。下表说明哪个对象承担哪个角色;下面各章按该顺序进行设置。

在您的行业中在平台上在面板中的位置
议会会议或公共频道直播频道:带有信号源、EPG 和输出格式的流Streams → 添加直播流(源 URL 或 RTMP 推流)
会议存档和培训资料库点播目录:带季和集的电影与剧集、分类和元数据Movies 和 Series,或点播入库任务
公共节目或部门专藏频道包:由一个套餐授予的、已命名的频道、电影或剧集集合Bouquets,由 Streams 和 Movies / Series 组成
居民或员工的访问权限线路:一份访问权限,包含其套餐、频道包、到期时间、连接数上限和输出Lines → 添加,或激活码,或 Reseller API
公众或员工访问的有效期线路的到期日期,通过套餐、积分或 API 续期线路的到期日期和套餐的时长
议会系统集成Reseller API 与 webhook:从您自己的系统调用面板的各项操作分销商后台中的 Reseller API 密钥和 webhook

前提条件

安装前需要准备什么。

  1. 机构数据中心里的一台服务器(Ubuntu 22.04 或 24.04)、安装程序,以及机构反向代理之后用于公开地址的域名。
  2. 能推送 RTMP 的议事厅编码器或视频切换台、往届会议的录像,以及员工的培训视频。
  3. 关于哪些内容公开、哪些内部、公众线路有效期多长,以及运营人员中谁获得面板账户的决定。

基础设施部署

先部署管理服务器,再部署任何远程站点。

  1. 在机构的服务器上运行安装程序;把面板放在带 TLS 的反向代理之后并设置 TRUSTED_PROXIES,使审计日志和 IP 规则能看到真实地址。
  2. 把播放基础地址设为居民访问的公开地址,并在服务器上设置许可证密钥。
  3. 为需要节点的站点(例如设有议事厅的第二栋楼)在“服务器”中登记一个节点;面板通过 SSH 安装它。
  4. 为宣传团队创建一个拥有公众线路权限的分销商账户(reseller),并为人事或培训部门创建一个负责员工线路的账户。

内容组织

公开节目和部门专藏。

  1. 为会议、委员会和公共信息创建分类,每个机构一个剧集,每次会议一集。
  2. 创建一个包含直播会议频道和存档的公开频道包,并为每个部门的培训专藏各创建一个频道包。
  3. 为居民创建一个只授予公开频道包的套餐,以较长的时长作为访问期限。
  4. 为员工创建在公开频道包之上再加入培训和内部频道包的套餐。

分销商配置

负责发放访问权限的团队。

  1. 创建一个仅含线路权限、不能访问目录或设置的分组。
  2. 把宣传团队添加为使用居民套餐的分销商账户,把人事或培训部门添加为使用员工套餐的分销商账户。
  3. 设有多个服务部门的机构可以给每个部门各配一个分销商账户;它是委托账户,而不是隔离的安装。

居民和员工线路配置

公众线路和员工线路。

  1. 为议会网站创建一个 Reseller API 密钥并保存在其机密信息中;居民申请访问时,它用公开套餐和请求 ID 调用 action=create_line。
  2. 为公众线路设置较长的有效期,以及适合家庭观看的连接数限制。
  3. 用员工套餐按部门创建员工线路,可由议会的员工系统通过 API 创建,也可通过“线路 → 添加”创建。
  4. 在网络允许时,把员工线路绑定到机构的地址范围。

会议存档和培训资料库

点播录像。

  1. 把每个录制的会议作为其机构系列中的一集加入,用 VOD 导入任务导入或直接上传,并附上标题、日期和说明。
  2. 把会议系列放入公开频道包,把培训资料库放入各部门的频道包。
  3. 用公开套餐的一条测试线路和员工套餐的一条测试线路检查播放,确认谁能看到什么。

现场会议

把议事厅变成直播频道。

  1. 添加一个由议事厅编码器 RTMP 推流的直播流,并将其放入公开频道包。
  2. 启用回看,使迟到的观众可以回退,并添加 EPG 条目或标题,让观众知道正在进行的是哪场会议。
  3. 每次会议前测试信号;如果第二个站点也举行会议,在其附近保留一个节点。

到期与续期

公众线路较长,员工线路与任职挂钩。

  1. 公众线路的有效期与套餐的时长一致;居民再次申请时,用 action=renew_line 延长。
  2. 员工线路在此人为机构工作期间续期,离职时用 action=disable_line 禁用。
  3. 让议会的系统订阅 webhook,以查看即将到期和已禁用的线路。

与机构系统集成

由系统驱动访问,由播放器负责播放。

  1. 网站和员工系统凭密钥和请求 ID,通过 Reseller API 创建、续期、启用和禁用线路。
  2. 没有面向观众的单点登录,也没有与特定公共部门产品的原生集成:观众使用其线路的凭据登录播放器。
  3. 为报表工具使用带只读标志、IP 白名单和到期日期的 Admin API 密钥。

安全注意事项

由机构自己运营,该公开的地方公开。

  1. 把平台放在机构的基础设施上、带 TLS 的反向代理之后,并把公开和内部资料放在不同的频道包中。
  2. 每个面板账户使用双重验证登录,并按团队设置权限分组;如果面板可从外部访问,在登录页启用 reCAPTCHA 或 Turnstile。
  3. 播放链接带签名且会过期,每条线路设置连接数限制,员工线路绑定地址。
  4. 加密的数据库备份并保留异地副本,用审计日志记录线路和目录的每一次变更。

故障排查

常见的首要检查项。

  1. 居民无法观看:检查线路的到期时间、是否已启用,以及套餐中的公开频道包。
  2. 会议没有开始:检查编码器向该流的推送,以及面板中该流的状态。
  3. 员工看不到培训资料库:检查员工线路的套餐及其授予的频道包。
  4. 审计日志显示的是代理的地址:把 TRUSTED_PROXIES 设为该代理并重启面板。