CSS CDN 对接与播放地址
将 CSS CDN 对接为以 StreamPackage 端点作为源站。这不是只改一个域名字符串的工作,而是要确认服务间权限、域名配置、DNS、证书以及实际播放的完整过程。
前置准备
- 准备好 StreamPackage 频道与端点。
- 确认已开通 CSS 并拥有播放域名的使用权限。
- 准备域名所有权 / DNS 配置权限以及 HTTPS 证书。
- 确认源站端点的访问策略。
控制台对接顺序
- 在 StreamPackage 频道详情的 CDN 页签中确认 Authorization 流程。
- 授权服务角色权限,使 StreamPackage 能够配置 CSS。
- 同时确认反方向的权限,使 CSS 能够访问 StreamPackage 源站。
- 绑定播放域名。如果当前界面引导你前往 CSS 控制台设置,请按该路径跳转。
- 将提示的 CNAME 登记到 DNS。
- 确认 HTTPS 证书与回源请求配置。

除控制台的 Enabled 状态外,还要确认证书有效性与实际视频播放。
播放 URL 的构成
域名绑定完成后,把端点 URL 的主机名换成播放域名,路径保持不变。
| 分类 | 格式示例 |
|---|---|
| 源站 | https://PACKAGE_HOST/v1/CHANNEL/ENDPOINT/index.m3u8 |
| CDN | https://PLAYBACK_HOST/v1/CHANNEL/ENDPOINT/index.m3u8 |
路径与文件名请使用实际的端点取值。回源访问认证与观众访问认证是两个不同环节的策略。
API 对接示例
API 对接需使用目标频道 ID 与域名,对接完成后请确认实际播放。
bash
tccli mdp BindNewLVBDomainWithChannel --region ap-seoul \
--ChannelId YOUR_CHANNEL_ID \
--LVBDomain YOUR_PLAYBACK_DOMAIN源站与 CDN 的对比
bash
STREAM_ORIGIN_URL='https://PACKAGE_HOST/YOUR_ENDPOINT/index.m3u8'
STREAM_CDN_URL='https://PLAYBACK_HOST/YOUR_ENDPOINT/index.m3u8'
curl --silent --show-error --fail-with-body --max-time 20 "$STREAM_ORIGIN_URL"
curl --silent --show-error --fail-with-body --max-time 20 "$STREAM_CDN_URL"请分别应用各自所需的认证。主播放列表打开后,使用列表中实际写明的媒体 URL,并一直确认到分片请求为止。
| 现象 | 优先确认项 |
|---|---|
| 从源站开始确认结果 | 输入推流、输出目标地址、端点路径与回源认证 |
源站正常 / CDN 403 | 双向服务权限、回源请求的 Host / 路径 / 认证、观众访问策略 |
| TLS | 证书有效期、主机名、证书链 |
| 主列表正常 / 子列表需确认结果 | 相对 URI 的解析、请求路径与查询参数 / 请求头的传递 |
| 列表停止更新 | 源站推流状态、CDN 列表的缓存策略 |
| 响应时间 | DNS / 网络 / 源站延迟以及各环节的响应 |
出现 403 或访问类响应时,请确认该域名的认证 / 回源路径 / 权限。配置生效后,请按同一路径重新验证。
收尾与解除对接
确认是否有其他观众正在使用后,仅解除测试用的对接。
bash
tccli mdp UnbindCdnDomainWithChannel --region ap-seoul \
--ChannelId YOUR_CHANNEL_ID \
--LVBDomain YOUR_PLAYBACK_DOMAIN解除对接可能影响已有播放。不必要的频道 / 传输以及 CDN 用量需另行确认。