首页
XtreamUIPro

部署指南

现场活动部署指南

把平台配置为会议、音乐节或典礼的流媒体服务:每个舞台一个频道,按门票授予访问权限,场馆内设节点,有效期较短。

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

概念对应

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

在您的行业中在平台上在面板中的位置
舞台频道直播频道:带有信号源、EPG 和输出格式的流Streams → 添加直播流(源 URL 或 RTMP 推流)
门票类型频道包:由一个套餐授予的、已命名的频道、电影或剧集集合Bouquets,由 Streams 和 Movies / Series 组成
门票或通行证线路:一份访问权限,包含其套餐、频道包、到期时间、连接数上限和输出Lines → 添加,或激活码,或 Reseller API
活动结束线路的到期日期,通过套餐、积分或 API 续期线路的到期日期和套餐的时长
每张门票的设备数线路的最大连接数:允许多少台设备同时观看线路的最大连接数
票务或报名集成Reseller API 与 webhook:从您自己的系统调用面板的各项操作分销商后台中的 Reseller API 密钥和 webhook
场馆节点流媒体节点:从面板登记的边缘服务器,每个场地或每栋楼一个Servers → 添加节点,通过 SSH 安装

前提条件

安装前需要准备什么。

  1. 一台带公网地址或域名、上行带宽足以应对预期峰值观众的服务器(Ubuntu 22.04 或 24.04);如果设场馆节点,还需要场馆网络上的一台机器。
  2. 每个舞台一台能推送 RTMP 的编码器,以及舞台、日期和门票类型的清单。
  3. 关于门票如何进入面板的决定:批量生成激活码,或由票务系统调用 Reseller API。

基础设施部署

先部署源站,再部署场馆。

  1. 在管理服务器上运行安装程序,并把面板放在带 TLS 的反向代理之后;设置受信任代理,使 IP 规则能看到观众的真实地址。
  2. 把播放基础地址设为参会者访问的公开地址。
  3. 在“服务器”中为场馆内的机器登记一个节点;面板通过 SSH 安装它,本地屏幕会被路由到它。
  4. 为票务台创建一个分销商账户(reseller),拥有线路权限但没有目录权限。

内容组织

舞台是频道,门票是套餐。

  1. 按日期或分会场添加分类,使频道列表读起来像议程。
  2. 每种门票类型创建一个频道包:该门票可观看的舞台。
  3. 每种门票类型创建一个套餐,以活动的长度作为时长;如有需要,为媒体和演讲者添加一个试用套餐。
  4. 为赞助商的舞台或休息室信号创建一个频道包,并只通过赞助商套餐授予。

分销商配置

票务台,如果由它发放访问权限。

  1. 为票务台创建一个拥有线路权限、没有目录权限的分组。
  2. 把票务台添加为 reseller,使用该分组,并赋予足够其发放激活码的积分。
  3. 销售自己门票的联合主办方或区域合作伙伴,获得自己的分销商账户和自己的套餐。

参会者访问配置

每张门票一条线路。

  1. 批量生成激活码,每张门票一个,每个都绑定到其门票类型的套餐,并随门票打印或通过电子邮件发送。
  2. 对于线上售票,安装您的电商平台的连接器,或让票务系统用套餐和请求 ID 调用 action=create_line。
  3. 把最大连接数设为每张门票一两个设备,这样激活码就不能在观众之间共享。
  4. 开门前用试用线路测试,使用参会者将要使用的同一个播放器。

场次录像

活动之后的录像。

  1. 录制每个舞台,并把文件作为每个分会场一个剧集的各集加入资料库,或用 VOD 导入任务导入。
  2. 通过单独的频道包和套餐授予录像,使参会者在直播线路到期后仍保有访问权限。
  3. 在宣布之前,用该套餐的测试线路检查录像的播放。

舞台频道

把舞台变成直播频道。

  1. 为每个舞台添加一个直播流,使用编码器的 RTMP 推流,并将其放入可观看它的门票类型的频道包中。
  2. 启用回看,使错过场次开头的参会者可以回退。
  3. 在第一场之前检查场馆节点是否从源站只拉取每个舞台一次,以及屏幕是否已路由到它。

到期

访问权限随活动结束。

  1. 让每个门票套餐的时长在活动最后一天结束,这样线路无需任何操作就会失效。
  2. 对于演讲者或迟到的赞助商,延长一条线路或发放一个短期有效的激活码,而不是新建套餐。
  3. 在“线路”中禁用丢失或被共享门票的线路;审计日志会保留记录。

与票务系统集成

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

  1. 票务或报名系统通过 Reseller API 创建线路,并监听 line.created 和 line.expired 等 webhook。
  2. 受支持电商平台上的线上售票使用其连接器;没有针对特定票务产品的原生连接器。
  3. 没有面向观众的单点登录:参会者使用线路的凭据或激活码登录播放器。

安全注意事项

一张门票对应一个人。

  1. 通过 TLS 提供面板和播放基础地址,并把 TRUSTED_PROXIES 设为您的反向代理。
  2. 每个面板账户使用双重验证登录,并设置权限分组,使票务台无法更改舞台。
  3. 播放链接带签名且会过期,每张门票设置较低的连接数限制。
  4. 加密的数据库备份并保留异地副本,用审计日志记录线路和舞台的每一次变更。

故障排查

常见的首要检查项。

  1. 参会者无法打开某个舞台:检查线路的套餐、包含该舞台的频道包以及到期日期。
  2. 舞台在会场内卡住但线上正常:检查场馆节点的心跳以及屏幕到它的路由。
  3. 激活码被拒绝:检查它是否已被使用,以及其套餐是否仍然有效。
  4. 审计日志显示的是代理的地址:把 TRUSTED_PROXIES 设为该代理并重启面板。