博物馆与文化中心部署指南

概念对应

面板里没有任何东西叫展厅或会员。下表说明哪个对象承担哪个角色；下面各章按该顺序进行设置。

1前提条件

安装前需要准备什么。

1. 馆内的一台服务器（Ubuntu 22.04 或 24.04）、安装程序，以及屏幕和会员设备将使用的展厅网络。
2. 展览影片、您拥有权利的档案录像、报告厅的编码器，以及展厅用的屏幕或媒体播放器。
3. 许可证密钥，以及在馆内没有互联网时的离线激活流程；还要决定服务台由谁销售会员资格。

2基础设施部署

馆内的服务器，在现场激活。

1. 在服务器上运行安装程序，并把播放基础地址设为展厅网络可访问的地址。
2. 在面板中离线激活许可证密钥；激活后服务可在没有互联网的本地网络上运行。
3. 在“电影”下添加展览影片，在“流”下添加报告厅的信号，并在网页播放器中检查它们。
4. 对于第二个场地或大型公共项目，在“服务器”中登记一个节点；面板通过 SSH 安装它，并把该场地的观众路由到它。

3内容组织

展厅、档案和会员专藏。

1. 按展览和年份创建分类，并为一个讲座系列创建一个剧集，每场讲座一集。
2. 为展厅屏幕创建一个频道包，为包含讲座和档案影片的会员资料库再创建一个。
3. 为展厅创建一个套餐，每种会员资格再创建一个，各自授予其频道包；会员套餐的时长就是会员期限。
4. 为每部电影添加海报和简短说明，使资料库在播放器中易于浏览。

4分销商配置

服务台和商店作为委托账户。

1. 创建一个权限仅限线路和激活码、不能访问目录或服务器的分组。
2. 把服务台或商店添加为 reseller，使用该分组、会员套餐和积分余额。
3. 运营多个场馆的文化中心可以为每个场馆添加一个 reseller，各自用自己的余额销售会员资格。

5访客和会员访问配置

屏幕和会员使用线路。

1. 在“线路 → 添加”下为每块展厅屏幕创建一条使用展厅套餐的线路；网络为屏幕分配固定地址时，将其绑定到屏幕的地址。
2. 每销售一份会员资格，就在服务台创建一个激活码；会员在播放器中输入该码，线路即开通。
3. 把每份会员资格的最大连接数设为会员可使用的设备数，通常为两个。
4. 根据会员的设备，把播放器应用、M3U 播放列表或网页播放器地址交给会员。

6展览影片和档案

点播资料库。

1. 把展览影片和数字化档案作为电影上传，或用 VOD 导入任务将其导入媒体根目录。
2. 有 TMDB 元数据的就添加，其余的自行撰写标题和说明。
3. 不对公众开放的档案只放在会员频道包中，并用测试线路检查每个套餐能看到什么。

7开幕式和讲座

把活动变成直播频道。

1. 为报告厅的编码器添加一个直播流（RTMP 推流），并将其放入会员频道包；若是要在屏幕上展示的开幕式，则放入展厅频道包。
2. 启用回看，使迟到的会员可以回退，并在之后把录像上传到资料库。
3. 活动前用测试线路在观众将使用的同一网络上测试编码器和流。

8会员资格到期与续期

会员资格就是线路的有效期。

1. 线路在其套餐的期限结束时到期；在服务台续期会增加一个周期。
2. 会员资格被取消时禁用线路；从未使用的激活码在被兑换之前保持未使用状态。
3. 让商店或会员系统订阅 webhook，以查看即将到期或已到期的线路。

9与商店或会员系统集成

由系统销售访问权限，由播放器负责播放。

1. 为商店或会员系统创建一个 Reseller API 密钥；它调用 create_line、renew_line 和 disable_line，每次写入都带有请求 ID。
2. 会员资格在线销售时使用电商连接器；其他系统使用 Reseller API 和 webhook。
3. 没有面向观众的单点登录：会员使用线路的凭据或激活码登录播放器。

10安全注意事项

把藏品留在它们该在的地方。

1. 让展厅网络与访客网络分开，任何公开访问都放在带 TLS 并设置了 TRUSTED_PROXIES 的反向代理之后。
2. 每个面板账户使用双重验证登录；服务台获得仅限线路和激活码的权限分组。
3. 播放链接带签名且会过期，每份会员资格设置连接数限制，展厅屏幕绑定地址。
4. 启用带异地副本的加密数据库备份，并用审计日志查看线路和目录的变更。

11故障排查

常见的首要检查项。

1. 某块展厅屏幕黑屏：检查其线路已启用且未过期、屏幕的地址绑定，以及服务器在展厅网络上是否可达。
2. 会员的激活码不起作用：检查该码是否已被兑换，以及它所开通的套餐是否仍分配给服务台。
3. 离线许可证激活失败：对照许可证密钥检查激活文件，并检查服务器的时钟。
4. 直播开幕式卡顿：对照上行链路检查编码器的码率，并在“流”下检查该流的状态。