jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的CDN域名接入

gpt: [CDN](https://developer.qiniu.com/fusion) > 使用指南 > 域名管理 >域名接入

#  域名接入

最近更新时间: 2021-10-12 22:19:25

享受七牛云CDN为您提供的加速服务时，需要先进行域名接入。

# 添加域名

  1. 登陆[七牛开发者平台 __](https://portal.qiniu.com/signin)。

  2. **方式1** :

选择 **产品主页** ,然后选择 **立即添加** 。

![](https://dn-odum9helk.qbox.me/Frn0OUW1uAgOMPVyQJhDkZGoIX3Q)

**方式2** :

选择 **CDN** ,然后选择 **添加** 。  
![](https://dn-odum9helk.qbox.me/FiAJMJZYgmQQmUHOIlQ3CtGqB_Go)

操作完 方式1 或者 方式2 之后，会出现 **创建域名** 界面。

![](https://dn-odum9helk.qbox.me/FsPiG1a_TD2STgMXOKx2Vt1JsWiH)

**注意** ：

如果您界面上方显示的是 **未完成实名认证** ，如下图所示：

![](https://dn-odum9helk.qbox.me/FoWxLw-SL8NdmGyHi60cThnI-Nqm)  
此时您需要在 **个人中心** 进行实名认证

![](https://dn-odum9helk.qbox.me/FnyEISZbsazeBtdjJQ0riPXw4oIr)

此外，请您确认您的绑定域名是否是已备案的状态，您可以在[域名信息备案系统
__](http://beian.miit.gov.cn/publish/query/indexFirst.action)查询。

  3. **创建加速域名** 界面，在 **域名类型** 栏选择域名类型。域名类型包含：普通域名，泛域名，泛子域名。

  * 普通域名，是指您的主域名下的子域名。例如主域名qiniu.com，developer.qiniu.com是其二级域名，a.developer.qiniu.com是其三级域名,…,这些都属于普通域名。
  * 泛域名，是指域名*.主域名，配置成功后可任意指定前缀进行访问；可基于该泛域名创建多个泛子域名来指定不同源站，例如泛域名 *.qiniu.com。
  * 泛子域名，基于泛域名创建的子域名；可独立指定源站，其它配置继承泛域名。

  4. **创建加速域名** 界面，在 **加速域名** 栏填写域名。建议对加速域名进行 ICP 备案，若域名未进行备案，加速区域只能选择不含中国大陆的纯海外加速区域。

  5. **创建加速域名** 界面，在 **通信协议** 栏选择所需的通信协议。您可以选择 https 通信协议或者 http 通信协议。如果您选择 https协议，您还需上传有效期大于半年的 HTTPS 证书。（注：为了不影响正常使用，证书到期后请及时续期）

  6. **创建加速域名** 界面，在 **使用场景** 栏选择所在的使用场景。使用场景分为图片小文件，下载分发和点播平台。

  * 图片小文件，适用于网页、图片、小文件。
  * 下载分发，适用于文件下载，例如安装包，压缩包等二进制大文件。
  * 点播平台，适用于需要MP4/FLV等文件按照时间点进行播放。
  * 动态加速，适用于电商、社交、社区论坛、金融支付和游戏娱乐等方面。

  7. **创建加速域名** 界面，在 **IP协议** 栏选择所需CDN支持的IP协议。

  * IPv4，仅支持通过IPv4协议访问CDN节点，回源仍是IPv4协议。
  * IPv4/IPv6，支持IPv4或IPv6协议访问CDN节点，回源仍是IPv4协议。IPv6协议仅支持中国大陆，非中国大陆地区暂不支持IPv6配置。

  8. **创建加速域名** 界面，在 **源站配置** 栏选择源站。可以选择七牛云存储，源站域名，IP地址，高级设置。

  * 七牛云存储，选择您的七牛云空间，您将需要加速的资源上传到空间 或者 您可以设置**空间镜像** ，这样您的资源会更快的迁移到七牛云空间（如何设置空间[镜像存储](https://developer.qiniu.com/kodo/manual/set-up-the-mirror-store)）。注意，若您的域名未进行 ICP 备案，则源站存储只能选择七牛海外存储。
  * 源站域名，填写您的源站域名，不能与**加速域名** 相同。**源站测试** 中需要您填写您需要加速的资源名，通过源站测试，表明源站配置正确。
  * IP地址，填写您源站的IP地址，**源站测试** 中需要您填写您需要加速的资源名，通过源站测试，表明源站配置正确。
  * 高级配置，设置多个主线路或者备线路，访问请求根据权重分配。

  9. **创建加速域名** 界面，选择 **创建** ，此时创建成功。  
  

# 配置CNAME

创建加速域名成功后，七牛云会提供cname地址，需要在域名服务提供商处将加速域名指向分配的CNAME地址，配置生效后，即可享受CDN加速服务。  
选择 **CDN** ，在 **域名管理** 界面选择创建好的 **域名** ，点击 **配置** ，提供的cname在红框中标注。您可以参考链接
[CNAME配置 __](https://developer.qiniu.com/fusion/manual/4941/cname-
configuration)配置cname值。  
![](https://dn-odum9helk.qbox.me/Fvc-fDSYZFi-BUpu2YOtAQQdK0G0)

以上内容是否对您有帮助？
human: 如何处理七牛云的CDN域名操作

gpt: [CDN](https://developer.qiniu.com/fusion) > 使用指南 > 域名管理 >域名操作

#  域名操作

最近更新时间: 2021-07-22 17:33:49

您可以登录[七牛开发者平台 __](https://portal.qiniu.com/)选择**CDN** 控制台上，对接入**CDN**
的加速域名进行启用域名、停用域名、删除域名、配置域名、查询统计分析等操作。

# 启用域名

域名状态为**已停用** 时，可以点击**启用** ，重新启用域名的CDN加速服务。  
![](https://dn-odum9helk.qbox.me/FuAoX8QpN57b4Nhfep4tzDtWJF-g)  
  

# 停用域名

如需暂时停用某个域名的CDN加速服务时，可以点击**停用** ，暂停该域名的服务。  
该状态会将解析解析指向一个不可用的地址，若部分DNS缓存未过期而请求到节点上的服务依旧可以正常访问。  
![](https://dn-odum9helk.qbox.me/FjI21PrAZvYiPOmtum9mUmIHPwq2)  
  

# 删除域名

域名状态为**已停用** 时，可以对该域名执行删除操作，删除后其配置将不会保留。  
![](https://dn-odum9helk.qbox.me/FuAoX8QpN57b4Nhfep4tzDtWJF-g)  
  

# 配置域名

域名状态为成功时，可以修改其配置。  
  

# 统计分析

可以直接点击**统计** 查询域名的统计分析数据。  
  

# 操作状态说明

域名操作 | 说明  
---|---  
停用域名 | 1.根据需求用户在CDN控制台上可以将域名停用。  
2.过去90天，没有流量且没有任何操作的域名会被停用，停用前3天会发送通知告知用户。  
3.域名停用后如3天内没有启用，将删除域名配置。  
启用域名 | 1.根据需求用户在CDN控制台上可以启用出已停用状态的域名。  
2.域名启用后将重新恢复域名解析，并将配置下发至CDN节点。  
删除域名 | 1.根据需求用户在CDN控制台上可以删除出已停用状态的域名.  
2.冻结后90天，没有解冻，且没有任何操作。  
3.停用后90天，没有启用，且没有任何操作。  
4.域名删除后将会删除其所有配置。  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的CDNCNAME配置

gpt: [CDN](https://developer.qiniu.com/fusion) > 使用指南 > 域名管理 >CNAME配置

#  CNAME配置

最近更新时间: 2021-10-12 22:19:34

您的域名接入 CDN 后，系统会为您自动分配一个 CNAME
域名，要启用CDN加速服务，需要在域名服务提供商处将加速域名指向分配的CNAME地址，配置生效后，即可享受CDN加速服务。

# 获取加速域名的CNAME

  * 在 **七牛开发者平台** 页面选择 [**CDN** __](https://portal.qiniu.com/cdn/overview)，选择[**域名管理** __](https://portal.qiniu.com/cdn/domain)，将鼠标悬停在对应的**cname** 后，会出现蓝色字样 **复制** ，如下图所示，点击即可复制CNAME值。  
![](https://dn-odum9helk.qbox.me/FsXcbPis0zt0EiiGscr2VMQ3KeHd)

  * 或者您也可以通过在 [**七牛开发者平台** __](https://portal.qiniu.com/create)页面选择[**CDN** __](https://portal.qiniu.com/cdn/overview)，选择[**域名管理** __](https://portal.qiniu.com/cdn/domain)，点击您需要配置的**域名** 后的 **配置** 字样，进入 **配置** 界面，在基本信息中查看CNAME值 ，如下图所示。  
![](https://dn-odum9helk.qbox.me/FnXEhW58hEqoCGs0DTg7OxGAJQtS)  
![](https://dn-odum9helk.qbox.me/Fo4sC99JUBJnFGrQvM7g465HO_BM)

* * *

# 添加CNAME记录

  * 添加CNAME记录需要在您的 **`域名厂商`** 处配置，比如您在阿里云/腾讯云/新网等处购买的域名，您需要前往 **`购买域名的厂商`** 的相应控制台配置做域名解析。  
1.在域名列表中找到您加速域名对应的 **`主域名`** ，进入解析设置页。  
2.依次填写主机记录，记录类型以及记录值，其他可设为默认值。

![](https://oi2ix6x26.qnssl.com/attachments/download/1073669/00157dfa3bb59f2916e851536da6890/?filename=blob.png)

记号 | 说明  
---|---  
A | 记录类型为CNAME  
B | 主机记录处填子域名  
C | 线路类型（默认为必填项，否则会导致部分用户无法解析；在上图中，默认的作用为：除了联通用户之外的所有用户，都会指向 1.com）  
D | 记录值填写七牛提供的cname值，记录生成后会自动在域名后面补一个 “.”，这是正常现象  
E | MX优先级不需要填写  
F | TTL 不需要填写，添加时系统会自动生成，默认为 600 秒（TTL 为缓存时间，数值越小，修改记录各地生效时间越快）  
  
例如，记录类型请选择为CNAME，主机记录为主域名的前缀，假设购买的域名为‘qiniu.com’，这是一个一级域名：

  * 您创建的加速`普通域名`为 qiniu.com ，主机值为@
  * 您创建的加速`普通域名`为 cdn.qiniu.com ，主机值为 cdn
  * 您创建的加速`普通域名`为 img.cdn.qiniu.com ，主机值为 img.cdn
  * 您创建的加速`泛域名` .qiniu.com ，主机值为*
  * 您创建的加速`泛域名` .img.qiniu.com ，主机值为*.img

记录值填写在七牛控制台`复制的CNAME值`，解析线路和TTL保持默认值即可。

  * CNAME配置生效时间：新增CNAME记录会实时生效，而修改CNAME记录需要等待生效时间。

# 验证CNAME是否配置正确

  * 在空间内查看 CDN 加速域名 的状态，如果是成功，即解析成功，如果是等待CNAME，则未正确解析。  
![](https://dn-odum9helk.qbox.me/Fsd7ewXNwak6XbnX0clLwHRa62Rj)

  * 如果您在域名厂商处已经正确配置CNAME解析后，但还是“等待CNAME”状态。  
linux/mac系统您可以通过dig命令查看，第一条是否解析到您配置的CNAME值，如果已经解析成功，则可以忽略不计。  
![](https://dn-odum9helk.qbox.me/FpqjWyiiCInCQp7ZS2HpIW_jcTnT)  
windows系统可以通过Win+R 或 点击左下角的“开始”按钮打开“开始”菜单，从中打开“运行”，输入cmd回车，在命令行模式下输入`nslookup
您的加速域名`  
示例如图，如果图中可以看到您复制的cname值即可。

![](https://dn-odum9helk.qbox.me/FgeCvjPMtpw4csmNtK3cSvuS-Pzr)

* * *

如果您同时需要对源站进行[镜像存储 __](https://developer.qiniu.com/kodo/kb/1376/seven-cattle-
image-storage-instruction-manuals)，您还需要进行如下操作：

  1. 如原指向资源的域名是 pic.abc.com ，要把该域名 CNAME 到 portal平台“成功”状态的新域名。
  2. 重新配置一个二级域名（比如叫：image.abc.com ）指向资源存放目录
  3. 设置镜像为 `http://image.abc.com`  
以上三步完成后，不需要更改代码及数据库，即可用 `http://pic.abc.com/path/10.jpg`

以上内容是否对您有帮助？
human: 如何处理七牛云的CDN域名找回

gpt: [CDN](https://developer.qiniu.com/fusion) > 使用指南 > 域名管理 >域名找回

#  域名找回

最近更新时间: 2023-10-30 14:02:40

# 一、填写域名并点击找回

由于域名在其他账号下创建，域名归属权不在当前账号，需要进行验证操作才可以获得该域名

![](https://dn-odum9helk.qbox.me/FrlOz7pZBpZtDlaSdEeJT4dzq5Lg1)  
  

# 二、选择验证方式

验证方式分为两种，文件验证和TXT记录验证。  
1.文件验证  
域名如果解析到之前的存储空间，下载该文件并上传到之前账号的存储空间  
域名如果解析到自己的服务器，下载该文件并上上传到自己的服务器网站根目录  
**注意** ：需要保持 `http://<您要找回的域名>/verifyingfile.html` 这个链接可以正常访问达到如下效果即可  
![image.png](https://dn-odum9helk.qbox.me/Fjong41YGqey0EBsgmXHIQt7FubD)  
2.TXT记录验证  
TXT记录验证  
需要到域名当前DNS服务商处给域名添加 TXT 记录值  
![image.png](https://dn-odum9helk.qbox.me/Fqw9t4Ri1AVViVfTzsN15hmo7Uj0)

# 三、提交验证

点击验证之后，显示弹窗说明，则验证通过，然后等待 6 - 8 小时系统自动过户即可

![企业微信截图_12bb9f10-34f2-4ddf-b6c8-10faa431ed66.png](https://dn-
odum9helk.qbox.me/FtB9ZhGyja1EyyUYJmSvDqiMstAy)

> **如果长时间验证不通过，建议拨打 400-808-9176 转 2 号线，联系技术支持处理。**

以上内容是否对您有帮助？
human: 如何处理七牛云的CDN批量复制

gpt: [CDN](https://developer.qiniu.com/fusion) > 使用指南 > 域名管理 >批量复制

#  批量复制

最近更新时间: 2023-08-11 15:31:45

批量复制可以实现复制已有域名的配置完成批量添加域名，支持调整基础配置批量复制，也支持自定义勾选Referer 防盗链、IP
黑白名单、时间戳防盗链、图片自动瘦身、图片处理、HTTP 响应头等配置项批量复制。

  

# 操作说明

### 1.登录**七牛开发者平台** 后，进入**CDN控制台** ，选择【域名管理】，点击目标域名**操作** 项下的**复制** 进入配置界面：

![image.png](https://dn-odum9helk.qbox.me/FrBIkQltQG6qt7FXo-O2hNAgPOxW)  
注意：只有**成功** 状态的域名支持批量复制

### 2.添加域名&确认配置

在**加速域名** 输入框中输入需要批量添加的域名，并确认**基本信息、源站配置和缓存配置** ，若非预期配置可以修改。

![image.png](https://dn-odum9helk.qbox.me/FlEsd5KxLp9oJqEqgq9cAatEUi7J)

注意：  
a. 添加域名中存在未备案域名，加速范围只能选择海外；  
b. 完整域名和泛域名需要分开添加，不能混在一起批量复制；  
c. **源站测试** 需要点击并显示测试通过后，才可以点击**下一步** ，否则会报错提示“源站待测试”。

### 3.选择复制配置

**配置项** ：支持自定义勾选的批量复制配置项，包含Referer 防盗链、IP 黑白名单、时间戳防盗链、图片自动瘦身、图片处理、HTTP
响应头等配置批。  
**配置状态** ：配置项的配置状态，包含开启和关闭两种。  
**操作** ：点击**详情** 可以查看配置项的配置详情。

![image.png](https://dn-odum9helk.qbox.me/Fg7tRJ9orwTwHVsQ72fFxD6PAW5N)

注意：  
a. 若被复制域名存在后端特殊配置（非控制台配置），该特殊配置无法复制，若需要请联系客服补充配置。  
b. 因 HTTPS 证书配置需要重新绑定当前域名，不支持复制此配置，若需要请自助补充配置。  
c. 配置状态为关闭的配置项勾选和不勾选，实际配置效果均为关闭。

### 4.确认提交

确认无误，点击**确认** 即可，否则点击**取消** 返回上一步。

![image.png](https://dn-odum9helk.qbox.me/Fv-W_cOemX6388yWG8aGDRabgGCY)

### 5.创建完成

![image.png](https://dn-odum9helk.qbox.me/Fk20JyldmZAGHmaVpLJ8xh6AazrX)  
注意：  
a. 域名的状态若为“创建完成”，仅表示创建域名的任务提交成功，不表示域名配置下发完成；  
b. 域名的状态若为“域名所有权待验证”，需要点击**操作** 项下的**所有权验证** 逐个域名进行所有权验证，否则无法成功添加域名。

以上内容是否对您有帮助？
human: 如何处理七牛云的CDN配置概览

gpt: [CDN](https://developer.qiniu.com/fusion) > 使用指南 > 配置管理 >配置概览

#  配置概览

最近更新时间: 2020-01-09 11:56:53

**七牛云CDN** 支持多项自定义配置，您可以根据自身业务需要进行设置。

# [回源配置](https://developer.qiniu.com/fusion/manual/4943/back-to-the-source-
configuration)

配置项 | 描述 | 默认值  
---|---|---  
源站信息 | 资源的回源域名或IP, 推荐使用七牛云存储作为源站 | 用户配置  
回源HOST | 指定请求的服务器的域名，默认为加速域名 | 加速域名  
回源协议 | 请求回源的协议，如需修改回源协议请先开启 HTTPS | HTTP  
  
  

# [缓存配置](https://developer.qiniu.com/fusion/manual/4944/cache-configuration)

配置项 | 描述 | 默认值  
---|---|---  
缓存时间 | 定义指定资源内容的缓存过期时间规则 | 全局缓存1个月  
忽略URL参数 | 资源缓存时去除 URL「?」后的全部参数进行缓存 | 未开启  
  
  

# 访问控制配置

配置项 | 描述 | 默认值  
---|---|---  
[referer防盗链](https://developer.qiniu.com/fusion/manual/3839/domain-name-hotlinking-prevention) | 配置 Request Header 中 referer 黑白名单，从而限制访问来源 | 未开启  
[时间防盗链](https://developer.qiniu.com/fusion/manual/3841/timestamp-hotlinking-prevention-fusion) | 设置密钥，配合签名过期时间来控制资源内容的访问时限 | 未开启  
[回源鉴权](https://developer.qiniu.com/fusion/manual/3930/back-to-the-source-authentication) | 配置回源验证策略，对 CDN 接收到的访问请求进行鉴权，适用于对防盗链有很高实时性要求的场景 | 未开启  
[IP黑白名单](https://developer.qiniu.com/fusion/manual/4977/ip-black-and-white-list) | 允许或者禁止某些 IP 或 IP 段的访问，帮助您解决恶意 IP 盗刷、攻击等问题 | 未开启  
  
  

# [HTTPS配置](https://developer.qiniu.com/fusion/manual/4952/https-
configuration)

配置项 | 描述 | 默认值  
---|---|---  
开启HTTPS | 开启 HTTPS 安全加速，支持 SSL 证书绑定及 HTTPS 状态管理 | 未开启  
更换证书 | 更换即将过期或泄漏的证书 | 无  
强制HTTPS | 开启后 HTTP 请求会强制跳转到 HTTPS 进行访问，关闭时默认兼容用户的 HTTP/HTTPS 请求 | 未开启  
  
  

# [流量带宽告警](https://developer.qiniu.com/fusion/manual/4953/warning-traffic-
bandwidth)

配置项 | 描述 | 默认值  
---|---|---  
阈值告警 | 可针对域名流量/带宽设置阈值，接近和触发阈值时会告警通知 | 未开启  
  
  

# [图片优化](https://developer.qiniu.com/fusion/manual/4954/image-optimization)

配置项 | 描述 | 默认值  
---|---|---  
图片自动瘦身 | 无需添加任何参数，自动瘦身；图片体积大幅减少，节省 CDN 流量 | 未开启  
图片处理 | 缩略图，裁剪，选择，格式等多种图片处理，需用户添加参数主动调用 | 未开启  
  
  

以上内容是否对您有帮助？
human: 如何处理七牛云的CDN基本信息

gpt: [CDN](https://developer.qiniu.com/fusion) > 使用指南 > 配置管理 >基本信息

#  基本信息

最近更新时间: 2021-10-12 18:28:20

您可以登录**七牛开发者平台** 选择**CDN控制台**
,可以在控制台中查看域名的基本信息，包括加速域名、CNAME、创建时间、修改时间、域名状态、域名类型、协议、使用场景、覆盖信息、IP协议。  
  

# 操作说明

登录**七牛开发者平台** 后，进入**CDN控制台** ，选择【域名管理】，点击【配置】：  
![](https://dn-odum9helk.qbox.me/FhvLpHxZn1_jaxLi__n1AEo6dfeq)

进入域名配置界面，可以查阅包括加速域名、CNAME、创建时间、修改时间、域名状态、域名类型、协议、使用场景、覆盖信息等基本信息。  
![](https://dn-odum9helk.qbox.me/FmRSA5JoiRTXZyOCuq4h49U2LNdN)

以上内容是否对您有帮助？
human: 如何处理七牛云的CDN回源配置

gpt: [CDN](https://developer.qiniu.com/fusion) > 使用指南 > 配置管理 >回源配置

#  回源配置

最近更新时间: 2024-03-29 17:50:05

您可以登录**七牛开发者平台** 选择**CDN控制台** ,可以在控制台中查看域名的回源配置信息及进行相关配置修改。  
  

# 操作说明

登录**七牛开发者平台** 后，进入**CDN控制台** ，选择【域名管理】，点击【配置】：

![域名列表](https://dn-odum9helk.qbox.me/Fr29HEF4Y0J1NHYmOWW1SkjcyUFD)

进入域名配置界面，点击【修改配置】进行回源配置的修改。  
![](https://dn-odum9helk.qbox.me/FpxnDf126nd-Vc5NYpvelfwrFZRX)

### 基础配置

回源方式支持七牛云存储、源站域名、IP地址、高级设置四种模式。

  * 七牛云存储：选定七牛云存储对应的bucket作为CDN回源的源站。  
![七牛云存储](https://dn-odum9helk.qbox.me/Fv7vhNlE03zFd2tALfTwu2ZPVZ3J)

  * 源站域名：设置指定域名作为CDN回源的源站，源站的域名需要与加速域名不一致。  
![源站域名](https://dn-odum9helk.qbox.me/Fkjtfh4aeo7LjgJuDDlhPKvituZF)

  * IP地址：设置IP作为CDN回源的源站，支持配置多个IP；回源采用轮询方式，首次选择配置的第一个IP进行回源，当发现某一源站IP异常时，将跳过此IP并进入惩罚时间，屏蔽5秒。  
![IP地址](https://dn-odum9helk.qbox.me/FnXCmiRCuqeEWqg4E_sutaSCjmMV)

  * 高级配置：支持配置多个回源的主备线路，可以是域名或是IP，并支持权重配置。  
说明：  
（1）权重：请求概率=权重/权重总和，eg：有两个主线路A和B，A权重1 和 B权重3，那么四次请求，1次是A，3次是B。  
（2）回源地址不能与加速域名相同。  
![](https://dn-odum9helk.qbox.me/FkRL14AuFHuwZdSlpHzxqXAlWHQB)

### 回源host

回源host：是指 CDN 节点在回源过程中，在源站访问的站点域名。  
源站为七牛云存储，回源HOST无需填写，源站为域名、IP、以及高级回源模式，回源 HOST默认是加速域名，支持自定义配置。  
![](https://dn-odum9helk.qbox.me/Fvd_r_Ku70w6XJBw6dbT9mQnrIGH)

### 回源协议

回源协议：即请求回源的协议，支持选择HTTP、遵循请求协议、HTTPS三种方式。  
![image.png](https://dn-odum9helk.qbox.me/FsybbIE05uZaQWZkkYMJGnWDA5eh)

### 去参数回源

去参数回源：请求回源时去除URL「?」后的参数进行回源，支持去除所有参数和去除指定参数两种方式。  
![](https://dn-odum9helk.qbox.me/FuVZ5wszpfELBWrCOMYxQjUvioDH)

### 回源验证

回源验证：保证源站的高可用，只有源站测试通过才能继续创建域名。  
![](https://dn-odum9helk.qbox.me/FgEsyT24W3KBU2d2tM0jpPJcW79R)

### Range回源

Range回源：开启此功能，有助于减少大文件分发时回源消耗并缩短响应时间，但是此功能需要源站支持Range请求。  
![image.png](https://dn-odum9helk.qbox.me/FiRcvAL8mLA2pbKDHAWg-50qT9f3)

以上内容是否对您有帮助？
human: 如何处理七牛云的CDN缓存配置

gpt: [CDN](https://developer.qiniu.com/fusion) > 使用指南 > 配置管理 >缓存配置

#  缓存配置

最近更新时间: 2023-09-06 22:01:24

缓存过期配置是指配置 CDN 加速节点在缓存您的业务内容时遵循的一套过期规则，您可以登录**七牛开发者平台** 选择**CDN控制台**
,可以在控制台中查看域名的缓存配置信息并进行修改。  
  

# 操作说明

登录**七牛开发者平台** 后，进入**CDN控制台** ，选择【域名管理】，点击【配置】：

![image.png](https://dn-odum9helk.qbox.me/FoUkQAv_JjN_wbXH5h0dWNaKsDOK)

进入域名配置界面，点击【修改配置】进行缓存配置的修改。  
![image.png](https://dn-odum9helk.qbox.me/Fi0oPyi0B5l4fYfqnvK6wBQpShu0)

### 基础配置

缓存的基础配置分为自定义、遵循源站两种类型

  * 自定义：自定义指定的资源内容的缓存过期规则，默认为全局配置缓存30天，支持按照文件后缀、目录规则进行配置。

（1）后缀：必须以「.」(英文点)开始，多个后缀请用「;」(英文分号)隔开，例如(.png;.jpg;.gif)。

（2）路径：必须以「/」(英文斜杠)开始，多个路径请用「;」(英文分号)隔开，例如: (/a/b/c;/d/e/f;/h/i/j) ，路
径中不能包含「.」，也不能以「/」结尾。

（3）缓存规则最多可配置15条。

（4）1条缓存规则中，最多10个后缀/路径，「;」(英文分号)隔开。

（5）时间单位：分/小时/天，只能输入整数，最大值为 365 天。

（6）0 代表不缓存。

（7）按从上至下顺序，采取优先匹配原则。  
![image.png](https://dn-odum9helk.qbox.me/FqNj0pxE1Piz51ic_k1bcFqcyRSZ)

推荐配置：  
（1）.jpg;.jpeg;.png;.bmp;.gif;.webp;.ico 图片类型缓存1天。

（2）.js;.css;.txt;.xml;.shtml;.html;.htm;.csv;.bat 文本类型缓存1天。

（3）.m3u8 m3u8类型缓存1小时。

（4).avi;.mkv;.mp4;.mov;.flv;.rm;.rmvb;.swf;.mp3;.wav;.wmv;.rmi;.aac 音视频类型缓存7天。

（5）.exe;.deb;.ipa;.apk;.sis;.psd;.dat 大文件类型缓存7天。  
![image.png](https://dn-odum9helk.qbox.me/FoPk-xM0QeoMM2jadi-9ViQMdxN1)

  * 遵循源站：所有全部资源内容的缓存过期时间将与源站同步。  
![image.png](https://dn-odum9helk.qbox.me/FqxpoyytWHTO6hLhxRXqZImdqS4X)

### URL参数

  * 保留所有参数：资源缓存时保留 URL「？」后的全部参数进行缓存，请确认请求的 URL 的参数值和文件有关再开启，否则会降低缓存命中率并增加 CDN 回源次数。  
![image.png](https://dn-odum9helk.qbox.me/FlNciYBd9fO7--n0sRVPPyC6Tf6F)

  * 忽略所有参数：资源缓存时去除 URL「?」后的全部参数进行缓存，忽略全部参数同时会导致图片处理等 FOP 功能失效。  
![image.png](https://dn-odum9helk.qbox.me/FnwXWcwzoPzBnVAfzSQFU2qQjUo4)

  * 保留指定参数：资源缓存时会仅仅保留您输入的指定参数然后进行缓存。  
![image.png](https://dn-odum9helk.qbox.me/FrtTdO0dIXigDoeBPnZgcsR-cDdW)

  * 忽略指定参数：资源缓存时会去除您输入的指定参数然后进行缓存。  
![image.png](https://dn-odum9helk.qbox.me/FhTcuBoDXJUmKsP5rHpEaJs7yicw)

以上内容是否对您有帮助？
human: 如何处理七牛云的CDN访问控制配置

gpt: [CDN](https://developer.qiniu.com/fusion) > 使用指南 > 配置管理 >访问控制配置

#  访问控制配置

最近更新时间: 2024-06-24 11:36:31

七牛 CDN 提供多种访问控制方式来实现对访客身份的识别和过滤，从而限制访问CDN资源的用户，提升CDN的安全性。

若您的域名因被恶意攻击或流量被恶意盗刷，产生了突发高带宽或者大流量消耗，导致产生高于日常消费金额的高额账单。因恶意攻击或流量盗刷产生的高额账单无法免除/退款。

为尽量避免此类风险，建议您开启CDN的访问控制功能：

功能 | 说明  
---|---  
[Referer 防盗链 __](https://developer.qiniu.com/fusion/manual/3839/domain-name-
hotlinking-prevention)|  可以通过配置访问的Referer黑名单和白名单来实现对访客身份的识别和过滤，限制访问CDN资源的用户。  
[时间戳防盗链 __](https://developer.qiniu.com/fusion/manual/3841/timestamp-
hotlinking-prevention-fusion)|
可以通过配置时间戳防盗链功能保护用户站点的资源不被非法站点下载盗用。时间戳防盗链鉴权比Referer防盗链安全性更高。  
[回源鉴权 __](https://developer.qiniu.com/fusion/manual/3930/back-to-the-source-
authentication)|  鉴权服务器根据请求头中的鉴权参数等给出鉴权结果。  
[IP 黑白名单 __](https://developer.qiniu.com/fusion/4977/ip-black-and-white-list)|
可以通过配置IP黑名单和白名单来实现对访客身份的识别和过滤，限制访问CDN资源的用户  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的CDNReferer防盗链

gpt: [CDN](https://developer.qiniu.com/fusion) > 快速入门 > Referer防盗链

#  Referer防盗链

最近更新时间: 2021-11-16 14:21:55

referer防盗链是基于获取HTTP请求中的 referer header，根据 referer
跟踪来源，对来源进行识别和判断，您可以登录**七牛开发者平台** 选择**CDN控制台** ，进行referer
黑白名单的配置，从而限制访问来源，避免恶意用户盗刷。

# 功能说明

referer防盗链默认为关闭状态，开启后可以进行referer黑白名单的配置。

  * 白名单：请求的referer字段匹配白名单设置的内容，则 CDN 节点正常返回请求信息，若不匹配，CDN 节点拒绝返回该请求信息，返回状态码 403。

  * 黑名单：请求的referer不匹配黑名单内设置的内容，则 CDN 节点正常返回请求信息，若匹配，CDN 节点拒绝返回该请求信息，返回状态码 403。

  * 是否允许空referer：当选择允许空referer时，此时若请求referer字段为空或无referer字段 CDN 节点正常返回请求信息；若不允许，此时若请求referer字段为空或无referer字段 CDN 节点拒绝返回该请求信息，会直接返回状态码 403。

# 操作说明

1、登录**七牛开发者平台** 后，进入**CDN控制台** ，选择【域名管理】，点击【配置】。  
![](https://dn-odum9helk.qbox.me/Fr29HEF4Y0J1NHYmOWW1SkjcyUFD)

2、进入域名配置界面，**访问控制** 模块下的**referer防盗链** 点击【修改配置】进行referer防盗链的配置。  
![](https://dn-odum9helk.qbox.me/FiykQD58v_0Ic9vns-POMjK6yNsZ)

3、开启防盗链配置，选择黑白名单，输入访问的来源域名。  
![](https://dn-odum9helk.qbox.me/FlObMjmuf13uq3JbE4oPRHXZgGfe)

**注意事项**

（1） 域名之间请回车换行，无需填写 http://，https://；

（2）支持域名前使用通配符 ：*.example.com 可用于指代所有 example.com 下的多级子域名，比如 a.example.com
等，但是不包括 example.com，如需要请额外填写一条 example.com；

（3）防盗链个数设置不能超过100个；

（4）黑白名单生效时间为 1 小时，在此期间不能修改其它配置；

（5）不支持 IP，不支持端口号。

以上内容是否对您有帮助？
human: 如何处理七牛云的CDN回源鉴权

gpt: [CDN](https://developer.qiniu.com/fusion) > 快速入门 > 回源鉴权

#  回源鉴权

最近更新时间: 2023-04-25 18:51:21

# 一. 概览

![](https://dn-odum9helk.qbox.me/FodfQmV94f0fSybXEVnOeEUdgF5u)

如上图所示流程：

  1. 用户请求到 CDN 节点；
  2. CDN 节点将用户请求原封不动的转发给鉴权服务器；
  3. 鉴权服务器根据请求头中的鉴权参数等给出鉴权结果；
  4. CDN 节点未命中向源站获取文件；
  5. 源站根据请求响应内容给 CDN ，同时 CDN 缓存内容；
  6. CDN 节点根据鉴权结果将内容响应给最终用户；

# 二. 使用说明

## 开启设置

域名管理列表 -> 配置 -> 访问控制 -> 回源鉴权 -> 点击修改配置，如下图：

![](https://dn-odum9helk.qbox.me/Fr29HEF4Y0J1NHYmOWW1SkjcyUFD) ![](https://dn-
odum9helk.qbox.me/FrdpM2-nAZJOO9IoXOAOGPuwdxve)

注意：如果域名回源七牛私有 bucket ，只用点开启就可以了，后面的参数不用设置，终端用户访问完全兼容七牛私有资源访问格式

## 设置介绍

## 1\. 配置鉴权服务器地址

鉴权地址就是用户的鉴权 http 服务器的对外可访问的地址。

## 2\. 配置鉴权请求方法

用户的鉴权 http 服务器支持的请求方法，现在支持 GET，POST，HEAD。

## 3\. 配置鉴权对象

鉴权对象支持选择“所有文件类型”或“指定文件后缀”。

## 4\. 配置鉴权参数

鉴权参数为用户鉴权服务器端需要的 URL 参数的 KEY ， 配置的 URL 参数会从终端用户访问资源（CDN 边缘节点）时所带的 URL 参数。  
采集并过滤后，发送给用户鉴权服务器；同时这些参数在回源时也会带上。配置格式请参考样例。

注意：

  * 终端用户访问资源时的请求头信息（request header）会全部传给用户的鉴权服务器；
  * 如果用户鉴权服务不是通过 URL 参数鉴权，而是通过请求头信息中的某些字段，上面的鉴权参数可以不用设置

## 5\. 设置回调参数(更多参数)

## 名词解释

回调参数(更多参数)是指不参与鉴权但可配置返回给用户鉴权服务器的参数，用以帮助查错及统计分析鉴权的结果，分为系统参数和自定义参数两种。系统参数类型有请求资源的ip，请求资源的path，请求资源的host，请求资源的query等几种，其对应的值已解析出来，不用设置，但参数名称以及返回的方式都可自定义；而自定义参数，
其名称、值以及返回的方式都可自定义。

## 如何设置

### a. 入口

打开回源鉴权配置，拉到更多参数配置选项，如下图，注意如果是回源七牛私有bucket，没有该选项。  
![](https://dn-odum9helk.qbox.me/Fi4AItGekSsO6Be7hnPs9-JtXOsz)

### b. 返回方式选择

根据用户请求方法HEAD，GET，POST 选择其回调参数的返回方式如下图:  
![](https://dn-odum9helk.qbox.me/FixEFiAXv9Xgpm19om2aJkiaI5WU)

如果请求方法为POST，可额外选择为从body返回：  
![](https://dn-odum9helk.qbox.me/FgywfDnMS5XoPGrrE7aPzfv7G58J)

### c. 参数名和参数值选择

![](https://dn-odum9helk.qbox.me/FgmmMsdWLU1-wG8HhojVwYs7Onf8)

注意如果是系统参数，参数值是不可以设置的：  
![](https://dn-odum9helk.qbox.me/FgefrwtEkRfsdC4QsSA9gkVQQcN8)

### d. 例子

需要拿到用户的请求ip，并放到Header里面，并且在Header里标记该回源鉴权请求来自七牛：  
![](https://dn-odum9helk.qbox.me/FnM8TcSpom_mBBnXaD337siDUslE)

## 6\. 设置鉴权返回状态码

设置用户鉴权服务器的返回的 HTTP 状态码。

## 7\. 设置鉴权超时时间

设置 CDN 发起鉴权请求到用户鉴权服务器的超时时间，超时后的行为请参考下一步。

## 8\. 设置鉴权超时或者其他情况下的鉴权结果

这一步是设置 CDN 发起鉴权请求到用户的鉴权服务器超时（超时时间请参考上一步）后， CDN 是否返回鉴权成功还是鉴权失败。

注意：

  * 这一步隐含了一个设置，当设置超时后为鉴权通过时，非鉴权失败的状态码（请参考第5步）都是判定为成功；
  * 反之，设置超时为鉴权失败时，非鉴权成功的状态码（请参考第5步）都是判定为失败。

## 9\. 设置鉴权结果缓存

可以设置鉴权结果是否缓存以及缓存时长，并且支持选择针对“全部结果”或“鉴权成功”或“鉴权失败”进行缓存。

# 三. CDN 发起怎样的鉴权请求

设置回源鉴权后，终端用户每次请求 CDN 边缘节点都会触发回源鉴权请求，该请求是 CDN 边缘节点直接访问用户设置的鉴权服务器。例如：

鉴权配置：

  * 鉴权地址：`http://www.userauth.com/auth`
  * 鉴权方法：POST
  * 鉴权参数：key1

终端用户请求：

    
    
    GET http://www.example.com/a.txt?key1=test1&key2=test2 HTTP/1.1 
    Accept-Language:zh-cn
    Connection:Keep-Alive
    Host:www.example.com
    User-Agent:Mozila/4.0(compatible;MSIE5.01;Window NT5.0)
    Accept-Encoding:gzip,deflate
    

鉴权请求：

    
    
    POST http://www.userauth.com/auth?key1=test1 
    Accept-Language:zh-cn
    Connection:Keep-Alive
    Host:www.example.com
    User-Agent:Mozila/4.0(compatible;MSIE5.01;Window NT5.0)
    Accept-Encoding:gzip,deflate
    

以上内容是否对您有帮助？
human: 如何处理七牛云的CDNIP黑白名单

gpt: [CDN](https://developer.qiniu.com/fusion) > 快速入门 > IP黑白名单

#  IP黑白名单

最近更新时间: 2023-02-15 16:00:56

为了解决恶意 IP 盗刷、攻击等问题，七牛云CDN提供了IP黑白名单配置功能，您可以登录**七牛开发者平台** 选择**CDN**
控制台，进行IP黑白名单配置。  
  

# 操作说明

登录**七牛开发者平台** 后，进入**CDN控制台** ，选择【域名管理】，点击【配置】：

![域名列表](https://dn-odum9helk.qbox.me/Fr29HEF4Y0J1NHYmOWW1SkjcyUFD)

进入域名配置界面，**访问控制** 模块下的**IP黑白名单** 点击【修改配置】进行IP黑白名单配置。

![](https://dn-odum9helk.qbox.me/FshVHFZOpVoOX2oRkt5fXofAAUgT)

### IP黑白名单配置

IP黑白名单配置默认为关闭状态，开启后可以根据需要选择配置IP的黑白名单。

  * IP白名单：当发起请求的客户端的IP匹配列表中的IP或IP段时，访问能够正常返回所请求的内容，其他请求均直接返回403。

  * IP黑名单：当发起请求的客户端的IP匹配列表中的 IP或IP段时，访问直接返回403，其他访问能够正常返回所请求内容。

![WX20230215-153428@2x-cdn ip黑白名单.png](https://dn-
odum9helk.qbox.me/FsKrg_Ex-8_gdeG-9oXDNoE_YDvj)

**注意事项**

（1）支持输入多个IP或网段，每行为一个IP或网段，最多可添加500条IP或网段记录；

（2）支持IPv4和IPv6黑白名单，支持IPv4 网段，但不支持IPv6网段。

以上内容是否对您有帮助？
human: 如何处理七牛云的CDNHTTPS配置

gpt: [CDN](https://developer.qiniu.com/fusion) > 使用指南 > 配置管理 >HTTPS配置

#  HTTPS配置

最近更新时间: 2020-02-14 16:34:03

HTTPS 是指超文本传输安全协议（Hypertext Transfer Protocol Secure，缩写：HTTPS，常称为HTTP over
TLS，HTTP over SSL或HTTP
Secure）是一种通过计算机网络进行安全通信的传输协议。HTTPS经由HTTP进行通信，但利用SSL/TLS来加密数据包。HTTPS开发的主要目的，是提供对网站服务器的身份认证，保护交换数据的隐私与完整性。配置
HTTPS 时，需要您提供域名对应的证书，实现全网数据加密传输功能。您可以登录**七牛开发者平台** 选择**CDN控制台** ，进行HTTPS的配置。  
  

# 操作说明

登录**七牛开发者平台** 后，进入**CDN控制台** ，选择【域名管理】，点击【配置】：

![域名列表](https://dn-odum9helk.qbox.me/Fr29HEF4Y0J1NHYmOWW1SkjcyUFD)

进入域名配置界面，**HTTPS配置** 模块下点击【修改配置】进行配置。

![](https://dn-odum9helk.qbox.me/FqnHI1qK0BO6bl4w7FKMJdP1rFxq)

### 开启 HTTPS

如需启用**HTTPS服务** 时，选择【HTTPS】即可，开启后需要选择对应的证书。

![](https://dn-odum9helk.qbox.me/Fk8zZ1wNJxjQhCTmXfYkIgAsMhpk)

### 更换证书

  * 如已经完成了证书的上传，选择对应的证书即可

![](https://dn-odum9helk.qbox.me/FmdMOSC0xSB0IJ9b2mEciT2X0W8w)

**注：证书筛选框只显示对应域名可用的所有证书，证书剩余有效期必须大于7天。**

  * 如未上传证书或此域名当前无可用证书，点击【七牛云证书服务】进入SSL证书服务控制台进行自有证书上传或购买证书操作。

![](https://dn-odum9helk.qbox.me/Fugsvs3Bpfie3nM0ofwZHYXhpYqi)

### 强制HTTPS

如果您的加速域名开启了HTTPS配置，您可以设置**强制HTTPS** ，开启后即使用户发起 HTTP 请求，也会强制跳转为 HTTPS
请求进行访问。此项默认为关闭状态，此时同时支持HTTP和HTTPS方式的请求。

![](https://dn-odum9helk.qbox.me/FigrkqkzoTdfDqXecknDtxsJaTFK)

### 开启HTTP/2

如果您的加速域名开启了HTTPS配置，您可以设置**开启HTTP/2**
，HTTP/2可以兼容HTTP/1.1的访问，优化网络延迟，提升网络速度，优化用户的网络使用体验。目前，Chrome、 Firefox、Safari
等主流浏览器已经支持 HTTP/2协议。  
![](https://dn-odum9helk.qbox.me/FjUJIn5N1Z3lo8SbGwN6y7oqeEVh)

以上内容是否对您有帮助？
human: 如何处理七牛云的CDNHTTP响应头配置

gpt: [CDN](https://developer.qiniu.com/fusion) > 使用指南 > 配置管理 >HTTP响应头配置

#  HTTP响应头配置

最近更新时间: 2020-04-30 16:25:35

HTTP 消息头是指，在超文本传输协议（ Hypertext Transfer Protocol，HTTP）的请求和响应消息中，协议头部的组件。在 HTTP
消息头中，按其出现的上下文环境，分为通用头、请求头、响应头等。

其中 HTTP
响应头向客户端提供一些额外信息，比如谁在发送响应、响应者的功能，甚至与响应相关的一些特殊指令。这些头部有助于客户端处理响应，并在将来发起更好的请求。

当您的网站接入 CDN 后，由于客户端和源站会根据 HTTP 响应头的字段信息进行相关的行为处理，所以会有修改 HTTP 响应头的需求。由于 HTTP
响应头配置是针对域名，因此一旦配置生效，对该域名下任意一个资源的响应消息中均会加入所配置头部。配置 HTTP
响应头仅影响客户端（如浏览器）的响应行为，不会影响到 CDN 节点的缓存行为。

# 操作说明

您可以登录七牛开发者平台，并进入[**CDN控制台**](https://portal.qiniu.com/cdn/overview)，选择【域名管理】，点击【配置】：  
![](https://dn-odum9helk.qbox.me/FhtdBshHxCNPzpM66rBQVZTDEyBd)  
进入域名配置界面，点击【添加配置】可添加一条 HTTP 响应头的配置记录。  
![](https://dn-odum9helk.qbox.me/FtOpxWkWpl8fioTaI_6zLUF9aWjh)  
  
  
请根据实际情况选择 HTTP 响应头、响应头操作并配置相应的值。  
目前七牛云CDN提供11个 HTTP 响应头参数可供您自定义取值，解释如下表所示。 如果您有其他 HTTP
头设置需求，请[提交工单](https://support.qiniu.com/tickets/new/form?category=%E9%85%8D%E7%BD%AE%E9%97%AE%E9%A2%98&space=CDN)处理。  
![](https://dn-odum9helk.qbox.me/FqP-6AhYQAwkvgs3aJ9_PJzHe1Yo)

HTTP 响应头 | 描述 | 示例  
---|---|---  
Access-control-allow-origin | 指定允许的跨域请求的来源。 | * （*表示全部域名；也可填写完整域名，例如 <http://www.qiniu.com> 、http://*.qiniu.com )  
Access-Control-Allow-Headers | 指定允许的跨域请求的字段。 | X-Custom-Header  
Access-Control-Allow-Methods | 指定允许的跨域请求方法。 | POST,GET,OPTIONS  
Content-Type | 指定客户端程序响应对象的内容类型。 | Content-Type  
Cache-Control | 指定客户端程序请求和响应遵循的缓存机制。 | no-cache,no-store  
Content-Disposition | 指定客户端程序把请求所得的内容存为一个文件时提供的默认的文件名。 | attachment; filename="filename.jpg"  
Content-Language | 指定客户端程序响应对象的语言。 | zh-CN,en-US  
Expires | 指定客户端程序响应对象的过期时间。 | Wed, 21 Oct 2015 07:28:00 GMT  
Access-Control-Max-Age | 指定跨域请求时，对特定资源的预请求返回结果的缓存时间。 | 600（单位为秒，600表示10分钟）  
Access-Control-Expose-Headers | 指定允许访问的自定义头信息。 | Content-Length（可以输入多个头部时，需用 “,” 隔开。）  
Access-Control-Allow-Credentials | 指定是否允许跨域请求携带验证信息，验证信息可以是cookies。 | true  
      
    
    注：跨域是指某一个域名，如 www.aaa.com 下的某资源，向另一个域名 www.bbb.com 下的某资源发起请求，此时由于资源所属域名不同，即出现 跨域，不同的协议、不同的端口均会造成跨域访问的出现。此时必须在 Response Header 中增加跨域相关配置，才能让前者成功拿到数据。
    

在 HTTP 响应头列表中，您可以单击【修改配置】或【删除】，对当前配置的 HTTP 响应头进行相应操作。  
![](https://dn-odum9helk.qbox.me/FiILmmBDhCQvpUGeNRyotvQLpTRT)

以上内容是否对您有帮助？