华为云用户手册

背景说明 账户欠费进入保留期后，华为云CDN会下线您的加速 域名 。 表1 下线策略说明 策略 说明 解析回源 域名被下线时，您的域名会解析回主源站，最终域名状态调整为“停用”，停止 CDN加速 服务。解析回源后域名配置信息仍会保留（仅限保留期内），待您的域名恢复正常后，CDN会重新将域名解析回CDN节点并提供加速服务。 说明： 加速域名被执行下线策略30天后，华为云CDN将不再提供“解析回源”服务，您的加速域名将无法被访问。 解析回源将把您的源站域名或IP暴露给用户，如果您不希望暴露源站域名或者IP，请选择“停用域名”。 解析回源后业务是否能正常提供服务，依赖于您的源站。 停用域名 域名被下线时，CDN会将您的域名状态调整为“停用”，停止CDN加速服务。域名停用后将无法正常访问，但域名配置信息仍会保留（仅限保留期内），待您的账号核销欠款后，CDN会为您重新启用加速域名。 域名下线后，CDN会给您预留的电话或者邮箱发送短信或者邮件提示，您可以及时充值，恢复CDN加速服务。 超过保留期还没有缴清欠费，CDN的域名和配置将会被删除，保留期时长详见保留期。 域名备案过期、违规、遭受攻击被封禁后将停用域名，不会触发域名下线策略。

背景信息 如果您的源站地址因业务需求做了301/302 重定向，CDN的回源请求会返回301/302状态码，当您开启回源跟随后，CDN节点会先跳转到301/302对应地址获取资源，缓存后再返回给用户。开启或未开启回源跟随CDN的处理如下： 未开启：CDN会将301/302对应跳转地址直接返回给用户，让用户自己去请求跳转地址的资源。如果该跳转地址域名未加入CDN，则该请求过程不会有加速效果。 已开启：CDN会先跳转到301/302对应地址获取用户所需资源后缓存至节点并返回给用户，当其他用户再次请求同样资源时会直接命中节点缓存。

配置示例 域名www.example.com开启回源跟随，配置如下： 用户请求www.example.com/cdn.jpg文件，未命中缓存，节点回源请求资源。如果源站返回HTTP Response状态码301/302，重定向跳转地址为www.example.com/test/cdn.jpg。 节点收到301/302状态码后，直接向需要跳转的地址发起请求。 节点获取到资源后，返回给用户，并缓存到节点。 如果用户B再请求www.example.com/cdn.jpg文件，直接命中缓存，节点将资源返回给用户。 域名www.example.com未开启回源跟随，配置如下： 用户请求www.example.com/cdn.jpg文件，未命中缓存，节点回源请求资源。如果源站返回HTTP Response状态码301/302，重定向跳转地址为www.example.com/test/cdn.jpg。 节点直接将HTTP Response状态码301/302返回给用户，由客户端向重定向跳转地址发起请求。 如果重定向跳转地址的域名未接入CDN，则节点不能缓存该资源，不会有加速效果。 如果用户B请求www.example.com/cdn.jpg文件，重复以上流程。

背景信息 Range信息的作用是在HTTP请求头中指定返回数据的范围，即第一个字节的位置和最后一个字节的位置。如：Range: bytes=0-100就是请求该文件的前101个字节的数据内容。 开启Range回源后，当客户端请求某资源，如果CDN节点上未缓存该资源或资源已过期，节点回源时会采用Range请求，从源站分段获取用户需要的部分资源并缓存到CDN节点上。 Range回源能有效缩短大文件的分发时间，提升回源效率，减少回源消耗。

审计服务支持的CDN操作列表 表1 云审计 服务支持的CDN操作列表 操作名称 说明 createDomain 创建加速域名 updateDomain 更新加速域名 Range回源 回源跟随 IP黑白名单 设置回源Host 设置源站 OBS私有桶回源 配置HTTPS证书 创建缓存规则 HTTP header配置 域名批量配置 批量HTTPS配置 创建资源标签 删除资源标签 deleteDomain 删除加速域名 enableDomain 启用加速域名 disableDomain 停用加速域名 updateOrigin 设置源站 updateOriginHost 设置回源Host createRefer 创建Referer规则 createCertificate 设置加速域名证书 createCacheRule 创建缓存规则 createRefreshTask 创建刷新缓存任务 createPreheatingTask 创建预热任务

注意事项 部分头部不支持自助设置/删除，具体清单请参见限制条件。 HTTP响应头配置规则最多可配置10条。 由于HTTP header配置是针对域名，因此一旦配置生效，用户对该域名下任意一个资源的响应消息中均会加入所配置的消息头。HTTP响应消息头配置仅会影响客户端（浏览器）的响应行为，不影响CDN节点的缓存行为。 如果您的域名源站是OBS桶域名且CDN配置了跨域规则，OBS侧也需要同时配置跨域资源共享。

支持配置的响应头 华为云CDN支持以下几种HTTP响应消息头进行自定义取值。 Content-Disposition Content-disposition消息头用来激活客户端下载并指定所下载文件的名称。 服务端向客户端浏览器发送的文件，如果是浏览器支持的文件类型（如txt、jpg等），则默认使用浏览器打开。如果该文件需要用户以附件形式下载并保存为指定名称的文件，则可通过配置Content-disposition消息头实现。 如果您使用了2022年1月1日以后创建的OBS桶作为源站，并且需要支持在线预览功能，您要设置“Content-Disposition”的值为“inline”，详见如何在浏览器中在线预览OBS中的对象？。 Content-Language Content-Language消息头用来指明向客户页面端提供的用户偏好语言或语言组合，可以为不同身份用户定制不同的内容。 Access-Control-Allow-Origin Access-Control-Allow-Origin响应头携带了服务端验证后允许的跨域请求域名。对于简单跨域请求而言，浏览器经此消息头可以确认是否返回所请求的资源内容给客户端。对于预检请求而言，浏览器经此消息头可以确认是否可以向服务端发起真正的跨域请求。 为防止因浏览器缓存导致报跨域错误，跨域请求头“Access-Control-Allow-Origin”配置完成后，请您及时清理浏览器缓存。 Access-Control-Allow-Methods Access-Control-Allow-Methods响应头携带了服务端验证后允许的跨域请求方法。对于简单跨域请求而言，浏览器经此消息头可以确认是否返回所请求的资源内容给客户端。对于预检请求而言，浏览器经此消息头可以确认是否可以向服务端发起真正的跨域请求。 Access-Control-Max-Age Access-Control-Max-Age响应头携带了服务端允许的跨域预检请求结果允许缓存的时间。浏览器经此消息头可以确认预检请求结果的缓存时间，在缓存有效期内，浏览器可以使用缓存的预检请求结果判断是否向服务端发起跨域请求。缓存的预检请求结果过期后，下次请求时浏览器需再次向服务端发送预检请求。 Access-Control-Expose-Headers Access-Control-Expose-Headers用于指定浏览器可以暴露给客户端的响应消息头。您可以通过配置Access-Control-Expose-Headers自定义客户端可见的响应消息头。浏览器默认客户端可见的响应头有：Cache-Control、Content-Language、Content-Type、Expires、Last-Modified、Pragma。 自定义响应头 如果上述响应头不能满足您的业务需求，CDN支持自定义响应头配置，支持以字母开头，字母、数字和短横杠（-）组合，长度1~100以内的自定义响应头名称。

限制条件 如果您的后台存在特殊配置，暂不支持配置Content-Type、Expires、Cache-Control、Vary。 以下响应头仅支持修改响应头，不支持将“响应头操作”类型设置为“删除”： Content-Base Content-Type Server Content-Language Cache-Control Expires CDN暂不支持以下响应头配置： A_Dynamic If-None-Match Sec-WebSocket-Origin X-Forward-Peer Accept-Ranges If-Range Sec-WebSocket-Protocol X-Forward-Type X-Forward-Ip Keep-Alive Sec-WebSocket-Version X-Forward-Uri Allow Key Set-Cookie X-Forwarded-For Authentication-Info Last-Modified Tcp-Retrans X-IP-Region Authorization Link Title X-IP-Region-CN X-Forward-Measured Location Transfer-Encoding X-Ip-Blackwhite-List Cdn-Qos Max-Forwards Upgrade X-Local-Ip Cdn-Server-Ip Meter Sec-WebSocket-Location X-Log-Url Cdn-Src-Ip Mime-Version Via X-MAA-Alias Conf-Err-Host Negotiate WWW-Authenticate X-MAA-Auth Conf-File Origin Warning X-Max-Conns Conf-File-List Partition-Block-Size Ws-Hdr X-Mem-Url Conf-Option Pragma WsTag X-Mgr-Traffic Conf-Other Proxy-Authenticate X-Accelerator-Vary X-Miss-Rate-Limit Connection Proxy-Authentication-Info X-Appa X-Miss-Times-Limit Content-Encoding Proxy-Authorization X-Appa-Origin X-No-Referer Content-Length Proxy-Connection X-Black-List X-Query-Key Content-Location Proxy-Support X-Bwctrl-Limit X-Rate-Limit Content-MD5 Public X-Bwctrl-Para X-Refresh-Pattern Content-Range Purge-Domain X-Cache X-Request-Id Sec-WebSocket-Nonce Purge-Extra X-Cache-2 X-Request-Uri Date Range X-Cache-Lookup X-Request-Url Dynamic Request-Range X-Cacheable X-Resp-Time ETag Retry-After X-Cdn-Src-Port X-Rewrite-Url Error Sec-WebSocket-Accept X-Client-Ip X-Squid-Error Expect Sec-WebSocket-Draft X-DNS-Time X-Times-Limit If-Modified-Since Sec-WebSocket-Extensions X-Denyattack-Dynconf X-Url-Blackwhite-List From Sec-WebSocket-Key X-Error-Status X-Via-CDN Front-End-Https Sec-WebSocket-Key1 X-Error-URL X-White-List Host Sec-WebSocket-Key2 X-Forward-Host If-Match

停用加速域名 对处于“已开启”或“配置失败”状态的域名，您可以对其进行“停用”操作。停用后，CDN将不再为域名提供加速服务，但域名的配置不会改变，如果想恢复CDN加速服务请重新启用CDN。 单域名停用 进入CDN控制台的“域名管理”页面，在需要停用的加速域名对应的“操作”列单击“更多”，选择“停用”。 图2 停用域名 确认需要停用的域名信息，单击“确定”完成域名停用操作。 批量停用域名 进入CDN控制台的“域名管理”页面，勾选需要停用的加速域名，单击域名列表上方“停用”。 图3 批量停用域名

协议优势 目前，互联网使用的HTTP协议版本是HTTP1.1，HTTP/2在HTTP1.1的基础上对性能进行了很大的优化，并且兼容了HTTP1.1的语义。 HTTP/2和HTTP1.1比较主要有如下几大优势： 二进制分帧 HTTP/2采用二进制格式传输数据，而HTTP1.1采用文本格式传输数据。二进制格式传输在协议的解析和优化扩展上更具优势，提升了数据传输效率。 头部压缩 HTTP/2对消息头采用HPACK格式进行压缩传输，并在客户端和服务端通过“头部表”来跟踪和存储消息头，相同的消息头只需通过索引从“头部表”中获取并使用之前已经请求发送过的消息头。 HTTP/2通过头部压缩， 解决了HTTP1.1每次请求都会携带大量的头部冗余信息而浪费带宽资源的问题，节省了消息头占用的网络和流量。 多路复用 在HTTP/2中，多个请求或者响应可以通过一个TCP连接并发完成，而HTTP1.1中每个请求或者响应都需要按照先后顺序建立一个TCP链接。HTTP/2通过有效地并发请求，减少了服务器链接压力，缓解了网络阻塞状况。

注意事项 运营报表中最多可支持添加100个加速域名。 定制的运营报表有效期最长为1年。 可查询的时间跨度最长为31天，支持查看最近90天的历史数据。 最小统计粒度以天为单位。 统计时延和算法误差可能导致统计数据与日志中的数据有差异，请以日志数据为准。 您需要定制运营报表后才能查看对应的数据，受日志完整性时延的影响，当天定制的报表会在次日生成。例如2023.08.02日定制的报表，会在2023.08.03日生成。

HTTPS配置 配置此项内容时需要加速域名处于“已开启”或“配置中”状态，并且未被CDN锁定、禁用。 功能 说明 配置HTTPS证书 添加证书，实现HTTPS安全加速。 HTTPS证书要求 介绍了不同的机构颁发证书的拼接、上传顺序。 HTTPS证书格式转换 CDN仅支持PEM格式的证书，其它格式需要转换为PEM格式才可以使用。 配置TLS版本 您可以根据业务需求开启或关闭相应的TLS版本。 强制跳转 如果您需要将客户端到CDN节点的请求强制跳转为HTTP/HTTPS，您需要配置强制跳转。 配置HSTS 配置HSTS后，将强制客户端（如浏览器）使用 HTTPS 协议访问服务器，提升访问安全性。 配置HTTP/2 介绍了HTTP/2的背景信息和优势，有助于您决定是否开启此项配置。 配置O CS P Stapling 开启此项配置后，CDN将预先缓存在线证书的结果并返回给客户端，浏览器无需再次查询，从而减少用户验证时间。 配置QUIC协议 配置QUIC协议，提高了传输的安全性，减少传输和连接时的延时，避免网络拥塞。

缓存配置 配置此项内容时需要加速域名处于“已开启”或“配置中”状态，并且未被CDN锁定、禁用。 配置项 场景说明 配置节点缓存规则 如果您想合理的配置不同资源的缓存过期时间和优先级，有效的提升缓存命中率，降低回源率，您需要设置缓存规则。 如果您需要CDN节点在缓存资源时忽略“?”之后参数，提高缓存命中率，提升分发效率，您需要配置对应资源的忽略URL参数。 如果您的源站配置了缓存过期时间，同时想要CDN侧的缓存过期时间跟源站一致，您需要开启对应资源的缓存遵循源站功能。 配置浏览器缓存过期时间 您可以配置浏览器缓存过期时间，当终端用户请求资源时，如果浏览器有缓存，直接返回给用户，降低回源率。 配置状态码缓存时间 如果您需要将源站返回的错误状态码缓存到CDN节点，用户再次请求时由CDN直接响应给用户错误码，您可以配置状态码缓存时间，减小回源概率，减轻源站压力。 配置访问URL重写 当用户请求URL与CDN节点缓存资源的URL不一致时，可以通过访问URL重写功能重定向到目标URL。 配置域名共享缓存组 如果不同域名对应相同的资源，您可以配置共享缓存组，将一个域名设置为主域名，组内其他域名共享该域名的缓存，以提高缓存命中率。

访问控制 配置此项内容时需要加速域名处于“已开启”或“配置中”状态，并且未被CDN锁定、禁用。 配置项 场景说明 配置防盗链 当您的网站需要对访问者身份进行识别和过滤，从而限制访问来源时，可以在此项中进行配置。 配置IP黑白名单 当您的网站需要对用户请求IP地址进行过滤，从而限制访问来源时，可以在此项中进行配置。 配置User-Agent黑白名单 当您的网站需要对用户请求使用的代理过滤，从而限制访问来源时，可以在此项中进行配置。 URL鉴权配置 当您需要保护用户站点资源，防止资源被用户恶意下载盗用时，可以在此项中进行配置。 配置远程鉴权 当您想要CDN将用户请求转发到指定的鉴权服务器来完成鉴权，从而防止资源被用户恶意下载盗用时，可以在此项中进行配置。 配置IP访问限频 如果您想要通过限制单IP的单URL每秒访问单个节点的次数，实现CC攻击防御及防恶意盗刷防护，可以通过配置IP访问限频实现。

高级配置 配置此项内容时需要加速域名处于“已开启”或“配置中”状态，并且未被CDN锁定、禁用。 配置项 场景说明 HTTP header配置（跨域请求） 当您的网站需要自定义HTTP响应头取值时，可以在此项中进行配置。 配置自定义错误页面 当您需要给客户端返回自定义的错误页面时，您需要配置此项。 配置智能压缩 如果您想要压缩您网站的静态资源，缩小传输文件的大小，提升传输效率，减少带宽消耗，您需要开启智能压缩。 配置WebSocket协议 如果您开通了全站加速，有弹幕聊天、协同会话、行情播报、体育实况更新、在线教育和物联网等场景，需要实现长时间双向传输数据，可以通过配置WebSocket协议来实现。 配置请求限速 配置请求限速，将用户请求速度限制在指定范围内，一定程度上减少突发高带宽风险，节省成本。 配置用量封顶 如果您想给域名配置流量或带宽上限，当用量达到阈值时暂停CDN加速，以减少因流量盗刷或攻击带来的高额账单，可以配置用量封顶功能。

基本配置 配置此项内容时需要加速域名处于“已开启”或“配置中”状态，并且未被CDN锁定、禁用。 配置项 场景说明 修改域名源站配置 当您的源站IP、域名发生变化，源站信息配置错误，或需要添加备源站时，可以在此项配置中配置相关源站信息。 回源HOST 如果CDN回源时访问的站点域名不是您的加速域名（CDN默认回源HOST为加速域名），您需要设置回源HOST。 修改业务类型 如果您的业务有变，当前CDN加速域名的业务类型已经无法匹配您的需求时，您可以修改业务类型。 修改服务范围 如果您的用户所在地域发生改变，您可以修改加速域名的服务范围，更好的匹配当前业务。 配置客户端用IPv6协议访问CDN节点 如果您需要以IPv6协议访问CDN，您需要开启此项配置。

回源配置 配置此项内容时需要加速域名处于“已开启”或“配置中”状态，并且未被CDN锁定、禁用。 配置项 场景说明 修改回源协议 如果您需要指定CDN回源时的请求协议，您需要配置回源方式。 配置回源SNI 如果源站IP绑定了 多个域名 ，当CDN节点以HTTPS协议访问源站时，您可以设置回源SNI，指定CDN节点需要访问的域名。 回源URL改写 如果您的回源请求URL与源站URL不匹配，您可以改写回源URL，提高回源请求URL与源站的匹配度，提升回源命中率。 配置高级回源 如果您需要根据不同的资源类型或路径回源到不同源站，可以通过高级回源配置实现。 配置Range回源 当您需要设置Range回源以提升大文件的分发效率时，可以在此项配置中开启Range回源功能开关。 回源跟随 如果您的源站地址因业务需求做了302 /301重定向，您不希望CDN直接返回302 /301跳转地址给用户，而是向重定向地址发起请求，将用户所需资源缓存至节点并返回给用户时，可以在此项配置中开启回源跟随功能开关。 回源是否校验ETag 如果您的源站资源未改变，该资源缓存到期后不希望CDN回源获取资源，以达到节约源站带宽的目的，您需要配置回源是否校验ETag。 配置回源请求头 如果您想要改写用户回源请求URL的头部信息，需要设置回源请求头。 修改回源超时时间 如果您需要根据源站特性和业务场景调整回源超时时间，您需要配置此项。

复制配置 配置此项内容时需要被复制配置加速域名处于已开启、已停用或审核未通过状态。 配置项 场景说明 复制配置到存量域名 如果您想要复制某个加速域名的配置到其它加速域名，可以使用CDN的复制到存量域名功能，以达到快速、批量修改域名配置的目的。 复制配置到新添加域名 该功能将已有域名的配置复制给一个或多个新添加的域名，如此，就不需要为新添加的域名单独设置各个配置项，可以更快速的完成域名添加和个性化配置。

排查步骤 检查域名是否接入CDN加速 如果您刚在控制台添加加速域名，正在做配置CNAME前的本地测试加速域名工作，请忽略本步骤，参照快速入门流程配置即可。 您需要检查域名是否解析到CDN，以Windows操作系统为例，打开cmd程序，输入如下指令： nslookup -qt=cname 加速域名 如果返回结果显示CNAME，则表示CNAME配置已经生效，如下图： 如果查询出的域名解析中没有上图红框中所示，后缀为.c.cdnhwc1.com的CNAME解析记录，则说明您添加的域名的CDN加速未生效。此种情况下CDN加速未生效的可能原因是您没有在域名DNS服务商处配置CNAME记录，请根据配置CNAME内容指导前往您的域名DNS服务商处配置CNAME记录。 如果您确认已正确配置CNAME记录，请检查同一解析线路下该域名的上一记录类型的TTL时间，TTL时间决定了解析记录在本地DNS服务器的缓存时间。您新添加的CNAME记录在上一记录类型的本地TTL缓存时间过期后才会正式生效。 查看是否命中CDN缓存 在浏览器Chrome上，按F12，选择“Network”。查看指定URL的响应头，查看头部信息，进行如下判断： 如果有“x-hcs-proxy-type”头部，值为“1”即命中缓存，值为“0”即未命中缓存，不再查看其它头部； 如果无“x-hcs-proxy-type”头部，而有“X-Cache-Lookup”头部，值为“Hit From MemCache”、“Hit From Disktank”或“Hit From Upstream”即为命中缓存，其它值表示未命中缓存，不再查看其它头部； 如果同时无“x-hcs-proxy-type”、“X-Cache-Lookup”头部，有“age”头部，则值大于“0”即命中缓存，值为“0”即未命中缓存。 如果未命中缓存，请跳到4. 检查缓存规则设置查看缓存规则设置。 如果命中缓存，请进入下一步分析。 是否跨运营商和跨省 如果用户访问跨省和跨运营商，可能会影响访问速度，请按照以下步骤排查： 在客户端打开华为云CDN用户诊断系统，输入您的加速域名，单击“检测”，获得客户端IP、LDNS。 根据客户端IP和LDNS分析是否跨运营商和跨省。如果使用了代理，可能会出现跨运营商和跨省，影响访问效果。 示例1：用户在河北使用广电网络访问，但IP是北京联通，LDNS又是石家庄电信，访问速度就会较慢，跨运营商对网速的影响很大。 示例2：用户在北京使用广电网络访问，但IP是北京联通，LDNS又是广东电信，用户访问加速域名时CDN调度系统会根据LDNS匹配最近的广东节点，导致访问速度较慢。 华为云CDN目前支持的运营商有电信、联通、移动、铁通、教育网、鹏博士等。 检查缓存规则设置 检查所访问的资源对应的缓存规则，是否存在配置的缓存过期时间为0或者缓存过期时间过短的情况。CDN不缓存或者缓存过期时间过短会导致请求回源，无法达到加速效果。 检查您的源站缓存设置，如果源站设置了no-cache、private、no-store，CDN侧同时开启了“缓存遵循源站”功能（此功能默认关闭），CDN将无法缓存源站资源，导致所有请求回源，无法达到加速效果。 检查您设置缓存规则的优先级，数值越大优先级越大，系统会优先匹配。 如果您的URL携带了参数，并且参数不断变化，当使用不同的URL去访问的时候，CDN会认为这是一个新请求（即使这两个不同的URL访问的是同一个文件，并且该文件已经缓存在节点上），依然会回源请求该资源。如果携带不同的参数的URL访问的是同一个资源，建议开启忽略URL参数功能，请参见URL参数。 更多缓存设置请参考如何设置缓存过期时间。 检查资源是否预热 如果您是首次访问某资源，且之前未对该资源做过预热处理，CDN节点会回源请求资源，首次访问速度慢属于正常。 首次接入CDN后，建议您预热大文件或者视频，图片、小文件等不建议预热。 检查客户端网络 ping CDN加速后访问依然较慢的域名，检查网络时延和丢包。如果网络时延大或者丢包严重，需要检查客户端网络接入问题。 检查是否存在跨境访问 仅开通了中国大陆境内加速：如果域名的服务范围为中国大陆，此时所有客户端请求均会调度到中国大陆的节点，此时中国大陆境外用户访问域名时，受跨境网络影响，加速效果不太明显，甚至无法访问。 源站位置和服务范围不一致： 如果域名的源站地址在中国大陆境外，服务范围为中国大陆，此时客户端请求回源时受跨境网络影响，加速效果不太明显，甚至无法访问。 如果域名的源站地址在中国大陆境外，服务范围为全球，那么中国大陆用户访问该域名下的资源时，将调度到中国大陆的节点，如果节点未缓存该资源，此时客户端请求回源时受跨境网络影响，加速效果不太明显，甚至无法访问。 如果排除以上几点后问题仍然存在，请联系客服或提交工单处理。

缓存预热失败怎么办？ 您可以前往刷新预热历史记录查看失败原因，缓存预热失败的可能原因是： 执行大批量文件的集中预热时，可能会导致您的源站带宽资源被占满。预热时请尽量分批次执行，您也可以通过扩充源站带宽来提升预热效率。 检查资源对应的缓存过期时间是否为0，如果为0，不允许缓存会导致预热失败； 排查源站的cache-control配置，源站配置private、no-cache、no-store而CDN侧同时开启了“缓存遵循源站”功能，将导致CDN不能缓存引起预热失败。 目前不支持预热目录、动态文件。 请检查您的源站资源是否能正常访问（例如网络问题或源站有防火墙、黑/白名单等安全限制），如不能正常访问也将造成预热失败。 父主题： 刷新预热

制作声音模型 准备好音频文件后，就可以上传至MetaStudio控制台，进行声音训练。详细操作如下所示： 创建声音制作任务（华为模型） 查看声音 声音模型制作耗时，如下所示： 基础版：约1~3个工作日。 进阶版：约1~3个工作日。 高品质：约5个工作日。 自定义声音应用方式，如下所示： 自定义声音生成后，会自动展示在MetaStudio控制台声音列表中，可用于分身数字人视频制作、 视频直播 或智能交互等场景中。 通过MetaStudio的API调用自定义声音。

开始录音 必须录制单人高质量、无噪音或背景音的人声语音，生成音频。支持使用苹果或者安卓手机录制视频，操作请参考手机录制音频。 具体的录音注意事项，如表2所示。 表2 录音注意事项 录音事项 说明 话筒间距 调整与麦克风之间的距离，以一拳距离为宜。不宜离麦太近，防止喷麦或录入呼吸声。 录音内容 每句文案起始数字编号无需阅读。 示例：4. 它不仅拥有出色的功能，还具备卓越的性能，序号4无需阅读。 音频格式 推荐使用无损音质格式保存音频文件，如WAV格式。 原始录音数据，需未经MP3等编码器编码，且为48kHz采样率、16bit编码和单声道。 录制风格 录制全程保持语境风格一致，避免多种情绪混杂。如直播场景时，录制风格需接近日常直播效果。 发音吐字 发音吐字清晰、准确，音量适中。如果出现喷麦或嘶嘶声音，建议当前句子重新录制。 语速节奏 语速自然、平稳，切忌过快过慢、忽快忽慢。 音量适中 音量不能过小、过大、或忽大忽小，甚至削波爆音。峰值 RMS 在-9左右，无削波。 停顿断句 在标点或适当断句处自然停顿，需轻声换气。 当录制一个长音频文件时，每句之间需要有2~3秒的停顿。 重音位置 重音位置要合理，避免错误的重音。 阅读发音 按顺序读，确保音字一致。避免漏字多字、发音错误、阅读不流畅等问题。如有这些问题，需重新录制。

录音准备 表1 录音准备 声音类型 录制设备和软件 录音环境 录音文案 基础版 优先使用专业录音设备录制音频，推荐使用Adobe Audition软件进行录音。 如果不具备专业录音设备，可使用手机录制音频，详情请参见手机录制音频。 录音环境安静，无回音、混响、噪声，避免出现汽车鸣笛、他人说话、走动等杂声。 可使用“分贝仪”应用来测试录音环境的底噪，建议底噪低于0dB。 同一批录音必须使用同一套录制设备和环境。 建议使用对应版本预置的文案样例：文案样例（基础版）、文案样例（进阶版）、文案样例（高品质）。 支持自定义文案，单句文案长短需和样例相当。 不建议临场即兴发挥录制，避免出现较多嗯、啊等语气词，影响连贯性。 进阶版 高品质 专业录音棚+高保真MIC录制。

获取第三方声音使用凭证 下面以 语音合成 套餐为例，进行操作说明。其他声音套餐的操作均相同。 查看用户已购语音合成套餐，获取“用户账号”和“登录密码”，作为在MetaStudio控制台激活第三方声音的使用凭证。 访问云商店买家中心，进入“已购买服务”界面。 可以看到已购买的语音合成套餐信息。 图5 已购买的服务 单击已购买套餐右侧的“资源详情”，进入资源详情界面。 需要记录“用户账号”和“登录密码”，如图6所示。 用途如激活第三方声音使用凭证所示，分别作为accessKey和secretKey，在MetaStudio新增或更新凭证，用于激活第三方声音。 图6 资源详情

续购套餐 下面以语音合成套餐为例，进行操作说明。其他声音套餐的操作均相同。 已购语音合成套餐用尽后，须知： 如果使用相同的华为云账号再次购买套餐，则accessKey和secretKey不变。 如果使用其他华为云账号再次购买套餐，则需更新accessKey和secretKey后使用，操作请参考续购套餐。 访问我的声音凭证页面，可以看到已激活的accessKey和secretKey信息。 图12 声音凭证 单击右侧的“编辑”，在弹出“修改序列号”对话框中，输入使用其他华为云账号购买的语音合成套餐用户凭证，如图13所示。 用户凭证的查询方式，如获取第三方声音使用凭证所示。 图13 更新凭证 单击“确认修改”，界面提示“修改成功”。 修改成功后，自动生效，无需重新激活第三方声音。

购买出门问问语音合成套餐包 在云商店购买语音合成套餐包，用于激活和使用出门问问提供的第三方声音。 访问云商店语音合成商品页面，进入云商店商品“语音合成”的购买页面。 用户可以在界面下方查看商品详情，确定要购买的商品规格。 支持购买下述套餐： 语音合成体验套餐 语音合成小型套餐 语音合成中型套餐 语音合成大型套餐 上述套餐购买完成后，所有预置的第三方声音均可使用。每个第三方声音的费用均不同，详见语音合成界面下方的声音价格表。如魔郎朗声音的价格为30元/百万字符，那么使用魔郎朗声音进行视频制作合成时，生成音频的费用会从上面购买的套餐包中扣除。 图1 云商店 选择“语音合成体验套餐”，单击“立即购买”，进入购买页面。 下面以购买“语音合成体验套餐”为例，进行操作说明。 图2 订单确认页面 阅读并勾选所有协议和相关授权，单击“去支付”，进入订单支付页面。 图3 订单支付页面 按照界面提示，选择您的付款方式，完成支付即可。 订单支付成功后，进入如图4所示的界面。 图4 订单支付成功

购买语音合成操作流程 如需使用系统预置的第三方声音，需要购买出门问问语音合成套餐包，详细的操作流程如下所示。第三方声音支持的语言类型，如第三方声音支持的语言类型所示。 购买出门问问语音合成套餐包：在云商店购买语音合成套餐包，用于激活和使用出门问问提供的第三方声音。 获取第三方声音使用凭证：查看已购套餐包的“用户账号”和“登录密码”，作为MetaStudio控制台第三方声音使用凭证。 激活第三方声音使用凭证：在MetaStudio控制台新增凭证，输入已购套餐包的“用户账号”和“登录密码”作为使用凭证。 在MetaStudio控制台查看消费明细：支持在MetaStudio控制台查看已购套餐包的消费明细。 续购套餐：如果已购套餐包的用量已耗尽或者套餐包到期，可再次购买套餐包使用。

动态数据脱敏函数 creditcardmasking(col text, letter char default 'x') 描述：将col字符串后四位之前的数字使用letter替换。 参数：待替换的字符串、替换字符。 返回值类型：text basicemailmasking(col text, letter char default 'x') 描述：将col字符串中第一个'@'之前的字符使用letter替换。 参数：待替换的字符串、替换字符。 返回值类型：text fullemailmasking(col text, letter char default 'x') 描述：将col字符串中出现最后一个'.'之前的字符(除'@'外)使用letter替换。 参数：待替换的字符串、替换字符。 返回值类型：text alldigitsmasking(col text, letter char default '0') 描述：将col字符串中出现的数字使用letter替换。 参数：待替换的字符串、替换字符。 返回值类型：text shufflemasking(col text) 描述：将col字符串中的字符乱序排列。 参数：待替换的字符串、替换字符。 返回值类型：text randommasking(col text) 描述：将col字符串中的字符随机化。 参数：待替换的字符串、替换字符。 返回值类型：text regexpmasking(col text, reg text, replace_text text, pos INTEGER default 0, reg_len INTEGER default -1) 描述：将col字符串使用正则表达式替换。 参数：待替换的字符串、正则表达式、替换的起始位置、替换长度。 返回值类型：text 父主题： 函数和操作符

注意事项 TIMECAPSULE TABLE语句的用法主要分为两大类：闪回旧版本数据和从回收站中闪回。 TO TIMECAPSULE和TO CSN能够将表闪回到过去的某个版本，当前仅支持Ustore存储引擎。 回收站记录了DROP和TRUNCATE的对象数据。TO BEFORE DROP和TO BEFORE TRUNCATE就是从回收站中闪回，当前支持Ustore以及Astore存储引擎。 不支持闪回表的对象类型：系统表、DFS表、全局临时表、本地临时表、UN LOG GED表、序列表、hashbucket表、密态表。 不支持含有自定义类型表的闪回。 开启闪回后，回收站里的表可以进行表级备份，无法进行表级恢复。 闪回点和当前点之间，执行过修改表结构或影响物理存储的语句（DDL、DCL、VACUUM FULL），则闪回失败。 执行闪回删除需要用户具有如下权限：用户必须具有垃圾对象所在SCHEMA的CREATE和USAGE权限，并且用户必须是SCHEMA的所有者或者是垃圾对象的所有者。 执行闪回TRUNCATE需要用户具有如下权限：用户必须具有垃圾对象所在SCHEMA的CREATE和USAGE权限，并且用户必须是SCHEMA的所有者或者是垃圾对象的所有者，另外用户必须具有垃圾对象的TRUNCATE权限。 不适用闪回DROP/TRUNCATE功能的场景或表： 回收站关闭场景：enable_recyclebin = off。 系统处于维护态（xc_maintenance_mode = on）或从不支持的基线版本升级到支持的版本的升级场景。 多对象删除场景：DROP/TRUNCATE TABLE命令同时指定多个对象。 系统表、DFS表、全局临时表、本地临时表、UNLOGGED表、序列表、hashbucket表、密态表。 回收站对象被清理后无法闪回DROP/TRUNCATE，recyclebin_retention_time参数用于设置回收站对象保留时间。 回收站对象禁止DML、DCL、DDL等写操作，不支持DQL查询操作。 truncate表和闪回truncate操作之间，执行过修改表结构或影响物理文件的语句（DDL、DCL、VACUUM FULL、增加/删除/切割/合成等分区操作），闪回失败。 整表删除或截断时，分区会随着整表放入回收站，单个删除的分区不支持放入回收站，避免破坏数据一致性。 如果表依赖的对象为外部对象（如表列为复合类型、自定义类型等），则采用物理删除，不将表放入回收站。 DROP闪回约束 可以指定原始用户指定的表的名称，或对象删除时数据库分配的系统生成名称。 回收站中系统生成的对象名称是唯一的。因此，如果指定系统生成名称，那么数据库检索指定的对象。使用“select * from gs_recyclebin;”语句查看回收站中的内容。 如果指定了用户指定的名称，且如果回收站中包含多个该名称的对象，然后数据库检索回收站中最近移动的对象。如果想要检索更早版本的表，操作如下： 指定想要检索的表的系统生成名称。 执行TIMECAPSULE TABLE ... TO BEFORE DROP语句，直到检索出想要检索的表。 恢复DROP表时，只恢复基表名，其他子对象名均保持回收站对象名。用户可根据需要，执行DDL命令手工调整子对象名。 回收站对象不支持DML、DCL、DDL等写操作，不支持DQL查询操作（后续支持）。 recyclebin_retention_time配置参数用于设置回收站对象保留时间，超过该时间的回收站对象将被自动清理。 不支持DROP多表的恢复。 不支持级联删除账号/schema场景的恢复。 删除账号/schema时，若回收站中存在该schema/账号的对象，普通删除会失败，需要级联删除。 TRUNCATE闪回约束 TRUNCATE闪回后，统计信息无变化，仍显示为0，可以在业务低峰期（降低性能影响）时候手动ANALAZY来修正统计信息。 RENAME TO仅支持DROP闪回操作为检索表指定新名称，不支持TRUNCATE闪回。 TRUNCATE闪回不能跨越影响表结构或物理存储的语句，否则会报错。即闪回点和当前点之间，如果执行过修改表结构或影响物理存储的语句（DDL、DCL、VACUUM FULL、增加/删除/切割/合成等分区操作），则闪回失败。执行过DDL的表进行闪回操作报错：“ERROR：The table definition of %s has been changed. ”。涉及namespace、表名改变等操作的DDL执行闪回操作报错：“ERROR: recycle object %s desired does not exist.”。

参数说明 schema 指定模式包含的表。如果缺省，则为当前模式。 table_name 指定表名。 TO CSN 指定要返回表的时间点对应的事务提交序列号（CSN）。expr必须计算一个数字，代表有效的CSN。 TO TIMESTAMP 指定要返回表的时间点对应的时间戳。expr必须计算一个过去有效的时间戳（使用TO_TIMESTAMP函数将字符串转换为时间类型）。表将被闪回到指定时间戳大约3秒内的时间点。 说明：闪回点过旧时，因旧版本被回收导致无法获取旧版本，会导致闪回失败并报错：Restore point too old。 TO BEFORE DROP 使用这个子句检索回收站中已删除的表及其子对象。 RENAME TO 为从回收站中检索的表指定一个新名称。 TO BEFORE TRUNCATE 闪回到TRUNCATE之前。