配置

设置自定义域名

以 Markdown 格式查看

管理员可以使用 Fern Dashboard 来配置以下任何一种自定义域名类型：

  • 子域名: docs.mydomain.com
  • 子路径: mydomain.com/docs
  • 根域名: mydomain.com

Dashboard 会根据您的域名类型自动提供正确的 DNS 记录。

或者，您也可以通过手动配置 DNS 记录来设置自定义域名。

设置

1

打开 Dashboard

导航到 Fern Dashboard 并选择您的文档站点。

2

添加您的自定义域名

在概述标签页的域名部分，选择添加自定义域名并输入您的域名。dashboard 会显示您需要配置的 DNS 记录。

3

在 docs.yml 中更新域名

将您的 custom-domain 添加到 docs.yml 配置中：

docs.yml
1instances:
2  - url: example.docs.buildwithfern.com
3    custom-domain: docs.mydomain.com
4

配置 DNS 记录

登录到您的域名注册商，添加 Fern Dashboard 中显示的 DNS 记录。具体记录取决于您的域名类型（子域名、子路径或根域名）。

5

验证设置

添加 DNS 记录后，返回到 Fern Dashboard 验证您的域名。SSL 会自动为您的域名配置，但可能需要几分钟才能在全球范围内传播。

检查您是否可以从移动设备或隐身浏览器访问您的新文档站点。

多源设置

对于多源站点 — 其中多个仓库发布到同一个自定义域名的不同子路径 — Dashboard 在域名的设置标签页上显示了多仓库设置卡片。这些设置适用于整个域名，而不是针对每个子路径。

该卡片配置：

  • 默认路径 — 设置用户在域名的根目录时跳转的位置。当 Fern 管理的页面作为根页面时很有用。
  • 搜索 / 询问 AI 范围 — 控制在一个子路径中的搜索是否返回所有子路径的结果（统一）还是保持在该子路径的范围内（分层）。

完整设置教程请参见多源文档。