直播服务怎么配置？阿里云与自建
直播配置
这页通常只在初次部署或更换服务商时打开，日常排直播用不到。选哪种也不由管理员拍板：阿里云按并发和流量计费，要提前开好账号；自建 LiveKit 得准备服务器与带宽，属于立项阶段就定下来的事。切换只对之后新建的直播生效，已排好的日程仍走旧方案，所以最好在两场直播之间改，避免同一批学员前后体验不一致。
直播配置用于选择直播底层服务方案，支持阿里云、自建 LiveKit 两种方案类型，二选一填写对应参数。两者的定位不同：阿里云适合大并发单向直播场景，自建 LiveKit 适合小班互动课堂，低延迟双向连麦，并支持课程录制回放。参数由部署人员完成配置，管理员仅需选择服务商，点击【使用此服务商】切换生效，无需理解底层细节。
| 项目 | 说明 |
|---|---|
| 使用角色 | 管理员（超管）；参数由部署人员提供并配置 |
| 入口 | 【系统设置】 → 【系统配置】 → 【直播配置】页签（需操作密码解锁） |
| 前置条件 | 已确定直播方案；阿里云方案需备好推流域名、播流域名及对应密钥，自建 LiveKit 需备好服务地址与 API 密钥 |
| 支持 | 阿里云与自建 LiveKit 两套方案参数维护，点击【使用此服务商】一键切换 |
| 不支持 | 同时启用两套方案（二选一生效）；管理员侧修改底层服务部署参数 |
两种方案对比
| 对比项 | 阿里云 | 自建 LiveKit |
|---|---|---|
| 适用场景 | 大并发单向直播 | 小班互动课堂、低延迟双向连麦 |
| 录制回放 | 按阿里云直播能力 | 支持课程录制回放 |
| 核心参数 | 推流域名、推流秘钥、播流域名、播流秘钥 | 服务地址、API Key、API Secret、Admin 密钥（可选）、Token 有效期、录制存储路径、回放视频地址 |
| 部署形态 | 云服务 | 私有化、内网可部署 |
阿里云方案参数
阿里云方案需填写推流域名、推流秘钥、播流域名、播流秘钥四项参数，由部署人员在云平台控制台开通直播服务后提供；参数填写并保存后，点击【使用此服务商】使该方案生效。
自建 LiveKit 主要参数说明
| 参数 | 说明 |
|---|---|
| 服务地址 | LiveKit 服务连接地址，如 ws://192.168.1.100:7880 或 wss://livekit.example.com |
| API Key / API Secret | LiveKit 接口鉴权密钥，Secret 至少 32 字符 |
| Admin API Key / Secret | 可选，用于 Egress 等管理操作；留空则使用上方 API Key / Secret，与上方相同可留空 |
| Token 有效期（秒） | 默认 3600，控制直播令牌的有效时长 |
| 录制存储路径 | 录制文件存储路径，需与 Egress 容器挂载的目录一致，录制文件按【路径}/{房间 ID}.mp4 命名 |
| 回放视频地址 | 回放视频地址前缀，最终回放地址 = 此前缀 + {房间 ID}_videoType.mp4 |
| 备注信息 | 填写配置用途或环境说明 |
方案选择建议
选择时优先看两件事：规模与互动。规模上，预计同时在线观看人数多、以单向讲授为主的公开课、全员大会，阿里云的并发承载更稳；互动上，需要师生连麦、小班答疑、课程录制回放的培训班，自建 LiveKit 的低延迟双向能力更合适。部署条件也是硬约束：没有公网云资源预算、或要求系统在内网独立运行、数据不出内网的单位，通常只能选自建 LiveKit。两种方案都支持后续通过【使用此服务商】切换，但切换会改变新直播的底层链路，建议在业务空窗期操作并提前通知讲师。
操作步骤
- 用操作密码解锁敏感配置，进入【直播配置】页签；
- 确认本次采用阿里云还是自建 LiveKit，向部署人员索取对应参数；
- 在对应方案区域逐项填写参数（阿里云：推流域名、推流秘钥、播流域名、播流秘钥；LiveKit：服务地址、API 密钥等）；
- 点击【使用此服务商】，让所选方案生效；
- 发起一次测试直播课程，验证开播、观看、连麦（LiveKit）与回放是否正常。
注意事项
- 二选一生效：切换服务商后，直播课程将使用新方案，请提前通知讲师与学员；
- 录制路径一致性：LiveKit 的录制存储路径必须与 Egress 容器挂载目录一致，否则录制文件落盘失败；
- 回放地址拼接规则：最终回放地址由「回放视频地址前缀 + 房间 ID + 视频类型 + .mp4」拼接，改前缀前先确认文件命名未变；
- 密钥安全：推流秘钥、API Secret 属敏感信息，解锁后可见，禁止泄露；
- 参数由部署人员维护：管理员负责选择与切换服务商，参数层面的调整请交由部署人员处理，避免误改导致直播中断。
常见问题
大班公开课和小班互动课可以共用一套直播配置吗？
系统同一时间只生效一套方案，两类课程同时存在时只能选主力场景。大并发单向直播选阿里云；小班互动、需要连麦与回放选自建 LiveKit。必要时用【使用此服务商】在两者间切换，但切换只影响新发起的直播。
点了【使用此服务商】但直播还是不通？
依次检查：参数是否填写完整、有没有多余空格；域名或服务地址是否可解析、是否已备案；防火墙与安全组是否放行对应端口；LiveKit 的 Secret 是否与服务端一致。逐项排除后用一场测试直播定位，看是推流失败还是播放失败。
LiveKit 的课程录制文件在哪里找？
按「录制存储路径 / {房间 ID}.mp4」存放，录制存储路径必须与 Egress 容器挂载的目录一致，否则文件落盘失败。播放时系统用「回放视频地址前缀 + 房间 ID」拼接访问，改前缀前先确认文件命名规则没有变。
切换方案后，正在进行的直播会中断吗？
不会立刻中断。切换影响的是新发起的直播，已经在推流的场次仍按原链路走完；但为避免地址错乱与讲师困惑，建议避开有直播课的时间窗操作，切换前通知到相关讲师与学员，切换后先跑一场测试直播确认。
推流秘钥可以给讲师吗？
不可以。推流秘钥与 API Secret 属敏感配置，一旦泄露他人可向你的直播域名推任意内容。讲师只需在课程【直播日程】里拿推流地址与播放地址，用 OBS 或网页开播即可，不需要接触密钥；密钥由部署与运维人员保管。
阿里云方案的四项参数分别在哪里找？
四项都在阿里云直播控制台：推流域名与播流域名在域名管理里查看，推流秘钥与播流秘钥在对应域名的鉴权配置里生成。四项必须来自同一账号、同一对域名，混用其他环境或其他账号的密钥，会出现能推流但播不出来的情况。
LiveKit 的 API Secret 有什么要求？填短了会怎样？
API Secret 至少 32 个字符，长度不足会在保存或连接时报鉴权失败。建议用随机生成的强密钥，并与 LiveKit 服务端配置文件里的 key/secret 完全一致；只改一端不改另一端，会出现服务地址能连上、却拿不到直播令牌。
Token 有效期设长了有什么风险？
有效期默认 3600 秒，即学员拿到的直播令牌在 1 小时内有效。设得过长，链接一旦被转发，他人在有效期内都能进入直播间；设得过短，长课时直播会在中途断开，学员需要重新进入。按单场计划时长加一定余量设置即可。
自建 LiveKit 录制的文件一直没生成，怎么查？
三个必查点：录制存储路径是否与 Egress 容器挂载目录完全一致；容器对该目录是否有写权限、磁盘是否已满；Admin API Key 是否可用（Egress 依赖管理接口）。三项都正常仍无文件，就看容器日志定位，路径不一致是最常见的原因。
直播配置里的参数和课程里的推流地址是什么关系？
直播配置决定底层用哪家服务，课程【直播日程】里的推流地址与播放地址由该服务按场次生成。也就是先配好服务商并点【使用此服务商】，课程里才会出现可用地址；换服务商后新直播的地址规则随之改变，旧地址不再可用。
内网部署、没有公网，能用阿里云直播吗？
不能。云帆培训考试系统的阿里云直播方案依赖公网推流与播放域名，内网环境访问不到。这类场景应选自建 LiveKit，把服务地址指向内网可达的实例（如 ws://192.168.1.100:7880），讲师与学员在同一内网观看，数据不出内网。
换了直播方案，以前的回放还能看吗？
文件本身还在，但访问链接可能失效。回放是已经生成并落盘或存放在录制路径下的视频，换方案不会删除它们；可回放地址由「回放视频地址前缀 + 房间 ID」拼接，前缀随方案改变后旧链接就拼不出来。切换前先确认原地址规则，并抽查几场历史回放。
改完直播配置要重启服务吗？多久生效？
不需要重启。参数保存并点击【使用此服务商】后立即生效，此后新发起的直播按新方案运行，已排期的直播在开播时读取最新配置。稳妥做法是改完先发起一场测试直播，确认开播、观看与回放都正常，再用于正式课程。
怎么确认直播配置真的生效了？
用一场测试直播验收：新建一条直播日程，把推流地址复制到 OBS 推流，看管理端【预览】是否有画面；用一个学员账号进入课程观看；结束推流后等回放生成，点开确认能播。三段都通才算配置成功，只看保存成功的提示不够。