docs.example.com 之类的自定义域名后,默认的 <subdomain>.mintlify.app 地址仍可公开访问,搜索引擎也可以继续抓取它。在某些情况下,默认地址在搜索结果中的排名会高于你的自定义域名。
为什么会出现这种情况
noindex。某些配置依赖默认地址来提供自定义域名服务,因此停用默认地址会导致这些站点下线。
默认地址上的页面已将其规范 URL 设置为你的自定义域名,但 canonical 标签只是一种提示,搜索引擎可以忽略它。当默认地址拥有比自定义域名更多的入站链接或更长的索引历史时,这种情况更容易发生。
停用默认地址
<subdomain>.mintlify.app 地址返回 404,以便搜索引擎将其从索引中移除。你的自定义域名会继续正常工作。
仅当你的自定义域名的 CNAME 指向 cname.mintlify.builders 时(如自定义域名设置页面所示),才能使用此选项。如果你的 CNAME 指向 <subdomain>.mintlify.app 地址,或者你通过反向代理提供文档,停用默认地址也会导致你的自定义域名下线。
要停用默认地址,请使用与你的组织关联的邮箱地址发送邮件至 support@mintlify.com。请包含:
- 你的自定义域名,例如
docs.example.com。 - 你的默认地址,例如
acme.mintlify.app。 - 组织和项目,格式为
app.mintlify.com/<your-org>/<your-project>。
加快从搜索结果中移除
- 如果你在
docs.json的seo.metatags.canonical或页面的 frontmatter 中设置了规范 URL,请确保它使用你的自定义域名。参见设置规范 URL。 - 在 Google Search Console 中,将你的自定义域名添加为资源,并提交位于
https://<your-custom-domain>/sitemap.xml的站点地图。 - 要更快地从 Google 结果中隐藏默认地址的 URL,请将
<subdomain>.mintlify.app添加为 Search Console 资源并使用“移除”工具。请在支持团队停用默认地址之前,使用google-site-verificationmeta 标签验证该资源,因为验证要求该地址可以访问。