本文为您介绍视频点播CDN相关常见问题。
问题分类
购买和计费
无法访问/访问异常
添加域名/域名解析
缓存相关
回源/源站
HTTPS相关
刷新/预热
安全相关
如何查看新购买的加速资源包（视频点播流量包）？
仅支持查询当前有效资源包及失效时间未超一年的资源包的使用明细。
登录费用与成本。
在左侧导航栏选择资源实例管理。
在资源实例管理页面，资源维度选择资源包，可以查看资源包使用明细。
您可以设置产品名称为视频点播，或者设置生效时间、状态等其他过滤条件来查询资源包。
为什么监控查询流量、用量查询流量与日志统计流量有差异？
问题现象
为什么通过视频点播控制台（或者OpenAPI）的监控查询、资源用量查询（实际计费流量）功能查到的加速域名使用的流量数据与通过日志统计的流量数据有差异？（通过日志统计的流量数据通常会比通过监控查询流量或者用量查询流量查询的数据更小一些。）
可能原因
日志统计流量是统计日志中response size字段记录的流量数据，只统计了应用层产生的流量，但实际产生的网络流量（网络层统计的流量）通常比应用层流量要高出7%~15%。主要原因是网络层流量比应用层流量多了以下两个流量消耗：
TCP/IP包头：应用层流量在开始网络传输之前，需要先使用TCP协议（传输层）封装为TCP数据包，再使用IP协议（网络层）封装为IP数据包，IP数据包最大为1500字节，这其中包含了20字节TCP协议包头和20字节IP协议包头，这两个协议包头也会产生网络流量，但由于应用层无法统计到这两个包头的流量，因此日志统计流量里不包含这40字节。这部分包头消耗的网络流量至少占通过日志统计流量的2.74%（按最大IP数据包1500字节，其中TCP/IP包头40字节，应用层数据1460字节），应用层数据越小占比越大，通常在3%左右。
TCP重传由于互联网中网络情况较为复杂，在出现网络拥堵、设备故障等情况下就会出现丢包，通常有3%~10%的数据会被互联网丢弃，数据包被丢弃后的重传动作是由操作系统内核层的协议栈处理的，无法记录到应用层日志中，因此这部分也会产生额外的网络消耗。
基于以上两个额外的网络流量消耗，在行业惯例中，会在基于日志中response size字段统计出的应用层流量的基础上，再加上7%~15%的网络消耗来得出实际的计费流量数据（即：体现在费用账单上的数据）。视频点播CDN中取平均值10%作为网络消耗流量，因此实际的计费流量（也包括监控查询流量）是通过日志统计流量的1.1倍（即：TCP系数1.1）。
源站不在中国内地，使用中国内地CDN节点加速如何收费？
当您的源站在中国香港、中国澳门、中国台湾或海外时，使用中国内地CDN节点加速时，按照中国内地CDN加速服务标准收费。
由于CDN收费只针对CDN节点的下行流量收费，因此您使用中国内地的CDN加速服务，而源站在海外，CDN的收费仍然按中国内地CDN加速服务标准收费，但是这样会影响加速性能。因为中国内地CDN节点回源访问海外源站时，可能会出现延迟。如果您的源站和用户都在海外，则建议您开启全球加速服务。
购买视频点播套餐包后，资源包可以在CDN、OSS中使用吗？
不可以。视频点播是一款独立计费的产品，在使用过程中，会产生存储、转码、流量或带宽的消费。视频点播套餐包内的各项资源包（即流量包、存储包、高清转码包）仅限于抵扣视频点播产品内产生的资源消耗，无法在CDN、OSS等同类型资源消耗产品中使用。
已经购买了视频点播流量包，为什么依然产生流量费用？
视频点播流量包生效条件为已配置加速域名，且加速服务的计费方式选择为按流量计费。视频点播流量包生效后，仅用于优先抵扣加速流量，不包含存储流出流量。当超出所购流量包抵扣额度的用量后，产生的流量将计入按量计费产生后付费账单。当产生流量扣费时，请确认是否存在以下情况：
被攻击或恶意盗刷产生的流量和请求是否收费？
客户流量被恶意盗刷或者被攻击而产生突发带宽增高，因为实际消耗了视频点播的带宽资源，所以您需要自行承担攻击产生的流量带宽费用。
您可以提升视频的安全性或设置带宽峰值预警，来应对流量被恶意盗刷或者被攻击。
CDN节点在响应4xx状态码的情况下是否会产生费用？
会。您的加速域名可能会受到攻击或者被恶意盗刷流量，面对类似问题的时候，您可以给加速域名配置Referer防盗链、URL鉴权、远程鉴权、IP黑/白名单、UA黑/白名单等访问控制功能，命中访问控制规则的恶意请求将会收到CDN节点响应的4xx状态码，从而阻止恶意请求对您资源的访问。在该情况下，CDN节点处理恶意访问请求的过程中需要消耗CPU处理资源，CDN节点响应恶意请求4xx状态码的过程中需要消耗流量带宽资源，因此您仍然需要承担CDN节点响应4xx状态码的情况下产生的流量带宽费用。有关视频点播的流量计费详情，请参见加速服务计费。
使用配置好的域名访问视频点播资源返回404
Web服务器返回HTTP 404状态码时，会自动跳转到404页面。由于网页URL生成规则改变、网页文件更名或移动位置、导入链接拼写错误等，导致原来的URL地址无法访问。当Web服务器接收到类似请求时，会返回一个404状态码，告诉浏览器需要请求的资源并不存在。
请确保资源所在的存储与域名的匹配关系，若同区域下存在多个存储，且只有一个域名时，对于其他未绑定域名的存储资源，点播控制台会优先返回上述区域下的CDN地址。
定位CDN访问异常是CDN节点问题还是源站问题
访问阿里昆仑用户诊断工具，确认本地网络正常。
在本地hosts文件中添加源站的解析，进行站点访问测试。如果访问源站时出现异常，说明是您的源站存在问题。请联系站点管理员进行修复。
# Copyright (c) 1993-2009 Microsoft Corp. # # This is a sample HOSTS file used by Microsoft TCP/IP for Windows. # # This file contains the mappings of IP addresses to host names. Each # entry should be kept on an individual line. The IP address should # be placed in the first column followed by the corresponding host name. # The IP address and the host name should be separated by at least one # space. # # Additionally, comments (such as these) may be inserted on individual # lines or following the machine name denoted by a '#' symbol. # # For example: # # xxx.xxx.xxx.xxx xxx.com # source server # xxx.xxx.xxx.xxx xxx # x client host # localhost name resolution is handled within DNS itself. # 127.0.0.1 localhost # ::1 localhost 1xxx.xxx.xxx7 www.xxx.com备注上一步添加的本地hosts解析，通过ping命令测试添加的加速域名，如果能ping通，说明CDN节点正常。
C:\Users\xxx>ping www.xxx.com 正在 Ping xxx.com [1xx.xxx.xxx.x] 具有 32 字节的数据: 来自 1xx.xxx.xxx.x 的回复: 字节=32 时间=3ms TTL=54 来自 1xx.xxx.xxx.x 的回复: 字节=32 时间=3ms TTL=54 来自 1xx.xxx.xxx.x 的回复: 字节=32 时间=3ms TTL=54 来自 1xx.xxx.xxx.x 的回复: 字节=32 时间=4ms TTL=54 1xx.xxx.xxx.x 的 Ping 统计信息: 数据包: 已发送 = 4，已接收 = 4，丢失 = 0 (0% 丢失)， 往返行程的估计时间(以毫秒为单位): 最短 = 3ms，最长 = 4ms，平均 = 3ms
视频点播播放出现卡顿及 4008/4009 报错如何排查？
出现播放卡顿或 4008/4009 报错时，可按以下步骤排查：
使用播放链接检测工具自助诊断视频播放链路。
确认客户端网络环境（如 4G）是否稳定，下行带宽是否不低于视频码率，建议切换网络进行测试。
检查播放 URL 或 TS 分片地址是否可正常访问，排除 CDN 节点响应异常。
若为加密 HLS 播放场景，检查播放器配置中的
loadDataTimeout参数是否设置过短。通过浏览器开发者模式查看请求详情，确认是否存在特定分片加载超时（对应
4008错误）或返回 0 字节（对应4009错误）的情况。
开通全球加速后没有提高海外用户的访问速度
可通过以下几点进行排查：
当海外用户访问时，查看访问请求中域名解析的IP地址，判断海外节点的配置是否生效。
海外节点配置后的效果还和访问的请求热度有关。只有海外节点的请求热度较高时，才能有效提升访问速度。如果请求数量很低，则会有较少的请求能够命中缓存，在这种情况下，即使增加海外节点也无法明显地提高海外用户的访问速度。
视频点播中加速域名已开启试看功能但MP4视频试看不生效
视频点播的试看功能支持的文件格式为MP4、HLS。其中，MP4视频的Meta信息必须在文件头部，不支持Meta信息在尾部的MP4视频。通过视频点播服务转码封装格式为MP4的时候，会将Meta信息放置在文件头部。您可以通过将此类MP4视频进行转码来解决试看不生效的问题，转码详情请参见音视频转码。
内网播放视频点播需放行网络策略
视频点播 CDN 不支持内网服务。内网环境需通过以下方案之一访问视频点播：
放行域名：开通公网出站访问，放行 API 域名
vod.<RegionId>.aliyuncs.com:443及 CDN 加速域名。无需维护动态 IP。获取 CDN 节点 IP：调用
DescribeUserVipsByDomain接口获取 CDN L1 节点 IP，并加入防火墙白名单。由于 CDN 节点 IP 为动态分配，需定期刷新白名单。使用 OSS 内网域名：使用
outin-<bucket_id>.oss-<RegionId>-internal.aliyuncs.com替换加速域名，绕过 CDN 直接访问源站。
视频点播加速域名与网站主域名能否使用同一个域名？
不能共用。网站主域名（例如 www.example.com）应解析到自有网站服务器；另使用独立子域名（例如 vod.example.com）作为视频点播加速域名接入视频点播服务，并在业务中引用该子域名播放视频。
视频点播支持配置泛域名加速吗？
视频点播支持通过 AddVodDomain API 添加泛域名，泛域名需以英文句号（.）开头，如：.aliyundoc.com。
添加域名时提示“该域名的根域名已被其他账号占用”错误
在视频点播控制台添加域名失败并报错该域名的根域名已被其他账号占用，错误信息为The root name of your domain is reserved by other account，please contact our Business Advisors，则表明该域名的根域名已被其他阿里云账号添加到阿里云CDN或全站加速或视频点播控制台上。
如果您无法自行解决，请您提交工单。关于如何提交工单，请参见联系我们。
添加域名时提示“This domain name is exist already”错误
在视频点播控制台添加域名失败并报错This domain name is exist already，则表明该域名已经被添加到阿里云的其他云产品中。
加速域名不允许重复添加，出现上述提示时，请检查您的域名是否已经添加到其他云产品中，例如视频直播、全站加速、SCDN和视频监控等。
如果您无法自行解决，请您提交工单。关于如何提交工单，请参见联系我们。
如何测试CNAME解析是否正常？
不推荐使用 ping 命令验证,ping 命令返回的解析信息可能不准确。应使用 nslookup 或 dig 等查询工具验证。
Windows
在Windows系统的命令提示符（CMD）或PowerShell中，执行以下命令查询CNAME记录：
nslookup -type=CNAME <加速域名>如果返回的结果和CDN提供的CNAME值相等，则证明CNAME解析生效。
PS C:\Users\admin> nslookup -type=cname cdn.xxx.com 服务器：UnKnown Address: 100.xxx 非权威应答： cdn.xxx.com canonical name = cdn.xxx.com.w.alikunlun.comLinux/Mac OS
在Linux或Mac OS系统的终端（Terminal）中，使用
dig命令验证：仅查询CNAME目标地址（推荐）：
dig +short <加速域名> CNAME如果返回的结果和CDN提供的CNAME值相等，则证明CNAME解析生效。结果示例如下：
dig +short cdn.example.com CNAME cdn.example.com.w.alikunlun.com.查询域名详细信息：
dig <加速域名> CNAME如果屏幕中
ANSWER SECTION的CNAME值和CDN提供的CNAME值相等，则证明CNAME解析生效。xxx ~ % dig cdn.xxx.com CNAME ; <<>> DiG 9.10.6 <<>> cdn.xxx.com CNAME ;; global options: +cmd ;; Got answer: ;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 62811 ;; flags: qr rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 1 ;; OPT PSEUDOSECTION: ; EDNS: version: 0, flags:; udp: 4000 ;; QUESTION SECTION: ;cdn.normanjing.com. IN CNAME ;; ANSWER SECTION: cdn.normanjing.com. 600 IN CNAME cdn.xxx.com.w.alikunlun.com. ;; Query time: 67 msec ;; SERVER: 30.30.xxx) ;; WHEN: Wed Sep 24 19:05:30 CST 2025 ;; MSG SIZE rcvd: 92
新添加的加速域名审核未通过
所有接入视频点播的域名都要经过内容审核，若您的域名接入视频点播失败，可能是您的域名不符合接入规则，关于域名接入的标准及使用限制，请参见域名准入标准。
如果您的域名审核未通过，请在视频点播控制台进入配置管理 > 分发加速配置 > 域名管理的域名列表页查看未通过原因，并将审核失败的域名删除后，根据域名审核未通过的原因，调整网站内容，重新添加域名等待审核即可。
如何提升视频点播缓存命中率
如果发生命中率过低的情况意味着用户的每次请求都会通过CDN回源，公网链路的不稳定可能导致加速的效果反而变差。您可以通过预热URL、配置资源缓存规则、过滤URL中可变参数提升视频点播的缓存命中率。
具体方案如下：
策略 | 影响因素与应用场景 | 配置方法 |
业务高峰前预热热门资源 | 影响因素：运营大型活动或新版本安装包发布前，没有提前将资源预热到CDN节点，大量资源需要从源站获取，导致CDN缓存命中率低。 应用场景：
| |
合理配置缓存过期时间 | 影响因素：
应用场景：用户在源站发布了静态资源，CDN节点没有将资源缓存下来，或者CDN节点上缓存的资源很快就失效了。 配置建议：
| |
去除URL中问号后的参数缓存 | 影响因素：当URL请求中带有queryString或其他可变参数时，访问同一个资源的不同URL（URL携带的参数不同）会重新回源，导致CDN缓存命中率低。 应用场景：希望通过不同的URL（URL携带的参数不同），可以访问到同一个资源。 | |
大文件设置分片回源策略 | 影响因素：用户下载安装包可能下载一半就停止下载，或者观看视频只看了一部分就停止观看，即用户只需要访问资源文件指定范围内的部分内容，但是CDN节点会向源站请求整个文件，从而使得CDN节点从源站下载的内容大于响应给用户的内容，导致缓存命中率低。 应用场景：用户下载应用安装包或者观看视频资源。 |
在视频点播配置加速域名后加速资源访问速度较慢
加速域名主要是通过在现有网络中增加一层新的缓存节点，将网站服务器的资源发布到最接近用户的网络节点，使得用户侧客户端在请求时直接访问到就近的CDN节点并命中该资源，减少回源情况，提高网站访问速度。因此，造成访问慢的可能原因可以简单归纳为以下几个类型：
客户端本地网络因素，例如客户端下行带宽不足、配置错误等。
客户端到CDN节点之间的网络不佳，网络延迟较高。
CDN节点异常，响应速度慢。
资源内容比较大，导致下载比较耗时。
CDN回源到源站时，回源网络不佳。
源站本身响应速度慢。
请求加速资源时出现跨域问题并提示“The 'Access-Control-Allow-Origin' header has a value 'xxx' that is not equal to the supplied origin”
请求加速资源失败并报错The 'Access-Control-Allow-Origin' header has a value 'xxx' that is not equal to the supplied origin，浏览器开发者工具的 Console 面板显示 CORS 跨域错误：请求的 origin（https://vr-mc01.xxx）与响应头 Access-Control-Allow-Origin 的值（https://vr-web01.xxx）不一致，导致资源加载失败（net::ERR_FAILED），并引发后续 JS 运行时错误。从上述报错内容可以看出，CDN响应的Access-Control-Allow-Origin跨域头的Value值，和客户端请求的Origin跨域头不一致，导致浏览器没有响应这个请求。例如，请求跨域头为“Origin:http://域名A”，但是响应的跨域头为“Access-Control-Allow-Origin:http://域名B”。
出现该问题的原因有以下三种情况：
CDN配置的跨域头和客户端请求的Origin不一致
源站配置的跨域头被CDN缓存
浏览器缓存
视频点播加速域名是否支持使用主域名 SSL 证书？
不支持直接使用主域名证书。必须为视频点播加速域名单独配置与该域名匹配的子域名证书，可以使用覆盖该子域名的泛域名证书或单域名证书。
如果当前没有该子域名的证书，可在数字证书管理服务（云盾）申请个人测试证书（免费版），然后在视频点播控制台的域名管理页面为加速域名完成 HTTPS 设置。
配置 HTTPS 证书时误填 CSR 文件导致失败怎么办？
失败原因是误将 CSR（证书请求文件）作为证书内容填入。证书请求文件以 -----BEGIN CERTIFICATE REQUEST----- 开头，不能作为正式证书部署。
按以下步骤重新配置：
在数字证书管理服务控制台打开对应证书的证书实例详情页面。
找到以
-----BEGIN CERTIFICATE-----开头的正式证书内容，并获取与该证书对应的私钥。登录视频点播控制台，依次选择配置管理 > 分发加速配置 > 域名管理，选择需要配置证书的域名。
在 HTTPS 设置中完整粘贴正式证书内容和对应私钥，然后保存配置。
SSL 证书部署提示 InsufficientQuota 额度不足怎么办？
InsufficientQuota 表示证书部署次数的部署额度不足，可选择以下任一方法处理：
购买部署额度：在数字证书管理服务控制台购买相应的部署额度，然后重新部署证书。
在视频点播控制台手动更新证书：此方法无需付费。登录视频点播控制台，依次选择配置管理 > 分发加速配置 > 域名管理，在域名列表中选择需要配置证书的域名，然后在 HTTPS 设置中更新证书。若仍提示错误，请改用自定义证书名称并重试，同时确保证书名称不含中文。
开启 HTTPS 后 HTTP 请求是否仍可正常访问？
可以。为域名配置 SSL 证书并开启 HTTPS 安全加速后，HTTP 请求和 HTTPS 请求均可正常访问，实现双协议访问。原视频资源路径无需修改，也不会出现访问中断。
在视频点播中绑定了域名，但是转码回调的地址中却没有HTTPS？
视频点播的回调返回目前不支持HTTPS，若已经在视频点播中正确配置了HTTPS证书，可以在收到回调消息后，把资源的HTTP地址替换成HTTPS地址。
截图和封面的回调会携带HTTPS地址，转码回调会返回HTTP地址。
配置加速域名后如何对文件进行同名更新
可以从控制台或是OpenAPI提交刷新请求，如何刷新，请参见刷新预热。同一个ID每天最多提交2000个刷新请求，每次最多只能提交1000条，支持目录刷新，刷新目录共100个。API相关接口请参见刷新预热API。
使用刷新预热功能后访问的资源并未更新
可通过以下几项措施排查处理：
尝试清理浏览器缓存，然后刷新页面，查看资源是否更新。
将站点域名直接绑定源站（通过修改本地host的方式），直接访问源站，检查源站的资源是否更新。如果资源没有更新，请更新源站的资源，再使用CDN加速。
登录视频点播控制台，检查刷新预热任务是否执行完毕，如果没有执行完毕，建议重新执行任务。
未开通加速域名时是否支持配置限流及防盗链？
不支持。视频点播的限流及访问控制（防盗链）功能均依赖加速域名。未添加加速域名时，相关安全策略无法配置，也不会生效。
如何屏蔽恶意IP访问
可通过配置IP黑名单，将恶意IP设置为需要屏蔽和拒绝访问的IP地址。详情请参见配置IP黑白名单。
配置IP黑名单后被添加的IP仍可请求访问
请检查点播控制台中配置的IP地址是否正确，如果需要精准限制客户端IP地址，则需要配置XFF IP地址到黑白名单地址。XFF IP获取方式请参见获取客户端真实IP。
CDN作为服务端，无法控制客户端的访问，配置IP黑名单后，该IP地址请求发送到CDN，会返回错误码403，您可以查看日志。查看日志的方法，请参见日志下载。
返回错误码403时，会产生流量费用。403没有实际资源的流出流量，只有响应头流量，涉及的费用较低，具体请参见CDN节点在响应4xx状态码的情况下是否会产生费用？。
由于防盗链异常导致访问视频点播加速资源时返回403错误
问题现象
在进行防盗链设置后，访问视频点播加速资源，返回403错误。
可能原因
防盗链设置异常或为空。
解决方案
排查问题原因。
使用curl命令测试访问加速域名
curl -voa -e "http://demo.aliyundoc.com" http://example.aliyundoc.com系统显示类似如下，Request请求的HTTP头带有Referer为demo.aliyundoc.com的域名，出现403错误，同时出现具体错误信息为denied by Referer ACL，说明防盗链设置异常。
curl -voa -e "http://cjy.xxx.cn" http://ct.xxx.cn * Rebuilt URL to: http://ct.xxx.cn/ % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0* Trying 101.xxx.xxx.144... * TCP_NODELAY set * Connected to ct.xxx.cn (101.xxx.xxx.144) port 80 (#0) > GET / HTTP/1.1 > Host: ct.xxx.cn > User-Agent: curl/7.54.0 > Accept: */* > Referer: http://cjy.xxx.cn > < HTTP/1.1 403 Forbidden < Server: Tengine < Date: Sat, 08 Dec 2018 12:36:17 GMT < Content-Type: text/html < Content-Length: 254 < Connection: keep-alive < X-Tengine-Error: denied by Referer ACL < Via: cache15.cn157[,403003] < Timing-Allow-Origin: * < EagleId: 6525b7a315442725770753781e < { [254 bytes data] 100 254 100 254 0 0 2489 0 --:--:-- --:--:-- --:--:-- 2514 * Connection #0 to host ct.xxx.cn left intact使用curl命令测试访问CDN加速域名
curl -voa http://example.aliyundoc.com系统显示类似如下，Request请求的HTTP头没有Referer信息，出现403错误，同时出现具体错误信息为denied by Referer ACL，说明防盗链设置为空。
jianxxx jxxx ecao$ curl -voa http://ct.xxx.cn * Rebuilt URL to: http://ct.pier39.cn/ % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0* Trying 101.xxx.148... * TCP_NODELAY set * Connected to ct.xxx.cn (101.xxx.148) port 80 (#0) > GET / HTTP/1.1 > Host: ct.xxx.cn > User-Agent: curl/7.54.0 > Accept: */* > < HTTP/1.1 403 Forbidden < Server: Tengine < Date: Sat, 08 Dec 2018 12:48:50 GMT < Content-Type: text/html < Content-Length: 254 < Connection: keep-alive < X-Tengine-Error: denied by Referer ACL < Via: cache5.cn1576[,403003] < Timing-Allow-Origin: * < EagleId: 6525b799154427333013711586e < { [254 bytes data] 100 254 100 254 0 0 992 0 --:--:-- --:--:-- --:--:-- 996 * Connection #0 to host ct.xxx.cn left intact通过Chrome浏览器打开经域名加速的一个URL链接，打开开发者工具，显示类似如下，Request请求的HTTP头没有Referer信息，说明防盗链设置为空。
403 Forbidden You don't have permission to access the URL on this server. Powered by Tengine Response Headers: Server: Tengine Timing-Allow-Origin: * Via: cache18.cn1576[,403003] X-Tengine-Error: denied by Referer ACL Request Headers: Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8 Accept-Encoding: gzip, deflate Accept-Language: zh-CN,zh;q=0.9 Cache-Control: no-cache Connection: keep-alive Host: ct.pier39.cn Pragma: no-cache Upgrade-Insecure-Requests: 1 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.102 Safari/537.36
根据不同原因进行相应的处理。
防盗链设置异常的解决方法
判断Referer为demo.aliyundoc.com的域名与加速域名example.aliyundoc.com设置的防盗链是否匹配。
登录视频点播控制台，选择配置管理 > 分发加速配置 > 域名管理，单击目标域名后的配置，选择访问控制 > Referer防盗链 > 修改配置，Referer类型选择白名单，确认防盗链设置和请求Referer不匹配，则添加demo.aliyundoc.com域名即可。此处Referer防盗链配置为白名单类型，规则中填写
demo.aliyundoc.com，且未勾选允许通过浏览器地址栏直接访问资源URL和允许空Referer字段访问CDN资源。防盗链设置为空的解决方法
登录视频点播控制台，选择配置管理 > 分发加速配置 > 域名管理，单击目标域名后的配置，选择访问控制 > Referer防盗链 > 修改配置，勾选允许通过浏览器地址栏直接访问资源URL。
说明如将Referer防盗链设置为不允许为空Referer访问，将有被盗链的风险。
添加加速域名提示“域名已存在”怎么办？
该提示表示域名已在其他产品或账号中接入。处理方式：
改用其他二级域名（如
vod.example.com）接入点播。若域名被其他产品（如建站类产品）占用，先在原产品中解绑后再添加。
若域名在其他账号的 CDN 中，可提交工单协助将域名迁至当前账号后删除再重新添加。
另请注意：网站主域名与点播加速域名不可共用，否则会出现访问 403 等异常，建议使用独立子域名接入点播。
配置 HTTPS 时控制台不显示已购证书？
证书绑定的域名必须与点播加速域名完全一致，否则控制台证书列表中不会展示该证书。也可调用 SetVodDomainSSLCertificate 接口配置证书（该接口仅支持华东2（上海）地域，服务地址需选择上海）。证书续费后需重新部署新证书替换旧证书后生效。
Web 播放器 SDK 引入后触发反调试（debugger）无法使用开发者工具怎么办？
aliplayer-min.js 生产版本内置了反调试保护机制，在非授权环境或开启开发者工具时会自动插入 debugger 语句，防止未授权使用或代码篡改，该机制无法通过配置关闭。
若怀疑本地环境与官方版本存在差异，可访问官方播放器设置页面进行对比测试。
Web 播放器 SDK 字幕与歌词同步播放如何实现？
Web 播放器 SDK 中 VTT 字幕默认显示在播放器画面下方，样式与视频字幕一致。
SDK 原生不支持音乐播放器风格的逐行滚动或高亮居中歌词特效。如需实现 MP3 音频歌词同步，需将歌词转换为 VTT 格式作为外挂字幕使用，确保 VTT 时间戳与音频播放进度精确对应，并通过监听播放器时间更新事件自行解析 VTT 内容、开发自定义 UI 组件渲染歌词。
Web 播放器切后台恢复播放报错或长时间 Loading 怎么办？
浏览器后台资源回收会导致播放器失活，或 PlayAuth 凭证过期（有效期最长 3000 秒）也会导致该问题。
解决方案：监听 visibilitychange 事件，切入后台时调用 player.pause() 并将 currentTime 存入 sessionStorage；切回前台时重新获取 PlayAuth 并调用 replayByVid(vid, newPlayAuth) 重置播放；监听 ready 或 canplay 事件，在回调中读取 sessionStorage 时间并调用 player.seek() 恢复进度。
优化建议：配置 vodRetry 为 0、waitingTimeout 为 10 秒以缩短等待，或在凭证过期前 5 分钟主动刷新 Token。
ListPlayer 本地缓存 enableLocalCache 如何使用及清理？
生效条件：视频格式须为 MP4 且通过 URL 播放，若 URL 带鉴权参数，需在计算缓存 Key 时去掉鉴权参数。
断网播放：配置 enableLocalCache 为 YES 后支持断网连续播放且不消耗流量。
缓存清理：调用 [AliPlayerGlobalSettings clearCaches] 可清除所有视频缓存，适用于播放中、退出登录或手动清理场景。
原 setCacheConfig 方法已废弃，应改用 enableLocalCache API。
Web 播放器 SDK License 校验机制及特殊场景（VPN/iframe）如何处理？
校验机制：Web 播放器 SDK 的 License 校验依据是浏览器地址栏中的当前域名或 Referer，必须与申请 License 时绑定的域名一致。
VPN 代理场景：通过 VPN 访问会导致域名不一致报错，建议使用统一 302 跳转至授权域名页面，或在 VPN 页面中使用 iframe 嵌套播放页面（确保 iframe 内加载的是授权域名页面）。
iframe 嵌套限制：若父页面为非授权域名、子页面（iframe）为授权域名，License 校验可正常通过；但需注意微信内置浏览器对跨域 iframe 可能存在限制，且父子页面通信需配置 postMessage。
Web 播放器 PlayAuth 过期刷新后如何从指定位置继续播放？
当前限制：使用 replayByVidAndPlayAuth 方法刷新 PlayAuth 后会从头播放，暂不支持自动从指定位置续播。
推荐方案：在 pause 事件触发时主动记录当前播放时间（存入 localStorage 或内存变量），在捕获到 PlayAuth 过期错误码 4002 时，先刷新 PlayAuth，再手动 seek 到之前记录的时间点恢复播放。
兜底策略：在 error 事件中保存最后已知有效时间作为兜底，避免因缓冲误差导致定位不准。
Android WebView 中 Web 播放器只有声音没有画面怎么办？
排查步骤：
检查是否开启硬件加速，在
AndroidManifest.xml中设置android:hardwareAccelerated="true"，或代码中设置webView.setLayerType(View.LAYER_TYPE_SOFTWARE, null)尝试软渲染。检查视频编码格式兼容性，老旧 WebView 可能不支持高 Profile H.265/H.264，建议转码为兼容格式。
升级 Web 播放器 SDK 至最新版本（如
2.37.6+）修复已知兼容性问题。打印 WebView 版本确认内核是否过旧。
Web 播放器 autoplay 为 false 且无封面时黑屏或一直 Loading 怎么办？
未设置 poster 属性时，播放器缺少默认展示内容，因此会出现黑屏或一直 Loading 的现象。
解决方案：配置 poster 属性指定封面图片，或通过监听 ready 等事件管理播放器状态和自定义 UI 显示。
Chrome/Edge 无法播放但 360 浏览器可播放的原因及解决方法
360 浏览器内置更多解码器或采用兼容内核（如 IE 模式），而 Chrome/Edge 对视频格式、协议及安全策略要求更严格，因此会出现该差异。
解决方案：申请阿里云播放器 SDK 免费 License 并接入网站播放器代码以提升兼容性。
播放器拉取直播流 setDataSource 无反应且报 Connect didn't get any data from stream 怎么办？
需在播放器 prepared 回调中调用开始播放方法，确保准备就绪后再启动拉流播放，否则会出现 setDataSource 无反应且报 Connect didn't get any data from stream 的情况。
如何关闭或隐藏 Web 播放器自动弹出的诊断工具界面？
诊断工具不会常驻运行，关闭标签页或返回播放页即可退出。
若需在运营时隐藏以避免信息暴露，需通过 Web 播放器 H5 自定义错误 UI 功能重写代码定义样式（如仅保留刷新按钮）。
iOS 端特定浏览器（如 UC）无法播放视频怎么办？
排查建议：
切换网络环境排除网络问题。
在网页端添加
vconsole工具查看具体错误日志定位原因。推荐使用阿里云 Web 播放器以获得更好兼容性支持。
配置 hlsOption.abrEwmaDefaultEstimate 后是否还需额外脚本？
abrEwmaDefaultEstimate 是播放器对当前网络环境的初始估算值，用于与 m3u8 中 BANDWIDTH 比较选择码率。播放过程中，播放器会根据实际下载速度更新带宽估算值并替换初始设置，无需额外脚本。
VOD 播放器 SDK 升级后 iOS 端部分视频仍无法播放或显示 Loading 怎么办？
建议将播放器 SDK 升级至最新版本以解决原生 HLS 兼容性问题；若升级后仍存在，需排查后端配置及域名证书配置情况。