如何配置域名的 CNAME

CNAME 简介

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

---

CNAME 配置

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

一. 获取CNAME值

  在 七牛开发者平台 页面选择 融合CDN ，选择 域名管理 ，点击您需要配置的 域名 后的 配置 字样，进入 配置 界面，在基本信息中查看CNAME值 ，如下图所示。

---

二. 添加CNAME记录

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

1. 打开您购买域名的厂商官网，登陆后在页面右上角找到 控制台 或 相关管理后台入口。
   
   
2. 在控制台中，找到您的域名解析添加页面，例如：
   a. 阿里云：在控制台页面的左侧，产品与服务栏中选择 域名。
   b. 腾讯云：在控制台的云产品中，搜索并选择 云解析。
   c. DNSPOD：在控制台页面左侧，选择 域名。
   其他域名厂商请参考产品文档说明或咨询产品售后。
   
   
3. 在域名产品的列表中找到您加速域名对应的主域名，点击域名后面的 解析设置 或 解析，进入解析设置页。
   
   

4. 选择 添加记录 ，依次填写 主机记录，记录类型 以及 记录值，其他可设为默认值。

   

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

5. 如果您不清楚如何填写主机记录，请参考下文提供的示例。

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

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

加速域名	域名类型	主机记录
	普通域名	@
www.	普通域名	www
cdn.	普通域名	cdn
video.cdn.	普通域名	video.cdn

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

加速域名	域名类型	主机记录
.	泛域名	*
.cdn.	泛域名	*.cdn

配置完成，如何检查解析是否生效

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

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

解决方案：

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

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

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

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

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

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

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

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

• linux/mac系统您可以通过如图所示的命令 dig 您的加速域名 查看，第一条是否解析到您配置的CNAME值。
  

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

  

 注：详细排查步骤请参考文档 检验域名创建是否成功

---

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 。