jancd/qiniu-developer-faq huggingface dataset:
#  流量异常情况的原因和处理方法

最近更新时间: 2020-02-14 16:56:41

Q1:流量突增、流量明显高于正常业务量，应该如何处理？  
---  
1.可以 [下载日志](https://portal.qiniu.com/domain/clog) 进行
[统计分析](https://developer.qiniu.com/kodo/kb/1451/how-to-own-space-ip-access-
number)。  
2.可以针对CDN域名，在 [告警配置](https://developer.qiniu.com/fusion/kb/4059) 开启配置
告警，当使用量超过您设置的告警值会进行通知。  
3.如果通过分析，得出流量确实产生于被盗刷或者是被攻击，可以在域名 “防盗链配置” 中，配置防盗链。  
  
  

Q2:域名被攻击，为何停用或者删除了域名后，依然还有流量？  
---  
当域名仍然解析到七牛，七牛对于攻击的请求会给出非 200 的响应，这种响应有通信头的流量的消耗，当攻击频次巨大时，会产生计费的流量。  
当域名是自定义域名，建议调整解析到 1.1.1.1。若调整解析为空，攻击者可能更换攻击方式，绑定 host 攻击。  
当域名是七牛提供的域名，需要提交工单联系七牛调整域名解析。  
  
  

Q3:为什么使用http下载消耗的却是https流量？  
---  
域名如果开通了 https，那么统一按照 https 收费。  
如果有些请求使用 http，可以新增一个专门用来 http 访问的域名。  
  
  

Q4:为什么资源删除后依然会产生流量？  
---  
这个是资源在访问后，会在cdn中生成缓存，下次访问的时候直接会从cdn中加载资源，而不用回源到源站去加载资源，有效缩短加载时间，这个本身就是cdn的优势所在。所以文件删除后需要调用刷新接口去删除cdn的缓存，这样才能保证文件删除后无法继续访问。如何刷新缓存：1.
通过api 接口刷新：<https://developer.qiniu.com/fusion/api/1229/cache-refresh> 2\.
通过portal.qiniu.com 控制台刷新缓存，点击左侧cdn => 刷新预取  
  
以上内容是否对您有帮助？

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  下载问题 FAQ

最近更新时间: 2020-12-11 09:55:09

Q1：下载失败，响应非 200 状态码，我应该怎么处理？  
---  
参考文档：[通过 http
状态码，判断下载失败原因](https://developer.qiniu.com/fusion/kb/3885/through-the-http-
status-code-download-failure-reason)  
  
  

Q2：怎样实现视频链接只能播放，不能下载？  
---  
播放其实就是一种形式的下载，所以只能播放不能下载是实现不了的，但我们可以用一些方式去避免别人下载：  
方法 1 ：可以开启域名 [时间戳防盗链](https://developer.qiniu.com/fusion/kb/1670/timestamp-
hotlinking-prevention) ，使得视频链接只在一段时间内可以访问。  
方法 2 ：用网页播放器播放视频，可以隐藏掉播放链接。虽然链接可以通过抓包获得，但是此方法可以屏蔽掉大部分的小白用户。  
  
  

Q3：如何打包下载多个文件？  
---  
无法通过一次请求，下载多个文件，但是可以用
[mkzip](https://developer.qiniu.com/dora/manual/1667/mkzip)
命令，在云端将多个文件打包，然后直接下载该 zip 文件。  
  
  

Q4：下载速度太慢，如何解决？  
---  
下载速度慢一般有以下几种情况：  
1.使用七牛测试域名。七牛的测试域名有单 IP 访问次数和带宽的限制，更换自定义的 CDN
加速域名，可以解决。[观看视频教程](http://songfeifeids.qiniuts.com/spjc/3.mp4)。  
2.用户本地的 DNS 设置有问题，跟本地出口 IP 不属同省同运营商，可以用
[这个页面](http://tools.cloudxns.net/Index/Diag) 检测，并根据检测结果修改 DNS。  
3.创建域名时使用场景选择有误，比如将网页平台的域名用作视频点播。这种情况需要给七牛提交工单，修改域名使用场景。  
4.客户网络下行带宽较差，可以参考 [网络测试](https://developer.qiniu.com/fusion/kb/1324/mobile-
terminal-network-test-tool-android-ios) 检查客户网络情况。  
5.如果确认客户网络正常，主要是未击中CDN缓存的资源加载慢，可以对相关资源做下
【文件预取】（[控制台预取文件](https://developer.qiniu.com/fusion/manual/3845/refresh-the-
prefetch-fusion)，[文件预取API](https://developer.qiniu.com/fusion/api/1227/file-
prefetching))
操作；同时针对不同类型的文件设置核实的[缓存策略](https://developer.qiniu.com/fusion/manual/4944/cache-
configuration)。  
  
  

Q5：上传前文件的大小和下载的文件大小不一致是什么原因？  
---  
首先 [刷新 CDN 缓存](https://developer.qiniu.com/fusion/kb/1325/refresh-the-cache-
and-the-effect-of-time) ，刷新 10 分钟后，可通过 [检查文件
md5](https://developer.qiniu.com/fusion/kb/3644/refresh-the-cache-fails-
consistency-method-validation-file) 的方式，来看文件和原文件是否一致。  
  
  

Q6：为什么浏览器访问文件不是预览，而是直接下载？  
---  
浏览器会判断文件是否是自己支持预览的格式，如果文件直接下载，说明该浏览器不支持该文件格式。比如 webp 格式的图片，只有 chrome
浏览器支持，其他浏览器不支持。  
  
  

Q7：如何实现数据迁移？  
---  
同一账号、不同区域的数据迁移，可以通过
[跨区域同步功能迁移数据](https://developer.qiniu.com/kodo/manual/1700/cross-regional-
synchronization) 操作。  
其他情况，可以使用 [qshell](https://developer.qiniu.com/kodo/tools/1302/qshell) 工具。先用
qdownload 命令批量下载到本地，再用 qupload 批量上传到另一空间。  
  
  

Q8：如何禁止访问某个文件？  
---  
如果文件是存储在【七牛存储空间】的，您可以调用
[修改文件状态](https://developer.qiniu.com/kodo/api/4173/modify-the-file-status)
接口将对应文件禁用来实现。  
**注意：**  
文件状态禁用后，如需全网生效，需要刷新下CDN缓存（[七牛控制台刷新CDN缓存](https://developer.qiniu.com/fusion/manual/3845/refresh-
the-prefetch-
fusion)，[调用API接口刷新CDN缓存](https://developer.qiniu.com/fusion/api/1229/cache-
refresh)）。  
  
以上内容是否对您有帮助？

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  SSL 证书 FAQ

最近更新时间: 2019-07-15 17:28:54

Q1: 为什么我无法上传自有证书或证书上传后不可用？  
---  
证书有效期需要≥30天，少于30天的证书是不能用于七牛 CDN 的。  
  
  

Q2: 我申请了七牛的 SSL 证书，为何申请 SSL 证书一直待确认,有时候需要好几天？  
---  
在证书订单页面，点击订单最后的 “详情” ，确定验证流程是否配置完成。  
当选择 DNS 验证方式，域名除 TXT 记录外，还有 A 记录、cname 记录等记录类型，验证是不会通过的。这种情况需要重新提交订单，选择文件验证方式。  
  
  

Q3: 因为解析冲突，我不能选择 DNS 验证方式；因为服务器不支持 .well-known 这种目录，文件验证不能通过，我如何通过验证呢？  
---  
参考文档：[域名已经解析如何通过验证](https://developer.qiniu.com/ssl/kb/3890/domain-name-
already-how-do-parsing-by-verifying)  
文档中的第一种方法，可以解决两种情况同时存在的问题。  
  
  

Q4: 为什么申请 SSL 证书失败呢？  
---  
CA 中心验证的过程是完全黑盒的，具体失败原因无法得知。从经验看，原因有以下几种可能性：  
1\. 网站所有人与证书申请人姓名不同。  
2\. 域名中含有 “非法” 字符，比如域名中不能有 test 。  
3\. 域名涉及非法信息 / 被举报 / 被 CA 中心添加黑名单。  
  
  

Q5: 为什么申请 SSL 免费证书配置时间很长？  
---  
通常情况下证书会在配置在 30 分钟内颁发并完成配置，期间域名访问不受影响，部分配置不可修改。但证书颁发受 CA
中心的影响，证书颁发时间不可控，若较长时间仍未配置完成，请提交工单咨询。  
  
以上内容是否对您有帮助？

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  常见问题 - CDN 回源配置相关问题

最近更新时间: 2020-04-24 17:43:59

# 简介

CDN 加速支持指定不同的回源方式对源站进行加速，本文列出了部分关于 CDN 回源配置您可能需要了解的问题。

Q：回源示意图  
Q：回源流程说明  
Q：什么是回源 HOST ？  
Q：回源 HOST 和源站域名有什么区别？  
Q：如何填写测试资源？  
Q：对网站 http://www.a.com/ 加速，回源配置应该如何填写？  
Q：为什么加速域名和源站域名不能相同？

  
如果本文仍然无法解决您的问题，您也可以通过 **[工单系统](https://support.qiniu.com/tickets/new)**
将您的问题反馈给我们。

* * *

# Q：回源示意图

![image](https://dn-odum9helk.qbox.me/Fr7B98mKHHsq_5cV-itCjUgJ4K8x)

# Q：回源流程说明

## 1\. 指定七牛云存储为源站

CDN 回源时，将根据您配置的源站存储空间名称，回源到存储机房对应空间中。

## 2\. 指定源站域名回源

CDN 回源时，先根据源站域名解析得到一个源站 IP ,然后向该 IP 发起请求，通过配置的回源 HOST 确定，需要访问该源站服务器上的哪一个站点。

例如： 源站域名为 `www.a.com` ，回源 HOST 为 `www.b.com` 。

  * 回源时，先解析到 `www.a.com` 解析到的 IP, 并向该 IP 发起回源请求，请求时 HTTP 数据包的 HOST 头部值为您配置的回源 HOST `www.b.com` ，代表访问源站服务器上的站点 `www.b.com` 。

## 3\. 指定IP地址回源

CDN 回源时，向该 源站IP 发起请求，通过配置的回源 HOST 确定，需要访问该源站服务器上的哪一个站点。

例如： 源站 IP 为 1.1.1.1 ，回源 HOST 为 `www.b.com` 。

  * 回源时，请求的是 1.1.1.1 对应的源站服务器上的站点 `www.b.com` 。

# Q：什么是 回源 HOST ？

参考 回源示意图，当服务器源站存在多个不同站点时，CDN 将根据您的回源 HOST 域名，决定 CDN 将从哪一个站点中获取资源。

# Q：回源 HOST 和源站域名有什么区别？

参考 回源示意图，源站域名将会通过 DNS 解析，获取到源站的 IP，解析后的回源流程和 IP 回源方式没有区别。

  * 源站域名：只决定回源的 IP ，不决定访问时的具体站点。
  * 回源 HOST ：决定了访问到该 IP 上的具体站点名称。

# Q：如何填写测试资源？

测试资源代表在您源站服务器上，回源 HOST 对应的站点中，一个可供访问的资源，将用于 CDN 在部分场景下的全链路访问性监测。

# Q：对网站 `http://www.a.com` 加速，回源配置应该如何填写？

  * 如果源站服务器 IP 固定，您可以使用IP地址回源，回源 HOST 填写 `www.a.com` 即可。
  * 如果源站服务器 IP 需要通过域名解析动态获取，您可以使用源站域名回源，回源 HOST 填写 `www.a.com` 即可。

**`注意：`** 如果需要加速的域名为 HTTPS 域名，且源站强制 HTTP 访问时重定向到 HTTPS，您需要配置加速域名和回源协议为
HTTPS，或者关闭源站的重定向跳转。

# Q：为什么加速域名和源站域名不能相同？

一个域名最终只解析到一个位置，即解析到 CDN 加速节点后，将无法用于获取源站的 IP 信息，所以加速域名和源站域名无法配置为同一个域名。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  HTTP状态码大全

最近更新时间: 2017-08-21 10:23:15

# 标准扩展码

## 1xx Informational 信息化

100 Continue 继续

101 Switching Protocols 交换协议

102 Processing 处理

## 2xx Success 成功

200 OK

201 Created 创建

202 Accepted 已接受

203 Non-Authoritative Information 非授权信息

204 No Content 无内容

205 Reset Content 重置内容

206 Partial Content 部分内容

207 Multi-Status 多状态

208 Already Reported 已报告

226 IMIM Used 使用的

## 3xx Redirection 重定向

300 Multiple Choices 多种选择

301 Moved Permanently 永久移动

302 Found 发现

303 See Other 查看其它

304 Not Modified 未修改

305 Use Proxy 使用代理

306 Switch Proxy 开关代理

307 Temporary Redirect 临时重定向

308 Permanent Redirect 永久重定向

## 4xx Client Error 客户端错误

400 Bad Request 错误的请求

401 Unauthorized 未授权

402 Payment Required 需要付费

403Forbidden 拒绝访问

404 Not Found 未找到

405 Method Not Allowed 不允许的方法

406 Not Acceptable 不可接受

407 Proxy Authentication Required 代理服务器需要身份验证

408 Request Timeout 请求超时

409 Conflict 冲突

410 Gone 完成

411 Length Required 需要长度

412 Precondition Failed 前提条件失败

413 Payload Too Large 负载过大

414 URI Too Long 太长

415 Unsupported Media Type 不支持的媒体类型

416 Range Not Satisfiable 的范围不合适

417 Expectation Failed 预期失败

418 I'm a teapot 我是一个茶壶

421 Misdirected Request 误导请求

422 Unprocessable Entity 无法处理的实体

423 Locked 锁定

424 Failed Dependency 失败的依赖

426 Upgrade Required 升级所需

428 Precondition Required 所需的先决条件

429 Too Many Requests 太多的请求

431 Request Header Fields Too Large 请求头字段太大

451 Unavailable For Legal Reasons 不可出于法律原因

**5xx Server Error 服务器错误**

500 Internal Server Error 内部服务器错误

501 Not Implemented 未执行

502 Bad Gateway 错误的网关

503 Service Unavailable 服务不可用

504 Gateway Timeout 网关超时

505 HTTP Version Not Supported 不支持HTTP版本

506 Variant Also Negotiates 变体也进行协商

507 Insufficient Storage 存储空间不足

508 Loop Detected 检测到循环

510 Not Extended 不延长

511 Network Authentication Required 网络需要身份验证

# **非官方扩展码**

103 Checkpoint 检查点

420 Method Failure (Spring Framework) 故障的方法（Spring框架）

420 Enhance Your Calm (Twitter) 增强您的平静（微博）

450 Blocked by Windows Parental Controls (Microsoft) 被Windows阻止家长控制（微软）

498 Invalid Token (Esri) 无效的令牌（ESRI的）

499 Token Required (Esri) 令牌必需（ESRI的）

499 Request has been forbidden by antivirus 请求已被禁止反病毒

509 Bandwidth Limit Exceeded (Apache Web Server/cPanel)
超出带宽限制（Apache的Web服务器/的cPanel）

530 Site is frozen 网站被冻结

# **互联网信息服务扩展状态码**

440 Login Timeout 登录超时

449 Retry With 重新发送带

451 Redirect 重定向

# **NGINX 扩展状态码**

444 No Response 没有响应

495 SSL Certificate Error 证书错误

496 SSL Certificate Required证书要求

497 HTTP Request Sent to HTTPS Port 发送到HTTPS端口请求

499 Client Closed Request 客户端请求关闭

以上内容参考维基百科：<https://en.wikipedia.org/wiki/List_of_HTTP_status_codes>

# **七牛扩展状态码**

298 部分操作执行成功。

419 用户账号被冻结。

478 镜像回源失败。 主要指镜像源服务器出现异常。

573 单个资源访问频率过高

579 上传成功但是回调失败。 包括业务服务器异常；七牛服务器异常；服务器间网络异常。

599 服务端操作失败。

608 资源内容被修改。

612 指定资源不存在或已被删除。

614 目标资源已存在。

630 已创建的空间数量达到上限，无法创建新空间。

631 指定空间不存在。

640 调用列举资源 (list) 接口时，指定非法的marker参数。

701 在断点续上传过程中，后续上传接收地址不正确或ctx信息已过期。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  什么是防盗链设置中的空 Referer

最近更新时间: 2018-01-02 16:03:30

# 什么是 Referer？

这里的 Referer 指的是 HTTP 头部的一个字段，也称为 HTTP 来源地址（HTTP
Referer），用来表示从哪儿链接到目前的网页，采用的格式是 URL。换句话说，借着 HTTP Referer
头部网页可以检查访客从哪里而来，这也常被用来对付伪造的跨网站请求。

Referer 的正确英语拼法是 referrer。由于早期 HTTP
规范的拼写错误，为了保持向后兼容就将错就错了。其它网络技术的规范企图修正此问题，使用正确拼法，所以目前拼法不统一。

比如，您如果点击下面资料来源后面维基百科的网址链接，那么浏览器会产生一个送到维基百科的 Web 服务器的 HTTP 请求，该请求中则会包含一个
Referer 字段（即本页面的地址）

资料来源：[http://zh.wikipedia.org/wiki/HTTP
](http://zh.wikipedia.org/wiki/HTTP%E5%8F%82%E7%85%A7%E4%BD%8D%E5%9D%80)

# 什么是空 Referer，什么时候会出现空 Referer？

首先，我们对空 Referer 的定义为，Referer 头部的内容为空，或者，一个 HTTP 请求中根本不包含 Referer 头部。

那么什么时候 HTTP 请求会不包含 Referer 字段呢？根据 Referer
的定义，它的作用是指示一个请求是从哪里链接过来，那么当一个请求并不是由链接触发产生的，那么自然也就不需要指定这个请求的链接来源。

比如，直接在浏览器的地址栏中输入一个资源的 URL 地址，那么这种请求是不会包含 Referer 字段的，因为这是一个 “凭空产生” 的 HTTP
请求，并不是从一个地方链接过去的。

# 那么在防盗链设置中，允许空 Referer 和不允许空 Referer 有什么区别？

在防盗链的白名单设置中，如果指名白名单中包含空的 Referer，那么通过浏览器地址栏直接访问该资源 URL 是可以访问到的；

但如果不指名需要包含空的 Referer，那么通过浏览器直接访问也是被禁止的。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  HTTP 请求返回状态码

最近更新时间: 2019-03-25 19:49:00

HTTP 状态码 | 说明  
---|---  
200 | 操作执行成功。  
298 | 部分操作执行成功。  
400 | 请求报文格式错误。包括上传时，上传表单格式错误；URL 触发图片处理时，处理参数错误；[资源管理][rsHref] 或 [持久化数据处理 (pfop)](http://developer.qiniu.com/article/developer/persistent-fop.html#pfop-existing-resource) 操作请求格式错误。  
401 | 认证授权失败。 包括密钥信息不正确；数字签名错误；授权已超时。  
403 | token中的key和put方法的key不一致;mimelimit类型限制;fsizelimit大小限制  
404 | 资源不存在。 包括空间资源不存在；镜像源资源不存在。  
405 | 请求方式错误。 主要指非预期的请求方式。  
406 | 上传的数据 CRC32 校验错误。  
419 | 用户账号被冻结。  
478 | 镜像回源失败。 主要指镜像源服务器出现异常。  
503 | 服务端不可用。  
504 | 服务端操作超时。  
573 | 单个资源访问频率过高  
579 | 上传成功但是回调失败。 包括业务服务器异常；七牛服务器异常；服务器间网络异常。  
599 | 服务端操作失败。  
608 | 资源内容被修改。  
612 | 指定资源不存在或已被删除。  
614 | 目标资源已存在。  
630 | 已创建的空间数量达到上限，无法创建新空间。  
631 | 指定空间不存在。  
640 | 调用[列举资源 (list)](http://developer.qiniu.com/code/v6/api/kodo-api/rs/list.html) 接口时，指定非法的`marker`参数。  
701 | 在断点续上传过程中，后续上传接收地址不正确或`ctx`信息已过期。  
  
以上内容是否对您有帮助？

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  如何申请并使用免费证书

最近更新时间: 2024-05-20 10:45:49

## 如何申请并使用免费证书

  * 本文档介绍如何申请并使用七牛免费证书，主要步骤有：

    * 1.证书申请
    * 2.免费证书使用 
      * 2.1创建https加速域名时使用
      * 2.2http升级为https时使用
  * 免费证书使用说明: 提供下载，在我的证书处下载

### 申请七牛免费证书

  * 1.登录七牛控制台，选择 SSL 证书服务，购买证书

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

  * 2.选择 TrustAsia 免费证书

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

  * 3.点击「核对信息并支付」，补全域名信息

![image.png](https://dn-odum9helk.qbox.me/Fn3jhLq4XrTZr0wtlrvs1ucAAX5r)  
![image.png](https://dn-odum9helk.qbox.me/FjD5rrqZGs6-7XSXhi98nO7N-IF3)

  * 4.选择验证方式，如果域名托管商 CNAME 解析和 TXT 有冲突，请选择文件验证

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

  * 5.查看证书详情，根据选择的验证方式进行验证

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

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

  * 6.1 **选择dns验证** 需要到域名服务商 进行 cname 解析

![](https://dn-odum9helk.qbox.me/4A0C3418-9116-41D6-A2C6-6EFA0C693918.png)

  * 6.2 使用dig命令查看TXT解析

![](https://dn-odum9helk.qbox.me/5FB9C228-C3C6-498B-807D-DF01AC570E5F.png)

  * 7.1 **选择文件验证** 需要到 xuzhuo.support2technical.me 对应站点下上传文本文件，文件名为 `.well-known/pki-validation/fileauth.txt`， 文本文件内容为：`2018082806105747stl44uj6z707i7iqsv3b42v4cqkc1v86k4d7ujonr85yfvn7`

    
    
    已绑定域名 xuzhuo.support2technical.me（通用名称)
    域名所有权验证
    验证类型：FILE
    验证文件路径：/.well-known/pki-validation/fileauth.txt
    验证文件值：2018082806105747stl44uj6z707i7iqsv3b42v4cqkc1v86k4d7ujonr85yfvn7
    
    

![](https://dn-odum9helk.qbox.me/64B6CEB6-A6AE-4CA2-90E1-53ABF6FDF811.png)

  * 7.2 文件验证校验, 访问 `http://xuzhuo.support2technical.me/.well-known/pki-validation/fileauth.txt`， 返回文本值为：`2018082806105747stl44uj6z707i7iqsv3b42v4cqkc1v86k4d7ujonr85yfvn7`

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

  * 8.**注意：如果DNS验证中的 txt记录 与 cname记录 冲突导致无法验证成功的话，请重新申请订单更换为文件验证的方式**

  * 9.查看证书验证状态，当订单状态为已签发时，可以到我的证书处查看证书

![](https://dn-odum9helk.qbox.me/D2DFBCE8-0F2E-4304-A246-F9852637A50A.png)

### 使用免费证书

  * 1.创建加速域名时选择对应的证书

![](https://dn-odum9helk.qbox.me/E12F6A56-773A-4F75-94D7-970D89178069.png)

  * 2.已经创建的域名，升级https时选择对应的证书

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

![](https://dn-odum9helk.qbox.me/FrXEQetxxOlZ8BJGRGxHCjnlCUJx)
注：修改域名的https配置时，如果下拉框中没有可绑定的证书，请检查证书包含的域名和需要绑定的域名是否完全一致。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  CDN 缓存规则设置

最近更新时间: 2020-02-14 16:59:11

# 一、背景介绍

  1. 七牛提供的加速功能只针对静态文件
  2. 动态文件使用了cdn缓存后影响访问效果，如，登录界面，使用缓存后会串号

# 二、解决方法

## 场景1

自定义域名绑定在七牛空间，建议空间中只存储静态文件，采用动静分离的模式。

示例：[www.qiniu.com](http://www.qiniu.com) 的域名A记录到源站 IP 123.123.123.123，绑定自定义域名为
img.qiniu.com，然后将域名 cname 到七牛提供的域名上。使用时将 img.qiniu.com 的资源链接嵌入到代码中即可。

## 场景2

自定义域名回源到客户源站

## 示例１：在源站配置文件中设置缓存时间为 0，Nginx 为例

    
    
    server {
        listen       80;
        server_name  localhost;
        location ~* ^(.+\.php)(.*)$ {
            root     html;
            expires  -1;
            fastcgi_pass 127.0.0.1:9000;
            fastcgi_index index.php;
            fastcgi_param SCRIPT_FILENAME         $document_root$fastcgi_script_name;
            include fastcgi_params;
        }
    }
    

## 示例２：设置自定义域名的缓存时间

  * ２.1. 找到缓存设置界面  
![blob.png](https://dn-odum9helk.qbox.me/FodO7jJ6lE26hZ8FAzfGe1QycO2X)  
![blob.png](https://dn-odum9helk.qbox.me/FlvDFkozXoRUOrXeBTZIJm7n6qRC)

  * ２.２ 设置的规则和按钮  
![blog.png](https://dn-odum9helk.qbox.me/FiX66pYjeg1-xXvT0VzSjxIix5mU)

  * ２.３.添加缓存设置

  * ２.３.１ 推荐配置  
![blog.png](https://dn-odum9helk.qbox.me/FrYrW-wi0pUVx7m29pF5-tRzviNS)

  * ２.３.２ 添加后缀  
![blog.png](https://dn-odum9helk.qbox.me/FgQSXNVQu8O4SOqbq_Wq1pY0R2DW)

  * ２.３.３ 添加目录  
![blog.png](https://dn-odum9helk.qbox.me/Fo34Tv1zxoSIE2QjDpEJqN1TkEOP)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  手机端网络测试工具 (android、iOS)

最近更新时间: 2021-06-28 18:37:24

## 此教程适用场景

当用户在移动端上传/下载 慢 或 失败 时，使用以下方法可以检测出用户本地网络是否正常。

教程操作完成后，把检测结果截屏发到工单中，方便客服人员定位问题。

## 手机端带宽测试

国外测试地址：http://www.bandwidthplace.com/

测试结束后会看到上传下载带宽。检测方法：打开网页时，点击start。检测结果如下：

![blob.png](https://oi2ix6x26.qnssl.com/attachments/download/743104/001575e20e1a753a196f7c931af9246/?filename=blob.png&imageView2/1/w/500/h/750)

国内测试地址：http://www.speedtest.cn  
测试结束后会看到上传下载带宽。检测方法：打开网页时，点击测试。检测结果如下：

![speed.jpg](https://dn-
odum9helk.qbox.me/FopFZt_AUV1SoGZVDDHj7y1D71jL?filename=speed.jpg&imageView2/1/w/500/h/750)

## Android 网络测试工具

android 检测工具：[下载 __](https://dn-odum9helk.qbox.me/qiniu-detecion.apk)

  * 第一步：用户安装软件到手机，并打开手机
  * 第二步：复制域名到文本框中，点击检测

![00157b5b0903b99311d7a8e8f02a41f](https://oi2ix6x26.qnssl.com/attachments/download/969144/00157b5b0903b99311d7a8e8f02a41f/?imageView2/1/w/500/h/750)

网络测试专用版(推荐使用)：[下载 __](http://dn-odum9helk.qbox.me/qiniu-detection-
download.apk)

  * a. 下载测试，输入 url 中的域名进行测试
  * b. 上传测试，输入 upload.qiniup.com 进行测试

## IOS 端网络测试环境

> 注：在ios9中安装运行时会出提示：现需要信任这个企业及开发者才能运行该软件
>
>
> ![00157b5b044679adb2ba77099b57ceb](https://oi2ix6x26.qnssl.com/attachments/download/969140/00157b5b044679adb2ba77099b57ceb/?imageView2/1/w/500/h/750)
>
> 您需要打开系统设置》通用》描述文件》选择Shanghai Qiniu Information Technologies
> Co.Ltd.》点击中间蓝色文字信任该企业》在弹出的提示框中点击信任

  * 第一步：安装软件 [**下载** __](https://dn-devtools.qbox.me/NetDiagnoDemo-v1.1.5.html)

![00157b5b05fb0d83477b67fad8d303d](https://oi2ix6x26.qnssl.com/attachments/download/969141/00157b5b05fb0d83477b67fad8d303d/?imageView2/1/w/500/h/750)

  * 第二步：复制域名到文本框中，点击检测

![00157b5b078198a05447c88818846fe](https://oi2ix6x26.qnssl.com/attachments/download/969143/00157b5b078198a05447c88818846fe/?imageView2/1/w/500/h/750)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  CDN日志格式简介

最近更新时间: 2017-09-01 10:12:50

在 个人面板 中 点击 [CDN 日志](https://portal.qiniu.com/domain/clog) 查看。

> 日志文件默认按小时下载，如果单小时内日志过大会进行切分( **分片大小128MB** )，日志文件采用gzip压缩。
>
> 日志延迟8-10小时，举例：1月18日0点-1点的日志，会在1月18日8点-10点左右可下载。

**日志文件格式：** 域名_{yyyy-MM-dd-HH}_块.gz

    
    
    # 样例：
    www.qiniu.com_2017-03-01-00_part-00000.gz
    

**日志内容格式：**

`ClientIP Hit/Miss/UNKNOWN ResponseTime [Time Zone] "Method URL Protocol"
StatusCode TrafficSize "Referer" "UserAgent"`

说明：Hit/Miss/UNKNOWN 或占位符 “-”, UNKNOWN 为客户端主动断开链接

IP | 命中率 | 响应时间 | 请求时间 | 请求方法 | 请求URL | 请求协议 | 状态码 | 响应大小 | referer | 用户代理  
---|---|---|---|---|---|---|---|---|---|---  
ClientIP | Hit/Miss/UNKNOWN | ResponseTime(ms) | [Time Zone] | Method | URL | Protocol | StatusCode | TrafficSize(Byte) | Referer | UserAgent  
      
    
    # 样例：
    110.110.110.110 HIT 10 [19/Apr/2016:00:00:00 +0800] "GET 
    http://example.qiniu.info/in/2016/02/04/F01A9B39-45BF-AFF4-DB19-F85B9E4BD142.jpg?imageMogr2/format/png/thumbnail/480x%320E/quality/80! HTTP/1.1" 200 5136 "-" "Dalvik/1.6.0 (Linux; U; Android 4.4.4; 1105 Build/KTU84P)"
    

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  iOS抓包步骤

最近更新时间: 2018-12-29 15:11:40

## 需求：

iOS设备获取http请求或响应报文，适用于 无线 或 3/4G移动网络环境

## 软件：

Replica  
![001579af2f5128a56484e9580bb8267](https://oi2ix6x26.qnssl.com/attachments/download/891815/001579af2f5128a56484e9580bb8267/)

首次运行需添加VPN配置：  
![001579af9ba76ab0c92d2dad73f50c9](https://oi2ix6x26.qnssl.com/attachments/download/891941/001579af9ba76ab0c92d2dad73f50c9/)

## 上传抓包示例：

#### 1.打开Replica App，点击Start开始抓包（注意免费版只能记录20条）

![001579afe33bb2b716f57c8452e77e8](https://oi2ix6x26.qnssl.com/attachments/download/892104/001579afe33bb2b716f57c8452e77e8/)

#### 2.在手机浏览器或app中进行上传操作（这里以七牛js sdk demo为例：<http://jssdk.demo.qiniu.io>）：

![001579affd88a006a1b5a75fdaf96d6](https://oi2ix6x26.qnssl.com/attachments/download/892153/001579affd88a006a1b5a75fdaf96d6/)

#### 3.返回Replica ，点击Stop停止抓包-->然后点击屏幕下方Analytics按钮

此时可以看到抓包信息，点击最上面的进入本次抓包：

![001579b0121602eb88b34dc94a2d50f](https://oi2ix6x26.qnssl.com/attachments/download/892200/001579b0121602eb88b34dc94a2d50f/)

#### 4.从中找出本次上传记录,并点击进入（ **POST** 方法，域名一般是:`http://upload.qiniup.com` 或
`http://up.qiniup.com` ）

![001579b02047c1e5be45bb1a12361aa](https://oi2ix6x26.qnssl.com/attachments/download/892220/001579b02047c1e5be45bb1a12361aa/)

#### 5.可以得到以下信息：

**Overview标签可以得到远程ip信息：**

![001579b07c88e67f79eefb3705c8ab6](https://oi2ix6x26.qnssl.com/attachments/download/892346/001579b07c88e67f79eefb3705c8ab6/)

**Request标签中显示请求头：**

![001579b03bf8e3cf5989388a4159863](https://oi2ix6x26.qnssl.com/attachments/download/892256/001579b03bf8e3cf5989388a4159863/)

**Response标签可以看到响应头** （可以获得reqid信息，必要的时候可以将文本复制出来发给七牛技术支持）：

![001579b04523679397b65c42d397d18](https://oi2ix6x26.qnssl.com/attachments/download/892275/001579b04523679397b65c42d397d18/)

## 其他

如果是下载或播放视频抓包的话，方式类似。先打开Replica开始抓包，然后访问资源，点击停止后进入分析界面，提供相关信息即可。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  源站更新源cdn如何同步

最近更新时间: 2020-02-14 16:57:52

# 情景一 cdn的源站是七牛的情况下

模式是这样的

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

![](https://dn-odum9helk.qbox.me/FhJZUDN-12nhtzVPxakrA9-2TP_y)

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

  * 首先 资源的读取的情况是这样的 客户端访问时候先从 cdn 拉取资源 如果 cdn 存在缓存那么资源直接从 cdn 返回给客户端 
  * 其次 客户端从 cdn 没有拉到资源那么就会从七牛的存储空间拉取资源
  * 最后 如果七牛空间和 cdn 都不存在资源那么 客户端就会从客户的源站拉取资源

这个是源站回源到七牛情况，所以客户源站资源的更新需要先把七牛空间的资源
[删除<https://portal.qiniu.com/bucket/apple/resource>) 再刷新下[ cdn
缓存](https://portal.qiniu.com/domain/refresh) 这样客户端访问才会直接打回到客户的源站取最新资源。

# 情景二 cdn源站直接指向自己域名或ip

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

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

  * 首先 资源的读取的情况是这样的 客户端访问时候先从cdn 拉取资源 如果cdn存在缓存那么资源直接从cdn返回给客户端 
  * 最后 如果七牛空间和cdn 都不存在资源那么 客户端就会从客户的源站拉取资源

这个是源站回源到客户自己域名或ip，所以客户源站资源的更新 刷新下 [cdn
缓存](https://portal.qiniu.com/domain/refresh) 这样客户端访问才会直接打回到客户的源站取最新资源

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  关于www域名加速的时候与主机A记录冲突策略

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

  * 原理

空间配置图

## 原理

首先明白下 一个域名（例 ：[www.echohu.top）](http://www.echohu.top）) 若做了A 记录操作到ip
是不能在做cname的绑定到七牛  
可以使用以下策略  
[www.echohu.top这个域名请求的资源会先从你指向的七牛的空间去获取资源，当七牛的空间不存在这个资源他会从镜像源test.echohu.top获取资源](http://www.echohu.top这个域名请求的资源会先从你指向的七牛的空间去获取资源，当七牛的空间不存在这个资源他会从镜像源test.echohu.top获取资源)
而这个test.echohu.top有指向一个你的服务器ip 首先我们以echohu.top的域名为例 这是总体的图片

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

## 空间配置图

### [www.echohu.top的域名指向一个七牛空间这个七牛的空间test-
wjw](http://www.echohu.top的域名指向一个七牛空间这个七牛的空间test-wjw)

![](https://dn-odum9helk.qbox.me/FhJZUDN-12nhtzVPxakrA9-2TP_y)

### 七牛的的存储空间设置镜像源为test.echohu.top的域名

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

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  刷新缓存失败，验证文件一致性方法

最近更新时间: 2017-08-17 21:13:23

更新/删除文件后，遇到访问文件与上传的文件不一致时，需要刷新 CDN 缓存来解决。刷新方法参考：
<https://developer.qiniu.com/fusion/kb/1325/refresh-the-cache-and-the-effect-
of-time>

刷新文件后，对于已知修改部分的文本文件，可用肉眼判断文件是否刷新成功。  
对于其他文件，可以用对比文件 md5 的方法来进行验证。

  1. 对于 MacOS、Linux 操作系统，可在终端用 md5 file_name 命令计算文件 MD5 ： 

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

  2. 对于 Windows 系统，可借助第三方工具来计算 MD5 ，这里推荐一款免费、轻量的软件：Hash（MD5校验工具）

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  获取本地 IP 和 DNS 方法

最近更新时间: 2024-08-20 14:51:21

目前获取本地 IP 和 DNS 的第三方服务有多种，比较推荐的有：  
http://ping.huatuo.qq.com/

如本地设置的 DNS 服务器与本地 IP 所在地区相距较远，或者跨运营商，可能导致访问 CDN 时不能解析到相距较近的节点，影响访问效果。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  CDN 缓存配置建议

最近更新时间: 2020-02-14 16:57:59

使用场景如下建议

小文件

优先级 | 网站元素 | 路径模板 | 缓存时间 | 忽略URL参数  
---|---|---|---|---  
1 | 目录页 | /*/ | 1h | 否  
2 | 常见文本 | /*.(js|css|txt|xml) | 1d | 否  
3 | 常见文件 | /*.(shtml|html|htm) | 1h | 否  
4 | 常见图片 | /*.(jpg|jpeg|png|psd|bmp|gif|ico) | 7d | 否  
  
流媒体

优先级 | 网站元素 | 路径模板 | 缓存时间 | 忽略URL参数  
---|---|---|---|---  
1 | 媒体文件 | /*.(mp3|wav|wmv|mp4|avi|flv|rmvb|swf|aif|au|dat|rm) | 30d | 否  
2 | 媒体文件 | /*.(m3u8) | 0s | 否  
  
下载分发

优先级 | 网站元素 | 路径模板 | 缓存时间 | 忽略URL参数  
---|---|---|---|---  
1 | 下载文件 | /*.(apk|zip|rar|ipa) | 30d | 是  
  
以上内容是否对您有帮助？

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  视频教程 - 如何 CNAME

最近更新时间: 2020-02-14 16:59:19

[cname配置视频教程](https://dn-odum9helk.qbox.me/lgnLdGqZXkb5bqac09Lw_sGB2jxP)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  如何开启域名强制 https 访问？

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

登录 [七牛开发者平台](https://portal.qiniu.com/create) ，在左侧点击 [SSL 证书服务
](https://portal.qiniu.com/cdn/overview)，在域名管理中，找到需要开启强制 https 的域名，点击**配置** ：

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

下拉弹窗，找到 HTTPS 配置 ，点击**修改配置** ：

![](https://dn-odum9helk.qbox.me/FvCs62pPVFvXi3zbh3-A-n1EWxrE)

点击**开启** ：

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

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  CDN 缓存常见问题

最近更新时间: 2020-02-14 16:58:05

## 缓存刷新和文件预取有什么区别？

缓存刷新：是指通过管理控制台或者 API 接口的方式将缓存在 CDN 节点的资源文件删除或标记为过期，对于新的请求会回源站服务器获取新的文件。

文件预取：是提前将资源文件缓存在 CDN 节点，新的请求过来之后可以直接命中，无需回源服务器获取资源文件，以低源站压力，提升首次访问体验。

## 刷新缓存后要多久生效？

缓存刷新全网生效时间一般为 10 分钟。

## 使用七牛云对象存储服务，文件更新需要手动刷新吗？

需要。使用了七牛云对象存储服务时，存储资源更新（替换或删除）后，需要手动刷新触发 CDN 节点刷新缓存，否则可能会导致依然能够访问到原文件的情况。

## 发现通过七牛云 CDN 访问的资源和源站资源不一致怎么办？

通过管理控制台或 API 接口进行缓存刷新。

## 刷新预取入口：

### 管理控制台：

在七牛控制台 产品列表 中点击 CDN ，进去后可以看到刷新预取功能

### API：

<https://developer.qiniu.com/fusion/api/cache-refresh>

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  运营商劫持反馈

最近更新时间: 2019-11-06 17:16:01

# 运营商劫持投诉

首先需要确认是否被劫持了。  
劫持一般分为 DNS 劫持和内容劫持。如果遇到以下两种现象：

  1. 域名解析到七牛的 cname 地址，但是跟我们确认过，域名实际解析到的节点非七牛 CDN 节点。 
  2. 文件内容被篡改，加入了广告链接、跳转链接等。 

投诉内容格式参考：

> 有客户反馈在北京移动被劫持了，访问到的节点不是七牛云存储公司的CDN节点（或者文件被篡改）。
>
> 测试链接如下：`<这里提供劫持链接>`，麻烦帮忙解决

# 移动劫持

[移动投诉网址](http://www.10086.cn/support/selfservice/suggest/)

# 联通劫持

1、找到联通在本地的最高等级投诉热线

2、确定投诉内容，投诉时，不要向接线员描述这些细节，而要告诉他们：当我访问某个域名时，经常跳到奇怪的站点

3、收集证据，浏览器截图、录屏动画、网页源代码、Fiddler HttpWatch Wireshark等工具的抓包数据都可以作为证据。

4、拨打投诉热线，发送证据，并确认投诉的问题已经发送邮件，请检查是否收到。

# 电信劫持

[电信投诉网址](http://42.99.16.145:7080/workorder-web/189_menhu.jsp)

# 工信部投诉

如果各个运营商没有及时解决或者解决比较慢，可以在工信部进行反馈投诉

[工信部投诉网址](https://dxss.miit.gov.cn/)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  如何在浏览器中获取网络请求信息

最近更新时间: 2019-11-04 16:29:14

# 获取网络请求信息

打开谷歌浏览器调出调试窗口

操作系统 | 组合按键  
---|---  
windows | `Ctrl + shift + i`  
macOS | `option + commond + i`  
  
![blob.png](https://oi2ix6x26.qnssl.com/attachments/download/573268/00157063542529cc45018ca5010bc14/)

# 参数解释

关键字 | 名词解释  
---|---  
header | HTTP 头部信息，包含请求头和响应头  
preview | HTTP 请求响应结果的预览信息  
response | HTTP 响应信息  
  
如图：

![blob.png](https://oi2ix6x26.qnssl.com/attachments/download/611425/001571a0a540e0984e0ce6bb57d4336/)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  计费流量与日志监控流量的区别

最近更新时间: 2018-01-18 10:23:35

加速域名日志中记录的流量数据，是我们应用层日志统计出的流量，但是实际产生的网络流量却要比应用层统计到的流量要高出 **7%-15%**
；这个主要的原因有两个：

1.TCP/IP 包头的消耗：

  * a. 由于HTTP请求是基于 TCP/IP 协议的，每个包大小最大为 1500 字节，1500 字节中含有 TCP 和 IP 插进来的 40 个字节的包头。 
  * b. 当前以太网帧格式采用的是 Etherent Ⅱ 格式： 即： 前导码(8byte) | 目的 MAC(6byte) | 源 MAC(6byte) | 类型 (byte) | 数据 (46~1500byte) | FCS(4byte)，除去数据，固定开销为 26byte 
  * c. IP 包头 20byte 
  * d. TCP 包头 20byte 

因此，TCP 传输的数据分段大小为(6~1460byte)，假设网络良好，没有丢包也没有重传，则包头固定开销为 26+20+20=66byte  
计算时如果忽略 TCP 三次握手，忽略 TCP 四次挥手，按照如上计算出包头占比：[66*(日志数据量/1460)]/日志数据量 = 66/1460 =
4.52%

2.TCP 重传：  
根据互联网物理网络的负载情况，正常情况下，我们所发送的包会有 3-10%
左右会被互联网丢弃掉。被丢弃掉之后，服务器会对丢弃的部分进行重传。重传动作是由内核层协议栈处理的，应用层也无法统计到，这部分流量占我们日志计算出流量的比例，根据网络的好坏而不等。在凌晨互联网轻载的情况下，重传率会较低；在晚高峰互联网重载的时候，重传会上升；一般情况下，在
3%-7% 之间。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  资源无法访问排查步骤（PC 端，手机端）

最近更新时间: 2022-05-17 16:19:01

首先和客户拿到无法访问的报错信息，以确定排除诸如 404，403 等资源不可访问的问题

# 1 检测 dns 信息

1）ios，windows 检测 dns

dns 检测链接：

<https://ping.huatuo.qq.com/>[__](https://ping.huatuo.qq.com/)

2）linux 系统 dns 测试，输入下述命令： `curl http://1000.testns.cdnunion.net/`

3）手机端一键检测链接：

[手机端网络测试工具 (android、iOS)__](https://developer.qiniu.com/fusion/kb/1324/mobile-
terminal-network-test-tool-android-ios)

如果检测结果dns配置不正确，修改即可解决。

# 2 提供 ping 域名

如：图片 `http://7xo9nf.com2.z0.glb.qiniucdn.com/123.jpg` 无法访问

ping 域名，将结果贴过来

    
    
    ping 7xo9nf.com2.z0.glb.qiniucdn.com
    PING qiniunor.xdwscache.ourglb0.com (112.90.240.150): 56 data bytes
    64 bytes from 112.90.240.150: icmp_seq=0 ttl=49 time=52.046 ms
    ...
    
    112.90.240.150 # 这个就是我们重点需要的
    

综上：将每步的检测结果贴到工单发给我们。收到您提供的信息截图后，我们会进行检测，如果节点存在问题我们会进行调整，调整好后会及时通知您。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  为什么自定义域名的状态显示未生效?

最近更新时间: 2017-02-15 17:13:27

  1. 访问 portal.qiniu.com 查看空间设置中的域名设置，在自定义域名栏目中可查看到自定义域名的审核状态。
  2. 自定义域名的配置需要审核，当域名显示解析未生效时，请先将 cname 指向页面中提示的信息。
  3. 当域名的 cname 配置完成时，查看自定义域名的配置详情，系统将检测是否已指向 CNAME 目标，检测成功的域名显示 “使用中”。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  如何开启 Referer 防盗链

最近更新时间: 2020-02-14 16:58:08

登录 [七牛开发者平台](https://portal.qiniu.com/create) ，在左侧点击 [ CDN
](https://portal.qiniu.com/cdn/overview)，在域名管理中，找到需要开启 Referer 防盗链的域名，点击**配置**
：

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

下拉弹窗，找到 访问控制 -> Referer 防盗链，点击**修改配置** ：

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

点击**开启** ，然后配置具体的黑白名单规则：

![](https://dn-odum9helk.qbox.me/Fnu0mzKrO-s_wnp-0jVn3nb5PLRz)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  镜像存储刷新缓存方法

最近更新时间: 2018-05-10 10:13:11

当镜像源的文件更新（或删除）后，刷新 CDN 缓存的方法有以下两种：

  1. 首先将空间中该资源删除；  
然后按照 [刷新缓存的方法](https://developer.qiniu.com/fusion/kb/1325/refresh-the-cache-
and-the-effect-of-time) 文档第一条介绍的方法，提交刷新缓存请求。

  2. 首先，利用 [prefetch 接口](https://developer.qiniu.com/kodo/api/1293/prefetch) 或者 [qshell](https://developer.qiniu.com/kodo/tools/1302) 工具的 [prefetch 命令](https://github.com/qiniu/qshell/blob/master/docs/prefetch.md?ref=developer.qiniu.com) 将镜像源站的资源覆盖空间中相同名称的资源；  
然后按照 [刷新缓存的方法](https://developer.qiniu.com/fusion/kb/1325/refresh-the-cache-
and-the-effect-of-time) 文档第一条介绍的方法，提交刷新缓存请求。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  通过 http 状态码，判断下载失败原因

最近更新时间: 2017-09-29 10:10:48

如果使用浏览器访问，可以 [在浏览器中获取网络请求信息](https://developer.qiniu.com/fusion/kb/1478/how-
to-access-network-in-the-browser-request-information)

常见的集中错误如下：

错误码 | 说明  
---|---  
401 | 鉴权失败。  
· `token not specified` 表示访问时没有带 token 。如果确认访问 URL 是带了 token 的，需要核实域名是否开启了忽略
URL 参数，私有空间域名此项必须关闭。  
· `download token auth failed` 表示 token 错误，说明生成 token 的算法有问题，建议直接使用七牛的服务端 SDK
生成 token。  
· `token out of date` 表示 token 过期。  
403 | 权限不足。通常是因为域名开启了防盗链，需要确认一下防盗链规则是否跟访问请求相符。  
404 | 文件不存在。需要确认一下文件是否真的上传成功，或者是上传后执行了删除操作。  
478 | 镜像回源失败。  
通常报错是 `get image from source failed :E xxx` ，其中 xxx
是回源拉取文件时源站响应的状态码，需要以此为依据排查源站服务是否正常。  
5xx | 错误是服务端异常。  
· 域名的源站是自有源，建议优先排查源站是否对七牛回源请求给了 5xx 的响应。  
· 域名的源站是七牛存储空间，需要给七牛提交工单，提供 [CDN 节点
IP](https://developer.qiniu.com/fusion/kb/3641/get-the-cdn-node-ip-method) 。  
  
以上内容是否对您有帮助？

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  关于全站加速问题

最近更新时间: 2020-02-14 16:59:04

问题：

网站采用xxx搭建，启用七牛cdn后，登录通过 `http://www.XXX.com/admin` 无法登录后台，输入正确用户名和密码后点击登录没有反应。

  1. 没启用七牛cdn加速前的源站是没有这个问题的

  2. 系统的缓存设置是默认设置，没有做任何更改

这里说的是全站直接使用cdn加速。请问这是什么问题？

原因：

你好， 我们的cdn这边默认是静态文件加速的，所以你全站加速时会将一些动态请求也缓存住。

所以再次请求就没法到你源站了， 就登录不上去了。建议你使用插件进行加速静态文件即可。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  CDN 命中率、回源率常见问题

最近更新时间: 2019-12-09 18:33:59

# CDN 命中率如果较低的原因是什么？

  1. 源站动态资源较多，多为不可缓存的内容，也会导致频繁回源拉取。

  2. 资源访问量较低，文件热度不够，CDN 收到请求较少无法有效命中缓存。

  3. 缓存配置不合理，缓存时间过短，CDN 节点频繁回源。

  4. 访问资源的 URL 带参数，并且参数不断变化，当用不同的 URL 去访问 CDN 的时候，CDN 会认为这是一个新请求（即便这两个不同的 URL 其实是访问到了同一个文件，并且该文件已经缓存在节点上），会回源去拉取所请求的内容。

# CDN 什么情况下会回源拉取资源？

  1. 用户访问时，如节点上无缓存，则会回源拉取资源

  2. CDN 节点上的文件超时过期，会回源拉取资源

  3. 若为不缓存文件，用户访问时，会直接回源 

  4. 未忽略 URL 参数域名，使用该形式域名带参数访问资源，会直接回源

# 为什么我的回源流量比较高？

当回源率较低时，大部分资源会回源拉取，产生回源拉取流量。特别的，如果每个资源都会带随机参数或者全局缓存为0s，此时命中率接近0，回源流量大大增加。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  如何清除 Wordpress 镜像存储缓存

最近更新时间: 2017-08-22 10:59:18

###

### 问题描述：

在wordpress中用wp super cache 插件启用七牛CDN后, 对style.css进行修改, 但是七牛的缓存不更新,这要怎么解决?
相当于现在无法调整网页样式了.

### 解决方案：

启用七牛的插件之后，你的静态文件会被镜像到七牛来，但是修改过之后七牛不会重新去你的源站取，需要去 portal 后台手工删除这个 css
文件后七牛才会重新把它镜像过来。

在新版的 wordpress
插件中，已经有了清除缓存的界面了，只需将要清除缓存的文件放上去就行，插件从这里下载：<http://wordpress.org/plugins/wpjam-
qiniu/>

插件使用方法可以参考这篇文章：<http://blog.wpjam.com/project/wpjam-qiniutek/>

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  使用 curl 理解七牛请求

最近更新时间: 2018-11-21 18:52:43

使用七牛的 curl 实现表单上传

    
    
    curl -v upload.qiniup.com -F'token=JOiPUijNB0t8vbNKIufpn5gDKmg0G-uFHBlrQoV2:rmU9wAEmrSV9FxPuD0V1Z1BgzKw=:eyJzY29wZSI6Impzc2RrIiwiZGVhZGxpbmUiOjE0ODQwMzY0NTJ9' -F'file=abc'
    

注释：其中参数 `-F/--form` 模拟http表单提交数据

使用 curl 模拟七牛的刷新接口

    
    
    curl -i -X POST "http://fusion.qiniuapi.com/refresh" -H 'Content-Type: application/json' -H 'Authorization: QBox vI2xPIjOoh7udcRw4GdYNvf3o_gKsCx9wdZaC9u-:0KPRVoBiHR2c9K-t9bBr5DVDuUU=' -d '{"urls":["http://7xr0n9.com1.z0.glb.clouddn.com/3.txt.zip"]}'
    

注释：参数的 -H 其实就是 http 请求的头部 而七牛是靠这个签证头部 Authorization 来识别你的请求是否非法

-X POST 是以 post 的形式来请求 -d 就是 post 携带的数据

七牛的大部分接口其实用简单的 curl 理解起来就是 签算 Authorization 鉴权 post 请求数据

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

这个请求如果说你的已经签算好：

`Authorization QBox
vI2xPIjOoh7udcRw4GdYNvf3o_gKsCx9wdZaC9u-:0KPRVoBiHR2c9K-t9bBr5DVDuUU=`  
那么请求就如下

    
    
    curl -i -X POST "http://fusion.qiniuapi.com/v2/tune/refresh" -H 'Content-Type: application/json' -H 'Authorization: QBox vI2xPIjOoh7udcRw4GdYNvf3o_gKsCx9wdZaC9u-:0KPRVoBiHR2c9K-t9bBr5DVDuUU=' -d '{"urls":["http://7xr0n9.com1.z0.glb.clouddn.com/3.txt.zip"],"dirs":["http://7xr0n9.com1.z0.glb.clouddn.com/*"]}'
    

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  视频教程--申请ssl证书验证

最近更新时间: 2019-01-07 17:15:21

[如何申请ssl免费证书视频教程](http://dn-odum9helk.qbox.me/wjw/spjc/avthumb/ssl-
txt.mov.mp4)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  访问资源与上传资源不一致

最近更新时间: 2019-11-08 11:06:23

# 问题描述

访问的资源与上传的资源不一致

# 问题原因

## 原因一

cdn 节点缓存了相同的 url 链接，但是资源不同，比如覆盖上传文件，因为 cdn 是按照资源的 url 进行缓存，如果访问的 url
相同，那么就会命中缓存，直接返回 cdn 中的资源，而不是去源站拉取最新的资源。您可以刷新 cdn 缓存解决此问题。  
如何刷新请参考：  
<https://developer.qiniu.com/fusion/kb/1325/refresh-the-cache-and-the-effect-
of-time>

## 原因二

在确保原因一描述的情况没有问题，访问的文档与上传的资源的确不一致，或者上传之前和上传之后文件的md5值不一样，建议您在上传的时候开启 crc32
校验策略（crc32 校验请参考：<https://developer.qiniu.com/search?keyword=crc32> ）
，上传前会先计算本地文件的 crc32，然后和上传到七牛后文件的 crc32 进行对比，如果两者不同的话就不会保存，并且会返回 406：上传的数据
crc32 校验错误。通过 crc32 校验确保上传之前与上传之后的文件一致。

## 原因三

如果出现极少部分地区访问的资源不一致，比如内容被篡改，并且通过刷新 cdn 缓存的方式已无法解决此问题，这有可能是 cdn
节点或者用户的网络被劫持。可以提交工单并且提供以下信息，七牛工程师会帮您检查是否是 cdn 节点被劫持还是用户的自身网络被劫持。

需提供提供以下资源：

1：资源链接

2：ping下你的访问域名截图

3：dns 诊断截图(<http://tools.cloudxns.net/Index/Diag>)

如果是 cdn
的节点被劫持，我们会去运营商进行投诉，如果是用户自身的网络，需要用户自己去网络运营商进行投诉。运营商反馈劫持请参考：<https://developer.qiniu.com/fusion/kb/2755/operator>

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  手机抓包

最近更新时间: 2017-08-21 10:21:48

**电脑做wifi热点，手机连上后电脑上使用wireshark抓包**

**方法如下：**

1、使用电脑作为无线热点，使用的共享无线的软件可以有很多种(这里使用的是猎豹免费wifi)；

2、开启猎豹免费wifi后将手机连入，并找到对应的手机IP，这里是192.168.191.2

![blob.png](https://oi2ix6x26.qnssl.com/attachments/download/896466/001579dabd6c646409937aa9abc5572/?filename=blob.png)

![blob.png](https://oi2ix6x26.qnssl.com/attachments/download/896560/001579db56edfdcc590ca34dcc60c73/?filename=blob.png)

3、查找对应的热点的网卡。打开控制面板=》网络和Internet=》网络和共享中心，查找到无线对应的网卡，例如下图：

![blob.png](https://oi2ix6x26.qnssl.com/attachments/download/896475/001579dac6668d343aa365586f100ec/?filename=blob.png)

4、开启wireshark，找到对应的网卡并点击开始抓包

![blob.png](https://oi2ix6x26.qnssl.com/attachments/download/896546/001579db4fb1466d3b1d7b31c564554/?filename=blob.png)

5、点击捕获=》捕获过滤器，会弹出一个窗口，之后选择HTTP TCP
port(80)，这个过滤条件。或者直接在应用显示过滤器中敲入http来过滤出http协议的数据包。

![blob.png](https://oi2ix6x26.qnssl.com/attachments/download/896547/001579db50c79517ddd838456ecc2f7/?filename=blob.png)

![blob.png](https://oi2ix6x26.qnssl.com/attachments/download/896548/001579db51434686f0f072f3c37e4b3/?filename=blob.png)

6、找到您手机IP对应的HTTP包，点击Hypertext Transfer Protocol查看详细信息；
![blob.png](https://oi2ix6x26.qnssl.com/attachments/download/896552/001579db52416f00caffce231fbb733/?filename=blob.png)

7、显示详细信息后下拉，并将下图中的1和2的信息提供给我们，这边来帮您排查。

![blob.png](https://oi2ix6x26.qnssl.com/attachments/download/896554/001579db53e2e88a6be2f9c040b678a/?filename=blob.png)

8、或者将wireshark抓包信息导出提供我们，选择一个需要的导出的数据包文件，选中完成之后，进行点击菜单中的“file”的菜单，下拉中进行选择为export
specified packets的选项。

导出可以参考这个详细文档： <http://jingyan.baidu.com/article/1612d500bbafa3e20e1eee92.html>

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  判断丢包率及延时的趋势

最近更新时间: 2017-08-21 10:32:51

在使用mtr检测连通性时，如果发现中间节点丢包率很高这是正常的事情，因为骨干路由器不一定会对所有的ping包做响应。

主要是查看最后一跳的丢包情况，以及丢包率是否在某个节点之后都有大幅度上升，只要中间节点丢包率有降低就可以忽略，延时情况也是同理。

总之判断丢包率及延时的趋势时，不是只看一个节点。另外还需要判断IP所在地，看是否有绕路，以及是否有路由回环等问题。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  文件预取的意义和操作方法

最近更新时间: 2020-02-14 16:59:09

# 文件预取的意义

文件预取，也可称为预加热或预缓存，是指新资源提前由 CDN 拉取到 CDN
缓存节点。这样一来，用户第一次访问到该节点时，就可以直接命中缓存，无需重新回源拉取，由此提高用户第一次访问的速度。

# 提交预取请求的三种方法

  1. 在 [七牛开发者中心](https://portal.qiniu.com) 左侧产品列表中找到 CDN ，进去后点击 [刷新预取](https://portal.qiniu.com/cdn/refresh-prefetch) ，选择 **文件预取** 。  
按要求填写需要预取的 URL，点击提交即可。  
![](https://dn-odum9helk.qbox.me/FrcgGjpHkJ3zN-BKg0Ga_xl4aOmA)

  2. 使用工具  
使用七牛云提供的 [qshell](https://developer.qiniu.com/kodo/tools/1302)
命令行工具，参考使用文档，先设置密钥，然后执行
[cdnprefresh](https://github.com/qiniu/qshell/blob/master/docs/cdnprefetch.md)
命令来预取。

  3. 通过API 接口提交预取请求：  
七牛各服务端的 [SDK](https://developer.qiniu.com/sdk#official-sdk) 都提供了预取的方法。  
另附：[预取接口文档](https://developer.qiniu.com/fusion/api/1227/file-prefetching)

**注：** 提交预取请求后 **10 分钟** 左右，预取全网生效。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  资源访问有问题时提工单所需的信息

最近更新时间: 2017-12-01 12:54:04

当提工单给七牛技术支持的时候，应该提供哪些信息方便七牛的技术支持更快的解决问题。

# 1.链接

提供资源的完整链接（以文本的形式），如<https://ymh.qiniuts.com/233.gif> 包含域名和路径
如果url有parameters（参数）、query(查询)、fragment（信息片断）等也需要带上。

# 2.headers

一次连接的完整的普通头(general header)、响应头(response header)和请求头(request
header)，可以用浏览器或其他工具抓包获取，以chrome浏览器为例：

### 普通头：

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

  

### 响应头：

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

  

### 请求头：

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

截取headers一定要清晰完整，最好复制下来，以 _文本的形式_ 再发一份。

  

# 3.响应

如果是七牛的报错，响应里会是一个josn的文件，如下图

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

如果响应有内容，可以把图片或视频等截图发给我们，方便我们比对，如下图。

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

  

# 4.ping和dig

使用ping和dig命令，并把结果完整截图发给我们

  

# 5.本地网络情况

包括带宽情况，是否是独占网络，本地的网络运营商和地区

  

# 6.其他

如果有工具可以进行检测，也可以把结果发给我们，对于关键信息并且文本较多，最好复制粘贴再发给我们一份，以便更快解决问题。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  windows 如何 ping 域名的教程

最近更新时间: 2017-08-21 10:44:47

问题描述

出现域名访问慢或无法访问的情况，可以通过 ping 域名的方法检测网络连通性

具体步骤（适用于 Xp，Win7，Win8）：

# 步骤一

按住 win+R 可以调出运行对话框（win 键就是 Ctrl 和 Alt 中间的键）  
![](https://dn-odum9helk.qbox.me/FnEt0edGAFLcUaVo1u68WSMikyaw)

# 步骤二

在运行框中输入 cmd 即可打开命令行  
![](https://dn-odum9helk.qbox.me/FsDI3trj049qMoSE5qGMzY5LPo76)

# 步骤三

参照下图，红色框输入你要检测的域名，敲回车  
ping 通会有如下显示：  
![](https://dn-odum9helk.qbox.me/FrlISLeB3UpCYLsY-qvgofxoSsO0)

蓝色框是 cdn 入口 ip  
绿色框是网络的联通情况  
如果网络联通情况较差，请将检测结果截图给我们

ping 不通会有如下显示：  
![](https://dn-odum9helk.qbox.me/Fmo2m3e32kHr0T5Q9q1uEPfMukX6)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  文件X-reqid及response header的获取方式

最近更新时间: 2019-07-19 18:24:06

### 方式一：命令行获取

* * *

例如：使用 curl 命令可以直接获得 <http://qiniuphotos.qiniudn.com/gogopher.jpg> 的response
header以及X-Reqid

    
    
    curl -I http://qiniuphotos.qiniudn.com/gogopher.jpg
    

![命令行获取X-
Reqid](https://camo.githubusercontent.com/c13d90abd5b59ad78909f51b6408e099780711c2/687474703a2f2f6974697361746573742e71696e6975646e2e636f6d2f536e697032303135303131345f382e706e67)

### 方式二：浏览器获取

* * *

  1. 打开资源链接，鼠标右击，选择`检查`；  
![](https://dn-odum9helk.qbox.me/FvYv4Ozj-eyLGI2Au-ZReYD0Znpz)

  2. 选择`网络(Network)`,并勾选 Disable cache ;

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

  3. 刷新一下网页，选择网络列表中的资源文件，即可看到返回状态码以及对应的response header，其中包括了X-Reqid。

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

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  视频教程 - 刷新缓存

最近更新时间: 2019-01-07 17:20:28

[刷新缓存视频教程](http://dn-odum9helk.qbox.me/spjc/refresh.mp4)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  如何验证域名已经配置成功

最近更新时间: 2020-02-14 16:56:50

# 验证的使用场景

1.您的域名创建后，无法访问资源，不返回状态码，请参考步骤一和步骤二。  
2.您的域名创建后，状态为 等待CNAME ，请参考步骤二。  
3.您的域名创建后，自行检查CNAME解析，请参考步骤二。  
**不适用场景** ：访问资源时已经返回了JSON格式信息或者HTTP状态码，请您根据相关信息排查。

# 第一步：检查域名是否已经创建成功

在 **七牛开发者平台** 页面选择 [**CDN**](https://portal.qiniu.com/cdn/overview) ，选择
[**域名管理**](https://portal.qiniu.com/cdn/domain)，可以查看具体域名的状态。

  * 处理中：创建域名处理中，通常情况下 10-30 分钟完成，若超过30分钟未配置完成，您可以[提交工单](https://support.qiniu.com/)反馈。
  * 成功：当域名状态显示成功，表示您的域名已经创建成功，您可以参考步骤二排查。  
![](https://dn-odum9helk.qbox.me/Fu1QzPMNAX4qwTSJ5_wMcjKW4cjN)  

# 第二步：检查域名的CNAME是否配置正确

在 **七牛开发者平台**
页面选择[**对象存储**](https://portal.qiniu.com/bucket)，点击具体的对象存储空间后，在空间概览中查看 CDN 加速域名
的状态。

  * 成功：CNAME正确解析。
  * 等待CNAME：CNAME未正确解析。  
![](https://dn-odum9helk.qbox.me/Fp3cSx_sEhSAnJvGVpCWk9O9UGn1)

## 如果您在域名厂商处已经配置CNAME解析后，仍旧是“等待CNAME”状态。

您可以根据下面提供的方法进行测试，如果已经成功解析到您的CNAME，则可以忽略不计。  
**注意：如果未成功解析到您的CNAME，请您重新检查您的解析记录，主机记录和记录值是否填写有误，请参考[如何配置域名的CNAME](https://developer.qiniu.com/fusion/kb/1322/how-
to-configure-cname-domain-name)。**

  * linux/mac系统您可以通过如图所示的命令 `dig 您的加速域名` 查看，第一条是否解析到您配置的CNAME值。  
![](https://dn-odum9helk.qbox.me/FhZC_DzsNzPA6PzpD2ApNdy1udEE)

  * windows系统可以通过Win+R 或 点击左下角的“开始”按钮打开“开始”菜单，打开“运行”，输入cmd回车。  
在命令行模式下输入`nslookup 您的加速域名`，在结果中可以看到您复制的cname值即可。

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

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  视频教程 - 绑定域名

最近更新时间: 2023-06-25 19:40:53

如何绑定域名，进行cname 解析

<https://dn-
odum9helk.qbox.me/lnwaoAhRqxEasksQlVu1V6n6ZwVb.mp4>[__](https://dn-
odum9helk.qbox.me/lnwaoAhRqxEasksQlVu1V6n6ZwVb.mp4)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  私有 M3U8 播放发生 ts 资源加载报401（Unauthorized）错误

最近更新时间: 2017-08-30 14:42:11

# 问题描述

私有空间的M3U8文件在调用pm3u8接口无法播放，提示下面的报错：

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

# 问题原因

这样的报错原因基本有两种：

## 原因一

pm3u8接口在设置 expires 或者 deadline 参数值过小，而视频播放时长较长，导致私有ts资源url下载凭证链接失效，致使视频无法播放。

## 原因二

客户私有空间的缓存策略选择默认缓存，或者m3u8文件的缓存时间过长，并且开启了回源鉴权策略，导致客户在播放的时候命中的是之前的ts文件，而之前的ts文件已经失效，导致播放失败。

回源鉴权请参考：<https://developer.qiniu.com/fusion/manual/3930/back-to-the-source-
authentication>

# 解决方法

## 原因一解决办法

pm3u8接口在设置 expires 或者 deadline 参数值要比视频的播放总时长要大

## 原因二解决办法

以下方法推荐选择第二种：

1：关闭回源鉴权策略（不推荐）

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

2：设置m3u8文件的缓存时间为0s;

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

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  七牛云对文本文件下载优化的支持

最近更新时间: 2017-08-30 17:18:06

**需求情景描述**

当你需要对上传完成的文件进行压缩，然后对压缩过的文件进行下载，来减少流量，七牛云提供了以下解决方案来帮助你节省流量

**解决方案**

首先七牛对用户的上传文件，原样上传（保存最原始的文件），其次当用户请求的时候，七牛自动会对文本文件进行压缩操作（gzip）。然后客户端（浏览器）如果支持gzip的话，会自动解压缩。这样会给用户省去很多流量费用。

七牛解决方案： 支持的文件类型：

    
    
    text/plain
    text/css
    text/javascript
    text/xml
    application/x-javascript
    application/json
    application/xml
    application/xml+rss
    application/javascript
    

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  视频播放卡顿、无法播放，应该怎么办？

最近更新时间: 2017-09-30 17:28:45

# 视频播放卡顿

视频播放缓冲时间长，播放卡顿。

问题分析：

1：检查播放的域名是否是测试域名，比如
`*.bkt.clouddn.com`。测试域名访问有限制，不适合在正式环境中使用，建议绑定自定义域名：<https://developer.qiniu.com/fusion/manual/1228/fusion-
quick-start>

2：通过avinfo查看视频元信息的码率：`bit_rate`，avinfo使用详情参考：<https://developer.qiniu.com/dora/manual/1247/audio-
and-video-metadata-information-avinfo>

码率与带宽的换算：bit_rate/1024/1024

再用 <http://www.speedtest.net/> 测试网络的下行带宽，然后与上面的码率换算后的带宽进行比较。

如果是码率过高造成的视频播放卡，可以使用多媒体处理的音视频转码，将码率设置低一点。音视频转码请参考：<https://developer.qiniu.com/dora/manual/1248/audio-
and-video-transcoding-avthumb>

# 视频无法播放

问题分析：

1：最常见的就是的浏览器或者播放器不支持该视频的编码格式，例如谷歌浏览器不支持编码格式为mpeg4的视频，需要特定的播放器才能正常播放。编码格式可以通过avinfo查看视频元信息的编码格式(codec_name)，avinfo详情参考：<https://developer.qiniu.com/dora/manual/1247/audio-
and-video-metadata-information-avinfo>

如果是编码格式造成的无法播放，可以使用多媒体处理的音视频转码，将音视频转成播放器或者浏览器支持的编码格式。音视频转码请参考：<https://developer.qiniu.com/dora/manual/1248/audio-
and-video-transcoding-avthumb>

2：音视频本身文件损坏，你可以将上传之前的文件拿到播放器去播放，观察是否正常的播放。如果不能正常的播放，说明该音视频可能损坏。

3：如果上述的问题都是正常的，可以提交工单，需提供以下信息：

一：ping 自定义加速域名的截图；

二：完整的资源url链接

七牛工程师会在工单上帮你分析无法正常播放的原因。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  SSL 证书续费操作流程

最近更新时间: 2020-01-09 11:58:21

在七牛购买的证书，支持进行续费操作，续费后将生成一个新证书订单，需要针对新生成的证书订单，进行补全信息及证书验证的操作，等待证书签发后，本次续费操作完成。

1.登录 [七牛开发者平台](https://portal.qiniu.com/create) ，在左侧点击 [SSL
证书服务](https://portal.qiniu.com/certificate/ssl)，找到待续费的证书订单，点击续费。  
![](https://dn-odum9helk.qbox.me/FmUrGkxakPnMfH4weB1ePaNUfICb)

2.提交订单后，会提示您进行证书信息补全：  
![](https://dn-odum9helk.qbox.me/Fl1YnAdK5Dxox_zhjiOnteKPE-r1)  
如果您提交订单后跳过了这个按钮，后续也可以在订单页面找到这个证书，点击进行补全。  
![](https://dn-odum9helk.qbox.me/FmZq_IiwpmBnhgB-Y_xjPdMm0gr-)

3.补全信息完成后，您需要完成证书的验证配置。  
您可以在`订单详情`中获取证书的验证信息，如果您申请的是免费DV证书，您可以参考文档[**免费证书验证指南**](https://developer.qiniu.com/ssl/manual/3667/ssl-
certificate-of-free-dns-validation-guide)  
![](https://dn-odum9helk.qbox.me/FoqM2pSph8xmBVCQskjEdRQE9jBx)

4.证书配置成功且订单签发后，您需要在「CDN」-「域名管理」-「配置」页面，修改「HTTPS配置」，选择下拉框中可选证书，点击提交即可更换CDN域名的绑定证书。  
![](https://dn-odum9helk.qbox.me/FnABqLz16VOF4wInaPQrNkgIOb09)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  防止运营商劫持安装包

最近更新时间: 2017-08-21 09:56:30

# 前言

许多客户将软件安装包（比如 andriod 的安装包 xxx.apk）托管在七牛的存储空间，通过融合CDN线路进行安装包的分发。

而这些软件包在分发的过程中有可能被第三方或者各个运营商的劫持，从而导致用户下载不到自己的安装包。

为了避免这种劫持我们可以在文件名中隐藏掉 `apk` 等关键字。

# 解决办法

  1. 在 存储空间 的  _图片处理_ 中 新建一个样式

  2. 使用 [qrstcl](https://developer.qiniu.com/kodo/tools/qrsctl) 工具 [设置API规则别名](https://developer.qiniu.com/kodo/tools/qrsctl#api-style)

# 举例说明

用户使用进行下载时，运营商检测到链接 `http://xbox.qiniudemo.com/Kingdom_Rush_Origins.apk` 中含有关键字
apk 然后进行劫持，致使下载到其他的 apk 文件。

为了防止被劫持，我们只需要将 url 中`apk`关键字去除；在空间中新建一个样式 `sytle` 来做到该效果。

在存储空间 xbox 中以 apk 结尾的文件创建个别名为 ninja，例如

  * `http://xbox.qiniudemo.com/Kingdom_Rush_Origins.apk`

使用 ninja 样式后的链接为：

  * `http://xbox.qiniudemo.com/Kingdom_Rush_Origins-ninja`

## 方法一

在存储空间 xbox 中 新建一个样式 ninja -> 高级设置中填写 $0.apk -> 保存设置

![](https://oi2ix6x26.qnssl.com/attachments/download/1041603/00157d290aae32694a09669319f4f26/)

![](https://oi2ix6x26.qnssl.com/attachments/download/1041604/00157d290ad37e1c0839cf89d5bc89c/)

## 方法二

下载工具 [qrsctl](https://developer.qiniu.com/kodo/tools/qrsctl)

  * (1) 登录
    
        qrsctl login <User> <Passwd>
      or
    qrsctl login <AK> <SK>
    

  * (2) [设置API规格别名](https://developer.qiniu.com/kodo/tools/qrsctl#api-style)，执行：
    
        qrsctl style xbox ninja '$0.apk'
    # Bucket    -> 存储空间
    # aliasName -> 样式名称
    # fop       -> $0.apk
    qrsctl style <Bucket> <aliasName> <fop>
    

  * (3) 验证结果。如果失败，请重复之前的步骤；如果还不可以，可以在个人面板->提交工单 ![](https://oi2ix6x26.qnssl.com/attachments/download/1041607/00157d290b0b5d6e064e713fa04b53e/)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交