企业培训部署指南

概念对应

面板中没有任何东西叫作部门或员工。下表说明哪个对象扮演什么角色；下面的各章按此顺序进行设置。

1前提条件

安装前需要准备什么。

1. 各办公室都可访问的一台公司服务器（Ubuntu 22.04 或 24.04）、安装程序，以及反向代理之后的内部地址或域名。
2. 培训录像、用于直播课程的礼堂编码器，以及人事或 LMS 系统调用 HTTP API 的能力。
3. 关于保密的决定：哪些资料放进哪个部门集合，以及人事和培训团队中谁获得面板账户。

2基础设施部署

先总部，后办公室。

1. 在总部服务器上运行安装程序；把面板放在公司的反向代理之后，并设置受信任的代理，使审计日志能看到真实地址。
2. 把播放基础地址设为内部地址；网络之外的员工通过 VPN 或代理访问。
3. 在 Servers 中为每个办公室登记一个节点；面板通过 SSH 安装它，并把该办公室的观众路由到它。
4. 为培训团队创建一个分销商账户，拥有目录权限，但没有员工线路的权限。

3内容组织

按部门划分集合，课程作为剧集。

1. 按主题创建分类，每门多部分课程创建一个剧集，每次课程一集。
2. 为每个部门培训集合创建一个频道包，并为所有人都能看到的资料创建一个全员频道包。
3. 为每个角色创建一个套餐：该角色所需的频道包，不含其他，并设置较长的时长（例如一年）作为访问期限；续期会再增加一个期限，合同结束时由人事禁用该线路。
4. 在名称中明确标出机密集合；线路只能看到其套餐所授予的频道包。

4分销商配置

培训团队，以及对于集团而言的每家子公司。

1. 为培训团队创建一个拥有目录权限的分组，为人事创建一个拥有线路权限的分组。
2. 用这些分组把培训团队和人事添加为分销商；在内部部署中两者都不需要点数。
3. 拥有自己资料库的子公司获得自己的分销商、自己的频道包和自己的套餐。

5员工访问配置

由人事创建，每位员工一条线路。

1. 为人事系统创建一个 Reseller API 密钥，并保存在人事系统的密钥存储中。
2. 入职时，人事系统使用该角色的套餐和一个请求 ID 调用 action=create_line（套餐的时长即访问期限）；离职时调用 action=disable_line。
3. 将最大连接数设为员工可使用的设备数（通常为两台：办公桌和手机）。
4. 试点阶段，通过 Lines → 添加 来添加线路，并把凭据交给少数员工。

6培训资料

点播录像。

1. 把每份录像作为一集的来源上传，或通过点播入库任务入库；保留标题和简短简介。
2. 通过其剧集把录像挂到正确的部门频道包下。
3. 用每个角色的测试线路检查播放，以确认谁能看到什么。

7内部培训课程

把课程作为直播频道。

1. 为礼堂的编码器添加一个直播流（RTMP 推流）；放入全员频道包或某个部门的频道包。
2. 启用回看，让迟到的人可以倒回观看，并在事后把录像上传到资料库。
3. 各办公室的节点只从源站拉取一次课程，并在本地为员工提供服务。

8访问到期

访问权限随合同结束而终止。

1. 线路在其套餐期限结束时到期；合同期间人事通过 action=renew_line 为其续期，合同结束时人事将其禁用。
2. 让人事系统订阅 webhook，以便把即将到期和已到期的线路与它自己的记录核对。
3. 对于临时访问（外包人员、入职周），使用较短的到期时间，而不是单独的套餐。

9与人事系统或 LMS 集成

系统负责控制访问；播放器负责播放。

1. 人事系统通过 Reseller API 创建、续期和禁用线路；LMS 可从课程页面链接到网页播放器。
2. 没有面向观众的单点登录：员工使用您的系统签发的线路凭据登录播放器。
3. 为内部报表工具使用带只读标记的 Admin API 密钥。

10安全注意事项

从网络到线路的保密性。

1. 让平台保留在内部网络中，或放在启用 TLS 的反向代理之后；相应地设置 TRUSTED_PROXIES。
2. 每个面板账户启用双重验证登录；使用权限分组，使人事无法修改目录，培训团队无法查看线路。
3. 带签名且会过期的播放链接、每条线路较低的连接数限制，以及设备固定时的地址绑定。
4. 带异地副本的加密数据库备份；线路和目录的每次变更都记入审计日志。

11故障排查

常见的首要检查项。

1. 某位员工看到了其他部门的资料：检查该线路的套餐及其授予的频道包。
2. 新员工没有访问权限：检查人事的调用是否成功（Reseller API 调用日志）以及线路的到期时间。
3. 某个办公室在直播课程期间卡顿：检查该办公室节点的心跳，以及观众是否被路由到它。
4. 审计日志显示的是代理的地址：将 TRUSTED_PROXIES 设为该代理，并重启面板。