跳转到主要内容
若要在自定义域名下托管文档,请在 Mintlify 设置中指定您想要的自定义域名,并在域名服务提供商处配置 DNS(域名系统)设置。
想配置类似 mintlify.com/docs 的自定义子目录?请查看自定义子目录文档。

控制台设置

  1. 前往你的控制台
  2. 选择Settings
  3. 选择Domain Setup
  4. 输入你想使用的自定义域名。例如:docs.mintlify.com
自定义域名设置页面,已高亮显示“Enter your domain URL”字段。

配置你的 DNS

  1. 前往域名注册商网站,打开你域名的 DNS 设置。
  2. 使用以下值创建一个新的 DNS 记录:
CNAME | docs | cname.vercel-dns.com.
在 Vercel 上托管的自定义域名的 CNAME 设置示例。

特定提供商设置

如果 Vercel 是你的 domain 提供商,你需要添加一个用于验证的 TXT 记录。提交自定义域名后,这些信息会显示在你的控制台中,并通过电子邮件发送给你。
如果 Cloudflare 是你的 DNS(域名系统)提供商,你需要在 HTTPS 设置中启用“full strict”安全选项。

设置规范 URL

在配置好 DNS 后,设置一个规范 URL,以确保搜索引擎索引你首选的域名。规范 URL 会告诉搜索引擎哪一个版本的文档是主版本。当文档可通过多个 URL 访问时,这有助于提升 SEO(搜索引擎优化),并避免重复内容问题。 docs.json 中添加 canonical 元标签:
"seo": {
    "metatags": {
        "canonical": "https://www.your-custom-domain-here.com"
    }
}
https://www.your-custom-domain-here.com 替换为你的实际自定义 domain。举例来说,如果你的自定义 domain 是 docs.mintlify.com,你应使用:
"seo": {
    "metatags": {
        "canonical": "https://docs.mintlify.com"
    }
}