域名配置
最近更新时间：2024.04.08 10:23:40
首次发布时间：2021.11.09 14:47:27
本章节为您介绍推域名配置的操作方法，配置内容包括修改加速区域、切换域名空间、HTTPS 配置、访问控制等。
推流域名和拉流域名支持的配置项如下：
| 域名类型 | 支持的配置项 |
|---|---|
| 推流域名 | 修改加速区域、修改域名空间、HTTPS 配置、URL 鉴权、IP 黑白名单、推流限额 |
| 拉流域名 | 修改加速区域、修改域名空间、Referer 防盗链、HTTPS 配置、URL 鉴权、IP 黑白名单、HTTP 响应头、带宽限额、HTTP 请求头 |
修改加速区域
说明
不同加速区域下的地区，直播服务费的价格不同。修改加速区域前，请参考直播服务费了解不同加速区域下各地区的价格详情。
- 登录视频直播控制台。
- 选择左侧导航的域名管理，在域名管理页面单击待配置域名右侧的域名配置，进入域名配置页面。
- 在域名信息单击加速区域后的修改，在弹出的对话框中修改加速区域。
域名空间配置
登录视频直播控制台。
选择左侧导航的域名管理，在域名管理页面单击待配置域名右侧的域名配置，进入域名配置页面，选择基本信息页签。
在域名空间模块您可以查看当前域名所在的域名空间信息。
单击切换域名空间，您可以更改当前域名所在的域名空间。
单击项目组和标签后的修改，您可以更改域名空间的的项目组和标签配置。
HTTPS 配置
说明
进行 HTTPS 配置前，请先参考证书管理完成证书添加。
登录视频直播控制台。
选择左侧导航的域名管理，在域名管理页面单击待配置域名右侧的域名配置，进入域名配置页面。
选择 HTTPS 配置页签，在 HTTPS 模块打开配置开关或单击编辑配置，弹出编辑 HTTPS 信息对话框。
在弹出的对话框中选择证书并设置支持的 TLS 协议的版本范围。
说明
- 待选择的证书仅展示 DNS Name 包含该域名的证书，参考如何查看证书中的 DNS Name。
- HTTPS 安全加密配置生效时约为 10 分钟，如果配置后长时间未生效，请联系我们获取技术支持。
Referer 防盗链
说明
只有拉流域名支持配置 Referer 防盗链。
登录视频直播控制台。
选择左侧导航的域名管理，在域名管理页面单击待配置域名右侧的域名配置，进入域名配置页面。
选择访问控制页签，在 Referer 防盗链 模块，打开配置开关或单击编辑配置，弹出配置防盗链规则对话框。
在弹出的编辑 Referer 防盗链对话框中配置防盗链规则。
参数 说明 防盗链类型
选择防盗链的类型单选项：
- 黑名单：规则配置的域名或泛域名不能访问资源；
- 白名单：规则配置的域名或泛域名可以访问资源。
防盗链规则
Referer 匹配逻辑为精确匹配，请输入完整的域名或泛域名：
- 支持添加多个域名，域名间使用回车作为分隔符；
- 支持添加域名数阈值为 100，支持添加泛域名；
- 域名不可重复。
说明
如果需要添加更多域名，请联系我们增加域名数阈值。
Referer 匹配逻辑（以配置域名
www.example.com为例）：- 配置
www.example.com时，www.example.com，http(s)://www.example.com、www.example.com/、http(s)://www.example.com/path均无法匹配。 - 配置
*.example.com时，可以匹配http(s)://www.example.com，无法匹配http(s)://www.example.com/。 - 配置
*.example.*时，可以匹配www.example.com，http(s)://www.example.com、www.example.com/、http(s)://www.example.com/path
空 Referer 勾选后会对空 Referer 进行验证。 完成配置后单击确定。
URL 鉴权
说明
- URL 鉴权用于保护直播资源，推荐为推拉流域名都开启 URL 鉴权；
- 新增的推流域名默认开启 URL 鉴权；新增的拉流域名需要手动开启 URL 鉴权。
- 配置生效需要大约 5 分钟;
- 如果 URL 鉴权无法满足您的业务需求，请联系我们获得技术支持。
登录视频直播控制台。
选择左侧导航的域名管理，在域名管理页面单击待配置域名右侧的域名配置，进入域名配置页面。
选择访问控制页签，在 URL 鉴权 模块，打开配置开关或单击编辑配置，弹出编辑 URL 鉴权对话框。
在弹出的编辑 URL 鉴权对话框中配置 URL 鉴权信息。
字段 说明 加密算法 使用 md5 算法加密 主 KEY - 默认随机生成主要密码；
- 支持自定义，密码长度不超过 100 个字符，支持输入阿拉伯数字、大小写英文字母。
备 KEY 备用 KEY 默认为空，与主 KEY 的配置规则相同 有效时长 一次鉴权后默认生效的时长 - 默认为 600s；
- 支持自定义，时间范围为 60s～2592000s。
完成配置后单击确定。
IP 黑白名单
登录视频直播控制台。
选择左侧导航的域名管理，在域名管理页面单击待配置域名右侧的域名配置，进入域名配置页面。
选择访问控制页签，在 IP 黑白名单 模块，打开配置开关或单击编辑配置，弹出编辑 IP 黑白名单对话框。
在弹出的编辑 IP 黑白名单对话框中配置 IP 信息。
参数 说明 名单类型
单选项，支持选择黑名单或白名单。
- 两种名单互斥，只能所选的生效；
- 黑名单内 IP 无法访问资源；
- 只有白名单的 IP 可以访问资源。
规则
支持 IP 和 IP 段。
- 支持 100 个 IP 地址，支持掩码；
- IP 不可重复；
- 如果有更大的 IP 需求可以联系售后工程师进行修改。
完成配置后单击确定。
HTTP 响应头配置
HTTP 响应头是指服务器在发送 HTTP 响应时，在响应体之前发送的一系列头部字段。这些头部字段提供了有关响应的元数据信息，例如响应的状态码、内容类型、缓存控制、Content-Encoding、Content-Disposition 等。
说明
- 只有拉流域名支持配置 HTTP 响应头。
- 支持为拉流域名配置响应头信息，配置并开启后会对该应下任意资源的响应消息生效。
登录视频直播控制台。
选择左侧导航的域名管理，在域名管理页面单击待配置域名右侧的域名配置，进入域名配置页面。
选择访问控制页签，在HTTP 响应头模块，打开配置开关或单击编辑配置，弹出 HTTP 响应头设置对话框。
在 HTTP 响应头设置对话框自定义或选择已有响应头参数进行配置。
支持自定义参数或选择预置参数，常见预置参数说明如下所示。
预置响应头参数 说明 Content-Type 响应对象的内容类型。 Cache-Control 请求和响应应遵循的缓存机制。 Content-Disposition 请求所得的内容作为一个文件时提供的默认文件名。 Expires 响应对象的过期时间。 Access-Control-Allow-Origin 允许的跨域请求来源。 Access-Control-Allow-Headers 允许的跨域请求字段。 Access-Content-Allow-Methods 允许的跨域请求方法 Access-Control-Max-Age 请求返回结果的缓存时间。 Access-Control-Expose-Headers 允许访问的自定义头信息。 支持使用常量或预置变量对参数赋值，支持使用的变量值说明如下所示。
参数值变量 说明 ${domain} 客户端拉流请求中使用的域名。 ${uri} 客户端拉流请求中不包括查询参数的路径。如果请求被重写，则表示重写后的路径。 ${args} 客户端拉流请求中的查询参数。如果请求被重写，则表示重写后的参数。 ${remote_addr} 发送拉流请求的客户端 IP 地址。 ${server_addr} 响应客户端拉流请求的边缘服务器的 IP 地址。 单击确定。
推流限额
说明
只有推流域名支持配置推流限额。
登录视频直播控制台。
选择左侧导航的域名管理，在域名管理页面单击待配置域名右侧的域名配置，进入域名配置页面。
在推流限额 模块，打开配置开关或单击编辑配置，弹出推流限额对话框。
在弹出的推流限额对话框中配置限额参数。
参数 说明 限制路数 输入推流的路数上限，当路数超过配置值时，视频直播将拒绝新的推流请求，取值范围为 [10,200000]。 告警阈值 输入推流的告警阈值，当路数超过配置值时，视频直播将通过短信和站内信发送告警信息。取值范围为 [10,200000]，且告警阈值需要小于等于限制路数。 配置完成后，单击确定保存配置。
带宽限额
说明
- 只有拉流域名支持配置带宽限额。
- 当前只有 RTM、FLV、RTMP 协议拉流时支持设置带宽限额，HLS、CMAF 协议拉流时带宽限额配置不生效。
登录视频直播控制台。
选择左侧导航的域名管理，在域名管理页面单击待配置域名右侧的域名配置，进入域名配置页面。
选择高级设置页签，在带宽限额 模块，打开配置开关或单击编辑配置，在弹出带宽限额对话框。
在弹出的带宽限额对话框中配置限额参数。
参数 说明 限制额度 输入拉流带宽峰值，支持 Mbps、Gbps、Tbps 三种计量单位。 当拉流带宽峰值超过配置值时，视频直播将拒绝新的拉流请求，取值范围为 [1,10000] 告警阈值 输入拉流带宽峰值的告警阈值，支持 Mbps、Gbps、Tbps 三种计量单位。当拉流带宽峰值超过配置值，视频直播将通过短信和站内信发送告警信息。取值范围为 [1,10000]，且告警阈值需要小于等于限制额度 完成配置后单击确定。
HTTP 请求头配置
HTTP 请求头是指在 HTTP 请求中发送的一系列头部字段，用于向服务器传递额外的信息和请求参数。
说明
- 只有拉流域名支持配置 HTTP 响应头。
- 支持为拉流域名设置 HTTP 请求头，配置并开启后，回源请求将携带您配置的请求头信息。
- 请求头参数不区分大小写。
登录视频直播控制台。
选择左侧导航的域名管理，在域名管理页面单击待配置域名右侧的域名配置，进入域名配置页面。
选择高级设置 页签，在HTTP 请求头模块，打开配置开关或单击编辑配置，弹出 HTTP 请求头设置对话框。
在 HTTP 请求头设置对话框自定义或请求头参数及参数值。
支持使用常量或预置变量对参数赋值，支持使用的变量值说明如下所示。
参数值变量 说明 ${upstream_host} 客户端拉流请求中使用的域名。 ${upstream_uri} 客户端拉流请求中不包括查询参数的路径。如果请求被重写，则表示重写后的路径。 ${upstream_args} 客户端拉流请求中的查询参数。如果请求被重写，则表示重写后的参数。 ${remote_addr} 发送拉流请求的客户端 IP 地址。 单击确定。
常见问题
如何查看证书中的 DNS Name
- 双击打开安全证书（.crt 格式）。
- 进入详细信息页签，选中使用者可选名称字段即可看到 DNS Name。
