Skip to main content
当你尝试添加一个已注册到其他 Mintlify 部署的自定义域名时,控制台或 mint add-domain 会返回以下错误之一:
  • Domain is already in use by another deployment in your organization 表示该域名属于你可以访问的另一个部署。
  • Domain is already claimed by another organization 表示该域名属于另一个 Mintlify 组织中的部署。这可能发生在试用账户、未使用的组织或以其他工作邮箱创建的部署仍持有该域名的情况下。
同一时间只能有一个部署持有某个自定义域名。将域名添加到目标部署之前,先在当前部署释放它。

自行释放域名

如果你可以访问持有该域名的组织:
  1. 登录控制台并切换到持有该域名的组织。
  2. 打开持有该域名的部署的自定义域名设置页面。
  3. 点击域名旁的 移除图标并确认移除。
  4. 切换到目标组织,从其自定义域名设置页面添加该域名。
只要 CNAME 仍指向 cname.mintlify.builders,你的 DNS 记录就依然有效。如果你还想淘汰旧部署,可在危险区中删除。参见删除部署

请求支持团队释放

如果你无法访问持有该域名的组织,请通过 support@mintlify.com 邮件联系支持团队并附上你拥有域名的证明。这可能发生在组织归属于前员工、使用你已无法访问的个人邮箱,或组织被弃用但未释放域名的情况下。 请附上:
  • 该自定义域名,例如 docs.example.com
  • 你希望添加到的目标组织和部署,格式为 app.mintlify.com/<你的组织>/<你的部署>
  • 可能持有该域名的邮箱地址或组织名称。
  • 你控制该域名的证明,例如 DNS 提供商管理控制台的截图。支持团队也可能要求你添加一个验证用的 TXT 记录。
支持团队释放域名后,可从控制台或使用 mint add-domain 添加该域名。