#  如何配置域名的 CNAME

最近更新时间: 2020-05-21 16:53:21

# CNAME 简介

CNAME 即指别名记录，也被称为规范名字。一般用来把域名解析到别的域名上，当需要将域名指向另一个域名，再由另一个域名提供 ip 地址，就需要添加
CNAME 记录。

* * *

# CNAME 配置

如果需要对七牛创建的加速域名进行 CNAME 配置，您可以在创建加速域名后，通过以下方式为您的加速域名添加解析。  

# 一. 获取CNAME值

  
在 **七牛开发者平台** 页面选择 [**CDN**](https://portal.qiniu.com/cdn/overview) ，选择
[**域名管理**](https://portal.qiniu.com/cdn/domain)，鼠标停留在域名对应CNAME值上即可点击复制 ，如下图所示。  
![](https://dn-odum9helk.qbox.me/FkqzaHLz8IkzamxYtONzj--5TscU)

* * *

# 二. 添加CNAME记录

  
添加CNAME记录需要在您的**`域名厂商`** 处配置，比如您在 阿里云 / 腾讯云 / 新网 等处购买的域名，您需要前往**`购买域名的厂商`**
相应管理控制台，添加域名解析。

  1. 打开您购买域名的厂商官网，登陆后在页面右上角找到 **`控制台`** 或 相关管理后台入口。  
如果您不清楚域名解析的入口，建议查看您域名厂商的产品文档，或者寻求域名厂商的售后支持。  
  

  2. 在域名厂商的控制台中，找到您的域名解析添加页面，例如：  
a. 阿里云：在控制台页面的左侧，产品与服务栏中选择 **域名** 。  
b. 腾讯云：在控制台的云产品中，搜索并选择 **云解析** 。  
c. DNSPOD：在控制台页面左侧，选择 **域名** 。  
其他域名厂商请参考产品文档说明或咨询产品售后。  
  

  3. 在域名产品的列表中找到您加速域名对应的**`主域名`，点击域名后面的 **`解析设置`**或**`解析`，进入解析设置页。  
  

  4. 选择 `添加记录` ，依次填写 **主机记录** ，**记录类型** 以及 **记录值** ，其他可设为默认值。  
如果您不清楚如何填写主机记录，请参考下文第5步提供的示例。

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

参数 | 填写说明 | 注意事项  
---|---|---  
主机记录 | 填写加速域名对应的主机前缀 | 该参数唯一，请勿自定义  
记录类型 | 选择 CNAME 类型 | 该参数唯一，请勿自定义  
线路类型 | 保持默认 | 该参数可以根据需求自行调整  
记录值 | 域名创建后，七牛提供的 **CNAME** | 该参数唯一，请勿自定义  
TTL | 保持默认 | 该参数可以根据需求自行调整  
  
  
  
5.解析示例：

假设您购买的一级域名为 qiniu.com  
您需要先在七牛控制台创建加速域名，比如您创建了 cdn.qiniu.com 或 img.qiniu.com 之类的自定义二级域名。  
创建完成后，在域名厂商后台添加解析记录时，您需要填写主机记录为加速域名对应的前缀，如 cdn 或 img 即可。  
`注意：主机记录需要和加速前缀完全一致，请对应填写。`

常见的普通域名主机记录填写方式举例：

创建的加速域名 | 域名类型 | 主机记录  
---|---|---  
qiniu.com | 普通域名 | @  
[www.qiniu.com](http://www.qiniu.com) | 普通域名 | www  
cdn.qiniu.com | 普通域名 | cdn  
video.cdn.qiniu.com | 普通域名 | video.cdn  
  
常见的泛域名主机记录填写方式举例：

创建的加速域名 | 域名类型 | 主机记录  
---|---|---  
.qiniu.com | 泛域名 | *  
.cdn.qiniu.com | 泛域名 | *.cdn  
配置完成，如何检查解析是否生效

# 如何处理 CNAME 记录和 A 记录冲突？

同一个域名只能使用 A 记录解析，或者使用 CNAME 解析，如果您在添加域名的 CNAME 解析时提示存在冲突，请检查该主机记录是否已经存在 A 记录。

解决方案：

  1. 如果您的域名用于绑定七牛云存储

     * 重新添加一个未在其他地方使用的二级加速域名，例如您原本在七牛绑定的是 qiniu.com 或 [www.qiniu.com](http://www.qiniu.com) ，建议您重新在空间绑定加速域名例如 cdn.qiniu.com 或者 xxx.qiniu.com ，然后针对新添加的加速域名，配置对应的解析即可。
     * 删除您原有的 A 记录就可做 CNAME 解析  
(**注** ：A 记录删除会导致您的域名无法访问该域名的原有资源，谨慎操作)

  2. 如果您的域名用于加速您的源站服务器站点

     * 在确认 CDN 配置无误情况下，可以删除A记录。
     * 通过配置 CNAME 解析，使得域名能够绑定到七牛的加速线路上。

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

# 如何判断 CNAME 是否正确配置？

先在CDN 的 域名管理 中检查域名是否创建成功，如果已经创建成功，且已经按照步骤添加了 CNAME 解析，但是无法正常访问资源外链，或保持“等待
CNAME
”状态，可以通过以下方法检测本地的域名解析，如果域名长时间没有创建成功，您可以[提交工单](https://support.qiniu.com/tickets/new)处理。

您可以通过 nslookup 您的加速域名，域名是否解析到 CNAME 值上。

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

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

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

**注** ：详细排查步骤请参考文档
[**检验域名创建是否成功**](https://developer.qiniu.com/fusion/kb/5326/how-to-check-
whether-the-configuration-is-successful)

* * *

# FAQ

## 为什么使用 CDN 需要 CNAME 记录？

在七牛云开发者平台创建加速域名后，会给域名分配一个 “CNAME域名”（例：cdn-example-
com.qiniudns.com）。用户需要在域名服务商处，配置一条 CNAME 记录，将访问加速域名的请求指向这个 cdn-example-
com.qiniudns.com 域名记录，生效后访问加速域名时解析将会正式指向七牛云 CDN ，之后由 CDN 完成调度，使得该域名所有的请求都开始享有
CDN 加速效果。

## CNAME 记录和 A 记录是什么关系？

  * CNAME 记录和 A 记录都是在 DNS 解析过程中的一种记录值类型。
  * A 记录会直接解析到某个 IP ，CNAME 会解析到另一个域名，之后再对另一个域名继续解析，直到解析出节点。  
所以，A 记录只能够实现域名解析到 IP ，七牛提供的 CDN 加速服务会根据用户所在位置选择并返回最优节点 IP 。

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

* __
* __
* __
* __
* __

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

提交