域名绑定说明

# 域名绑定说明

# CNAME 简介

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

# CNAME 配置

目前,公开文档使用 xxxxxx.apifox.cn 格式的URL,如果你需要使用特定的域名,比如:www.abc.com 。那么,你需要了解并使用 自定义域名 功能,并通过以下方式,进行 CNAME 配置:

注意

请确保所使用域名已完成备案

# 一. 获取 CNAME 值

在 自定义域名 界面,找到对应 CNAME 值,点击复制即可 ,如下图所示。

image-20220810151204712

# 二. 添加CNAME记录

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

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

  2. 在域名厂商的控制台中,找到您的域名解析添加页面,例如:

    a. 阿里云:在控制台页面的左侧,产品与服务栏中选择 域名

    b. 腾讯云:在控制台的云产品中,搜索并选择 云解析

    c. DNSPOD:在控制台页面左侧,选择 域名。其他域名厂商请参考产品文档说明或咨询产品售后。

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

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

image-20220810151204712

参数说明 填写说明 注意事项
主机记录 一般是指子域名的前缀(如需创建子域名为www.apifox-doc.com, 主机记录输入 www;如需实现apifox-doc.com,主机记录输入 @ 该参数唯一,请勿自定义
记录类型 选择 CNAME 类型 该参数唯一,请勿自定义
线路类型 保持默认 该参数可以根据需求自行调整
记录值 从Apifox复制过来的CNAME 该参数唯一,请勿自定义
TTL 保持默认 该参数可以根据需求自行调整

# 自定义域名一直显示未生效怎么办?

  • 首先,配置 CNAME 一般需要 10 分钟左右才生效,请耐心等待

  • 如果长时间 未生效,可能是以下原因导致:

    • CNAME配置不成功,请前往域名管理界面,确认CNAME是否正确配置
    • 域名尚未完成备案