On this page
域名
每个组织都有一个默认域,用于该组织内部部署的所有应用。例如,一个标识为 acme-inc 的组织,其默认域为 acme-inc.deno.net。名为 my-app 的应用将自动获得生产域名 my-app.acme-inc.deno.net。
除了这些默认域之外,您还可以为应用添加自定义域。自定义域是您拥有并控制的域。要使用自定义域,您必须:
- 拥有该域(已从域名注册商购买)
- 能够编辑其 DNS 记录
自定义域属于某个组织,可以附加到该组织内的任何应用。
自定义域可以添加为:
- 基础域(例如,
example.com或特定子域) - 通配符域(例如,
*.example.com)
基础域仅适用于单一应用,而通配符域提供更灵活的使用方式。您可以:
- 将整个通配符域分配给一个应用(所有子域指向同一应用)
- 部分分配给多个应用(不同子域指向不同应用)
所有自定义域都需要有效的 TLS 证书。Deno DeployEA 可以通过 Let's Encrypt 自动生成这些证书。
添加自定义域 Jump to heading
- 进入组织域页面(点击左上角的组织名称,然后切换到“域”标签)
- 点击“添加域”
- 输入您的域(例如
example.com) - 选择是仅添加该域还是同时包含通配符子域
- 点击“添加域”
这将打开域配置抽屉。
DNS 配置 Jump to heading
域配置抽屉显示了所需的 DNS 记录,用于:
- 验证域所有权
- 生成 TLS 证书
- 将流量路由到 Deno DeployEA
根据您的域名注册商支持的能力,有三种可能的配置方法:
ANAME/ALIAS 方法(首选) Jump to heading
如果您的注册商支持 ANAME 或 ALIAS 记录,这是最佳选择:
- 添加一个
ANAME/ALIAS记录 - 添加一个用于验证的
CNAME记录
CNAME 方法 Jump to heading
适合子域,但不适用于根域(顶级域):
- 添加两个
CNAME记录 - 注意:此方法不允许在同一域上使用其他 DNS 记录(如
MX记录)
A 记录方法 Jump to heading
兼容性最强,但配置较复杂:
- 添加一个
A记录 - 添加一个用于验证的
CNAME记录
注意:当前 Deno DeployEA 不支持 IPv6。使用
ANAME/ALIAS或CNAME方法时,当支持 IPv6 时,您的域名将自动使用 IPv6。使用A方法时,将在需要添加AAAA记录时通过邮件通知您。
当您使用 Cloudflare 作为 DNS 提供商时,必须禁用 _acme-challenge CNAME 记录的代理功能(即关闭橙色云图标),否则验证和证书发放会失败。
验证 Jump to heading
添加 DNS 记录后,Deno DeployEA 将验证您的域所有权。此过程根据您的 DNS 提供商可能需要几分钟时间。您可以在验证期间保持域配置抽屉打开——验证完成后它会自动刷新。
您可以通过点击“生成证书”按钮手动触发验证。验证成功同时会启动 TLS 证书的生成。
TLS 证书生成 Jump to heading
域名验证后,点击“生成证书”按钮,通过 Let's Encrypt 生成 TLS 证书。这个过程最多需 90 秒钟。
生成后,您将看到证书的详细信息,包括到期时间和颁发时间。
证书会在接近到期时自动续签。您可以在域配置抽屉中查看当前证书状态。
如果自动续签失败(例如,DNS 记录发生变化),您将在证书到期前 14 天收到电子邮件通知。您可以修复问题并联系支持团队尝试重新续签。如果在到期前未续签,域名将停止工作。
自行提供证书 Jump to heading
如果您希望使用自己的 TLS 证书,可以在域配置抽屉中上传。您需要提供:
- 证书文件(PEM 格式)
- 私钥文件(PEM 格式)
上传后,将使用该证书为域名服务。您需自行负责在证书过期前续签并更新证书。
您将在证书到期前 14 天收到邮件通知,提醒您更新证书。若证书过期,域名将停止工作。
上传时,TLS 证书必须有效,且通过证书中的通用名称或主题备用名称覆盖基础域(及通配符子域,如果有通配符域)。私钥与证书必须匹配,并且类型必须是 RSA(2048、3072 或 4096 位)或 ECDSA(P-256、P-384 或 P-521)。
将自定义域分配给应用 Jump to heading
添加自定义域到组织后:
- 进入组织域页面
- 点击自定义域旁的“分配”按钮
- 选择目标应用
- 若使用通配符域,选择是附加基础域、通配符子域还是特定子域
- 点击“分配域名”
从应用中撤销自定义域分配 Jump to heading
- 进入应用设置页面
- 找到“自定义域”部分
- 点击要撤销分配的域名旁的“移除”按钮
这将从该应用移除域名,但该域名仍在您的组织中保留,可用于其他应用。
删除自定义域 Jump to heading
- 进入组织域页面
- 打开域配置抽屉
- 点击“删除”并确认
这会将自定义域从您的组织中移除,并删除该域在所有应用中的所有分配。
将自定义域从 Deploy Classic 迁移到 Deno Deploy Jump to heading
如果您之前在 Deploy Classic 上设置过自定义域,并希望迁移到 Deno Deploy,我们提供了一个分步教程指导您完成此过程。