配置手册产品文档

Size: px

Start display at page:

Download "配置手册产品文档"

奇衿冉
7 years ago
Views:

1 内容分发网络配置手册产品文档

2 版权声明腾讯云版权所有本文档著作权归腾讯云单独所有未经腾讯云事先书面许可任何主体不得以任何形式复制修改抄袭传播全部或部分本文档内容商标声明及其它腾讯云服务相关的商标均为腾讯云计算北京有限责任公司及其关联公司所有本文档涉及的第三方主体的商标依法由权利人所有服务声明本文档意在向客户介绍腾讯云全部或部分产品服务的当时的整体概况部分产品服务的内容可能有所调整您所购买的腾讯云产品服务的种类服务标准等应由您与腾讯云之间的商业合同约定除非双方另有约定否则腾讯云对本文档内容不做任何明示或模式的承诺或保证第2页

3 文档目录文档声明... 2 配置项概览... 4 基本配置... 5 缓存过期时间过滤参数设置 referer 防盗链回源HOST配置中间源设置 HTTPS配置 HTTP header 配置 SEO搜素优化 IP黑白名单设置 IP访问限频设置第3页

4 配置项概览对于已经接入CDN的域名您可以对其基本信息和配置信息进行修改基本配置配置名称功能描述业务类型修改域名对应的业务类型所属项目] 修改域名所属项目源站修改域名源站信息基本配置修改方式请查看基本配置高级配置配置名称功能描述缓存时间配置配置指定资源内容的缓存过期时间规则过滤参数设置指定节点是否忽略用户的访问URL中"?"之后的参数回源HOST 指定CDN回源到源站时的访问域名防盗链配置HTTP referer黑白名单中间源指定是否使用中间源 HTTPS设置配置HTTPS实现安全加速 SEO优化配置开启SEO优化配置保证搜索引擎权重稳定性 HTTP Header 添加HTTP header配置 IP黑白名单配置支持设置IP黑白名单进行访问控制 IP访问限频配置支持单IP单节点访问限频配置第4页

5 基本配置对于已经接入CDN的加速域名您可以对其基本配置如所属项目源站业务类型等进行修改域名配置项修改请参考配置概览基本配置查看登录CDN控制台进入域名管理页面点击需要修改基本信息的域名右侧管理按钮进入管理页面您可以在基本配置页面查看域名所属项目源站信息以及业务类型基本配置修改修改所属项目第5页

6 您可以调整域名所属项目方便您对域名进行管理项目创建及查看请前往项目管理点击所属项目右侧编辑链接可修改该域名所属项目注意使用CDN子用户权限体系点击查看的用户此操作可能导致权限变动请谨慎操作修改源站自有源源站修改您可以点击源站右侧修改链接对已经配置的自有源源站进行修改第6页

7 若您接入时选择的方式为自有源则源站需要满足以下条件若填入的为域名则必须不能与访问域名即接入的加速域名一样支持域名:port格式端口大于0小于等于65535 若填入的为源站IP 可填入多个IP 支持IP:port方式定义端口端口大于0小于等于65535 当填入多个IP的时候回源请求会依次轮流访问各IP 填入的IP不能是内网IP COS源源站修改您可以点击源站右侧修改链接切换源站为其他已经创建的COS bucket地址第7页

8 您可以切换源站为其他COS bucket 注意事项暂时不支持COS源与自有源之间相互切换修改业务类型点击业务类型右侧编辑链接对业务类型进行修改第8页

9 静态加速若您的源站业务为电商类网站类游戏图片类推荐您配置业务类型为静态加速为您提供静态加速服务流媒体加速若您的源站业务为直播互动直播类推荐您配置业务类型为流媒体加速为您提供流媒体加速服务下载加速若您的源站业务为音视频原文件下载手机固件分发等推荐您配置业务类型为下载加速为您提供下载加速服务第9页

10 缓存过期时间功能介绍缓存过期配置是指 CDN 加速节点在缓存您的业务内容时遵循的一套过期规则 CDN 节点上缓存的用户资源都拥有过期时间的概念若资源处于未过期状态当用户请求到达节点后节点会将此资源直接返回给用户提升获取速度当资源超过了设置的有效时间处于过期状态此时用户请求会由节点发送至源站重新获取内容并缓存至节点同时返回给用户合理的配置缓存时间能够有效的提升命中率降低回源率节省您的带宽腾讯云 CDN 支持各维度的缓存时间设置支持自定义优先级调整支持 cache 继承策略高级缓存配置配置说明您可在 CDN 接入时配置缓存时间详情查看域名接入自有源或域名接入 COS 源您也可以登录 CDN 控制台选择域名管理页面点击要修改缓存时间配置的域名右侧管理按钮在基本配置栏中可以找到缓存过期配置第10页

11 默认配置在域名接入时默认配置如下自有源域名接入所有文件默认30天缓存过期时间常规动态文件如.php.jsp.asp.aspx 默认缓存过期时间为0 对此类动态文件请求会直接回源 COS 源域名接入所有文件默认30天缓存过期时间默认关闭高级缓存过期设置您可以对上述默认配置进行修改自定义配置您可以根据自身业务需求在默认配置上添加缓存时间配置 CDN 支持三种方式的缓存过期时间设置按文件类型设置缓存过期时间您可以填充文件类型后缀根据类型来设置缓存时间如下所示.jpg.png 300秒第11页

12 设置完成后域名下所有匹配.jpg.png 的图片资源在节点的缓存有效时间均为5分钟按文件夹设置缓存过期时间您可以填充文件夹路径根据文件夹来设置缓存时间如下所示 /test;/test2 1000秒设置完成后假设域名为则两个路径下的所有资源在节点的缓存有效时间均为1000秒全路径文件设置缓存过期时间您可以为某一具体文件设置缓存时间如下所示 /test/1.jpg 2000秒设置完成后假设域名为则该资源缓存时间为2000秒您也可以为某一类具体文件设置缓存时间如下所示 /test/*.jpg 3000秒第12页

13 设置完成后假设域名为则路径下所有jpg格式的资源缓存时间均为3000秒配置须知配置缓存时间时可填入多个每项用隔开内容区分大小写文件类型必须以. 开头的文件后缀如.jpg 文件夹类型必须以 / 开头不能以 / 结尾如/12345/test 用户最多只能添加10个自定义配置每个设置内容不能超过150字缓存时间可以设置任意整数秒如果设置为0则表示不缓存设置全路径文件缓存规则时仅支持 * 匹配某一类型文件暂时不支持其他正则匹配设置全路径文件缓存规则时暂不支持"/"结尾的首页类型的缓存设置优先级匹配顺序说明当设置了多条缓存策略时相互之间会有重复配置项列表底部优先级高于顶部优先级假设某域名配置了如下缓存配置所有文件 30天.php.jsp.aspx 0秒.jpg.png.gif 300秒 /test/*.jpg 400秒 /test/abc.jpg 200秒假设域名为资源为其匹配方式如下 1. 匹配第一条所有文件命中此时缓存时间为30天 2. 匹配第二条未命中 3. 匹配第三条命中此时缓存时间为300秒第13页

14 4. 匹配第四条命中此时缓存时间为400秒 5. 匹配第五条命中此时缓存时间为200秒因此最终缓存时间为200秒以最后一次匹配生效优先级调整您可以根据业务情况自定义调整已经添加的缓存过期配置顺序在缓存过期设置上方点击调整优先级使用右侧上下箭头调整缓存过期时间配置的顺序点击保存即可缓存继承当用户请求您某一业务资源时源站对应的Response HTTP Header中存在 cache-control 第14页

15 字段此时默认策略如下 cache-control字段为max-age 对该资源的缓存时间以配置的缓存时间为主不继承maxage指定时间若cache-control字段值为 no-cache 或者 no-store 此时CDN节点对此资源不做缓存高级缓存配置在缓存过期配置表的上方有高级缓存过期设置开关当您开启了高级缓存过期设置开关后会达到如下效果用户请求源站某资源时Response HTTP Header中带有cache-control字段且值为maxage=xxxx 此时节点对该资源的缓存时间取配置的过期时间与max-age中的最小值若用户源站配置/index.html 的maxage为200秒 CDN对应配置的缓存时间为600秒则文件实际过期时间为200秒若用户源站配置/index.html 的maxage为800秒 CDN对应的缓存时间为600秒则文件实际过期时间为600秒第15页

16 过滤参数设置功能介绍 CDN为您提供了过滤参数开关您可以根据业务需要控制是否对用户请求 URL 中问号之后的参数进行过滤您可以利用过滤参数灵活的进行版本控制或对资源进行带有 Token 的鉴权配置说明您可以登录 CDN 控制台选择域名管理页面点击要修改过滤参数配置的域名右侧管理按钮在基本配置中可以找到过滤参数设置项默认配置默认情况下过滤参数的开关处于关闭状态此时将不会忽略用户请求URL中之后的参数 1. 假设用户请求的资源URL为接收此请求的节点未缓存该内容则会进行回源获取并缓存至节点 2. 假设用户再次请求资源URL为此时节点已经存在该资源则会命中直接返回给用户第16页

17 3. 假设用户再次请求资源URL为此时由于过滤参数已经关闭则无法全路径匹配内容因此会再次回源进行资源的拉取开启过滤参数当你开启了过滤参数配置时此时将会忽略用户请求URL中之后的参数 1. 假设用户请求资源URL为接收此请求的节点未缓存该内容则会进行回源获取并缓存至节点由于用户开启了过滤参数因此节点存放的资源URL为 2. 假设用户再次请求资源URL为此时在节点实际查找的资源为节点已经缓存因此会直接命中资源并返回给用户 3. 假设用户再次请求资源URL为此时在节点实际查找的资源为节点已经缓存因此会直接命中资源并返回给用户第17页

18 referer 防盗链功能介绍若您希望对业务资源的访问来源进行控制 CDN 为您提供了 Refererer 防盗链配置功能通过对用户HTTP Request Header 中 refererer 字段的值设置过滤策略从而限制访问来源配置说明您可以登录 CDN 控制台选择域名管理页面点击要修改防盗链配置的域名右侧管理按钮您可以在高级配置中找到防盗链配置默认配置第18页

19 默认情况下防盗链未启用无黑/白名单自定义配置配置referer白名单点击防盗链配置处编辑按钮选中referer白名单可进行白名单配置假设用户为域名配置了referer白名单白名单内容如下且未勾选包含空referer 则表明用户仅允许referer值为其他请求均返回403 白名单配置须知第19页

20 若请求的referer字段匹配白名单设置的内容则CDN节点正常返回请求信息若请求的referer字段不匹配白名单设置的内容则CDN节点拒绝返回该请求信息会直接返回状态码4 03 当设置白名单时 CDN节点只能返回符合该白名单内字符串内容的请求当勾选包含空referer选项时此时若请求referer字段为空或无referer字段如浏览器请求则CDN 正常返回请求信息配置referer黑名单点击防盗链配置处编辑按钮选中referer黑名单可进行黑名单配置假设用户为域名配置了referer黑名单黑名单内容如下且未勾选包含空referer 则referer值为其他请求情况均返回正常内容第20页

21 黑名单配置须知若请求的referer字段匹配黑名单内设置的内容 CDN节点拒绝返回该请求信息直接返回403状态码若请求的referer不匹配黑名单内设置的内容则CDN节点正常返回请求信息当勾选包含空referer 选项时此时若请求referer字段为空或无referer字段如浏览器请求则 CDN节点拒绝返回该请求信息返回403状态码注意事项 referer黑名单白名单二者不兼容同一时间只能生效一种类型防盗链输入内容最多可输400条以换行符相隔一行输入一个防盗链支持域名/IP规则匹配方式为前缀匹配即假设名单为则也会匹配假设配置名单为则 /123 也会匹配防盗链支持通配符匹配即假设名单为 *.qq.com 则 a.qq.com均会匹配第21页

22 回源HOST配置功能介绍回源 HOST 是指 CDN 节点在回源过程中在源站访问的站点域名注意事项源站与回源 HOST 源站配置的 IP/域名能够指引 CDN 节点回源时找到对应的源站服务器服务器上可能存在若干 WEB 站点回源 HOST 指明了资源所在的站点配置说明您可以登录 CDN 控制台选择域名管理页面点击要修改回源 HOST 配置的域名右侧管理按钮您可以在基本配置中找到回源HOST配置项默认配置默认情况下子域名的回源 HOST 为所配置的加速域名泛域名回源 HOST 为访问域名第22页

23 若您接入的加速域名为则此节点对此域名下资源发起回源请求时 Request HTTP Header中host字段的值为若您接入的加速域名为泛域名如 *.test.com 若访问域名为 abc.test.com 则回源 HOST 为 abc.test.com 自定义配置您可以根据自身业务情况配置自定义回源HOST 第23页

24 注意事项目前仅支持接入方式为自有源的域名配置回源HOST 请保证您配置的回源HOST域名能够支持访问否则会导致回源失败的情况影响您的业务第24页

25 中间源设置功能介绍若您的源站承载能力有限您可以选择开启中间源服务中间源可以理解为二级缓存节点当用户发起请求时请求会先到达边缘节点若节点无所需资源则会向中间源发起资源请求若仍未在中间源命中中间源会向源站发起请求因此用户的请求回源行为会在中间源进行收敛由中间源统一回源获取数据有效缓解源站压力中间源配置功能已经全面开放欢迎使用配置说明您可以登录 CDN 控制台选择域名管理页面点击要修改中间源配置的域名右侧管理按钮您可以在高级配置中找到中间源配置项默认配置第25页

26 默认情况下中间源配置为关闭状态注意事项中间源配置暂时仅支持域名接入时选择自有源接入方式的域名进行开启第26页

27 HTTPS配置功能介绍 HTTPS 是指超文本传输安全协议 Hypertext Transfer Protocol Secure 是一种在 HTTP 协议基础上进行传输加密的安全协议能够有效保障数据传输安全配置 HTTPS 时需要您提供域名对应的证书将其部署在全网 CDN 节点实现全网数据加密传输功能 HTTPS 配置目前已全面开放欢迎使用配置说明满足以下条件的域名才可配置 HTTPS 域名管理页面域名的状态为部署中或已启动域名不是由 COS 同步而来的.file.myqcloud.com 后缀域名域名的接入方式为自有源或者 COS源 FTP源您可以登陆 CDN 控制台在域名管理页面看到域名 HTTPS 的配置情况带有绿色小锁标记的域名表示证书配置成功点击右侧管理可以在高级配置中看到对应的证书信息第27页

28 证书类型腾讯云 CDN 目前支持两种方式部署证书自有证书将自有证书私钥内容上传至 CDN 进行部署全程加密传输证书不落地保障您的证书安全腾讯云托管证书您可以通过 SSL 证书管理将已有证书托管至腾讯云以用于多个云产品您也可以在该平台申请由亚洲诚信提供的免费证书将其直接部署至 CDN 腾讯云证书原有.qcloudcdn.com 后缀域名为腾讯云所有使用的为腾讯云证书该证书已关闭添加入口证书管理证书添加变更删除等操作请前往证书管理页面进行文档说明请查看证书管理说明第28页

29 HTTP header 配置功能介绍 HTTP的消息通常包括以下两种客户端向服务端发送的请求消息服务端向服务端发送的响应消息以上两种类型的消息均由一个起始行一个或多个头域一个标明头域结束的空行和可选的消息体组成其中 HTTP头域分为四种类型通用头请求头响应头实体头每一个头域由一个域名 Key 冒号阈值 Value 组成腾讯云提供的HTTP Header配置功能当您的用户请求业务资源时在返回的响应消息中添加配置的头域以实现跨域访问等目的注意源站响应资源时的所有头部信息均会存放在CDN节点上当资源在节点命中时所存放头部信息会一起返回给用户; 由于HTTP Header配置是针对域名因此一旦配置生效用户对该域名下任意一个资源的响应消息中均会加入所配置头域配置HTTP Header 仅影响客户端如浏览器的响应行为不会影响到CDN节点的缓存行为 Access-Control-Allow-Origin 与 Content-Disposition 头域CDN默认会继承源站因此请避免源站与CDN同时配置配置说明 CDN提供以下5种头域的配置 Content-Disposition 激活自定资源下载设置以及下载时默认文件名 Content-Language 指定资源在客户端如浏览器响应的语言 Access-Control-Allow-Origin 指定跨域请求时允许访问资源的请求来源第29页

30 Access-Control-Allow-Methods 指定跨域请求时允许的跨域请求方法 Access-Control-Max-Age 指定跨域请求时对特定资源的预请求返回结果的缓存时间通用配置 Content-Disposition Content-Disposition 用来激活浏览器的下载同时可以设置默认的下载的文件名服务端向客户端浏览器发送文件时如果是浏览器支持的文件类型如txt jpg等类型会默认直接使用浏览器打开如果需要提示用户保存则可以通过配置Content-Disposition字段覆盖浏览器默认行为常用的配置如下 Content-Disposition attachment;filename=filename.txt Content-Language Content-Language 是用于定义页面所使用的语言代码常用配置如下 Content-Language: zh-cn Content-Language: en-us 跨域配置跨域是指某一个域名如下的某资源向另一个域名下的某资源发起请求此时由于资源所属域名不同即出现跨域不同的协议不同的端口均会造成跨域访问的出现此时必须在 Response Header 中增加跨域相关配置才能让前者成功拿到数据 Access-Control-Allow-Origin 第30页

31 Access-Control-Allow-Origin 用于解决资源的跨域权限问题域值定义了允许被引用该资源的域也可以设置通配符 * 允许被所有域引用常用配置如下 Access-Control-Allow-Origin: * Access-Control-Allow-Origin: 注意在配置指定域名时需要加上或前缀; 如果有多个则使用分开 Access-Control-Allow-Methods Access-Control-Allow-Methods 允许的跨域请求方式可以设置多个 Access-Control-Allow-Methods: POST, GET, OPTIONS Access-Control-Max-Age Access-Control-Max-Age 指定了预请求的有效时间非简单的跨域请求在正式通信之前需要增加一次HTTPS查询请求称为预请求用来查明这个跨站请求是不是安全可以接受的如下情况会被当成预请求以GET HEAD 或者 POST以外的方式发起或者使用POST 但是请求数据类型为 application/xwww-form-urlencoded multipart/form-data text/plain 以外的数据类型如 application/xml 或者 text/xml 使用自定义请求头第31页

Access-Control-Max-Age 的单位为秒设置示例如下 Access-Control-Max-Age: 1728000 表明在1728000 20天内对该资源的跨域访问不再发送另外一条预请求配置流程登录

32 Access-Control-Max-Age 的单位为秒设置示例如下 Access-Control-Max-Age: 表明在天内对该资源的跨域访问不再发送另外一条预请求配置流程登录 CDN控制台点击域名管理选择需要配置HTTP Header的域名点击右侧管理在高级配置中找到 HTTP Header 配置点击添加可以选择需要添加的header及填写其对应配置支持批量添加一个header仅允许添加一次第32页

33 点击确定即可完成配置配置生效时间大概5分钟也可以对已经添加的header进行修改或删除第33页

34 SEO搜素优化功能介绍 SEO优化配置是为解决域名接入CDN后因CDN频繁变更IP而影响域名搜索结果权重问题的功能通过识别访问IP是否属于搜索引擎用户可选择直接回源访问资源来保证搜索引擎权重的稳定性开启SEO优化配置功能来自搜索引擎的请求将直接回源其他请求将正常访问CDN节点配置说明您可在 CDN 接入时配置缓存时间详情查看域名接入自有源或域名接入 COS源您也可以登录CDN 控制台选择域名管理页面点击要修改 SEO 优化配置的域名右侧管理按钮您可以在高级配置中找到 SEO 优化配置配置项 SEO 第34页

35 优化配置功能只能在自有源方式接入下可使用开启SEO优化配置功能后若域名有多个源站地址则默认回源地址为添加的第一个源站地址若当前域名的 CNAME 为旧 CNAME 如下图所示还需更新为新 CNMAE 后才可使用 SEO 优化配置功能 CNAME 更新的具体操作步骤如下提交工单变更相应域名的 CNAME 为新版在您的域名解析服务商处将对应域名的 CNAME 解析切换为新版 CNAME 注由于搜索引擎 IP 更新较为频繁腾讯云 CDN 仅能确保能识别绝大多数的搜索引擎 IP 第35页

36 IP黑白名单设置功能介绍 CDN为您提供了 IP 黑白名单配置功能您可以根据业务需要对用户请求的源IP配置过滤策略帮助您解决恶意IP盗刷攻击等问题配置说明登录 CDN 控制台点击左侧域名管理菜单栏点击要配置 IP 黑白名单的域名右侧管理按钮进入配置页面您可以在高级配置中找到IP黑白名单配置默认配置默认情况下 IP 黑白名单未启用无黑/白名单自定义配置配置IP白名单第36页

37 点击编辑按钮选中白名单可进行白名单配置假设用户为域名配置了IP白名单白名单内容如下 /24 则表明用户仅允许请求源 IP 为或匹配 /24 网段时能够正常返回所请求的内容不满足条件的请求均直接返回403 配置IP黑名单点击编辑按钮选中黑名单可进行黑名单配置第37页

38 假设用户为域名配置了IP黑名单黑名单内容如下 /16 则表明仅当请求源IP为或匹配 /16网段时直接返回403 其他请求均正常返回所请求内容注意事项 IP黑名单白名单二者不兼容同一时间只能生效一种类型最多可输100条以换行符相隔一行输入一个目前仅支持如下格式的网段 /8 /16 /24 /32 其他网段格式暂不支持当IP黑名单白名单输入内容均为空时表示当前未开启IP黑白名单功能第38页

39 IP访问限频设置功能介绍 CDN 为您提供了IP访问限频配置通过对每一个 IP 在每一个节点每一秒钟访问次数进行限制进行 CC 攻击的抵御配置说明登陆 CDN 控制台点击左侧域名管理菜单栏点击需要配置IP访问限频的域名右侧管理按钮进入域名配置页面您可以在高级配置中找到 IP访问限频配置配置项第39页

40 默认配置默认情况下 IP 访问限频配置为关闭状态自定义配置点击开启按钮打开 IP 访问限频配置此时系统会根据您最近30天的单IP平均访问量给出一个建议阈值您可以在下方当前单IP访问阈值看到给定的默认阈值第40页

41 注意事项默认阈值的算法为计算区间为最近30天每一天有288统计点五分钟一个每一个统计点计算单 IP平均访问频次取每天的最大值计算平均为默认阈值默认阈值最小为10QPS 仅供参考建议您根据业务波动合理设置阈值点击编辑按钮可以自定义设置阈值第41页

42 注意事项 IP限频设置针对单IP单节点每秒访问次数进行了限制若超出限制则会直接返回514 设置较低频次限制可能会影响您的正常高频用户的使用因此请合理设置阈值 Powered by TCPDF ( 第42页

Domain Management产品文档

Domain Management产品文档腾讯云Content Delivery Network Domain Management 产品文档版权声明 2015-2016 腾讯云版权所有本文档著作权归腾讯云单独所有未经腾讯云事先书面许可任何主体不得以任何形式复制修改抄袭传播全部或部分本文档内容商标声明及其它腾讯云服务相关的商标均为腾讯云计算北京有限责任公司及其关联公司所有本文档涉及的第三方主体的商标依法由权利人所有