自定义域名

项目的 API 域名

在控制台的“设置”下的“API 域名”中注册一个主机名。验证通过后，项目的 API 就会在该主机名上应答，与在默认的 api.foir.dev 上一样。你的域名提供 GraphQL 查询和订阅、用于代码生成的 schema 端点，以及文件上传端点。两个主机名上的缓存、速率限制和错误都相同。

登录应用的登录域名

登录域名属于一个登录应用。你可以在 config 中列出它，或在控制台中添加它，托管登录页面就会在该域名上提供。默认域名是 auth.foir.io。当登录域名与你的应用共用同一个可注册域名时，Fóir 的会话 cookie 对它而言是第一方的，单页应用和服务端渲染应用的 cookie 会话流程需要这一点。

验证主机名

注册后会显示两条 DNS 记录：一条 CNAME，把你的主机名指向 Fóir 的边缘节点；一条 TXT 记录，携带验证令牌。一旦找到 TXT 记录，域名就通过验证。TLS 证书会在新验证的域名收到第一个请求时自动签发，这可能需要片刻，之后会自动为你续期。

注册并不会保留主机名。多个项目可以同时持有待定的声明，第一个发布其 TXT 记录的项目成为唯一的已验证所有者，待定声明在七天后清除。

自定义域名不会改变什么

API 域名只负责路由。每个请求仍然需要项目的密钥，如果请求所用域名所属的项目与其密钥所属项目不同，请求会被拒绝。文件和媒体 URL 不会迁移到你的域名。自定义域名的数量取决于你的套餐。