域名配置

搜索并选择域名

登录 Cloudflare Dashboard，切换到准备部署 Saavo 的账户，然后打开 Domain Registration → Register Domains。

搜索框既可以输入完整域名，例如 webpagetopdf.dev，也可以输入产品名称，让 Cloudflare 推荐不同后缀。找到准备购买的域名后，先核对拼写、首年价格和续费价格，再点击对应的购买入口。

搜索结果只能说明域名此刻看起来仍可注册。进入购买流程后，Cloudflare 还会向注册局进行一次最终检查；如果随后提示不可注册，返回搜索页重新选择即可。

填写注册信息

在 Complete your registration 页面选择注册年限，并确认自动续费设置。Cloudflare 默认开启自动续费，右侧会同时显示本次付款金额、到期日期和预计续费价格。

接着填写真实、完整的注册人信息。Cloudflare 当前只接受 ASCII 字符，姓名和地址不要填写中文，可以按实际信息使用拼音或英文。这里填写的邮箱必须能够长期使用，电话也要选择正确的国家或地区代码。

填写完成后，点击右侧的 Continue to pay for… 进入订单确认页。

核对订单并付款

在 Register domain 页面再次核对域名、注册年限、应付金额和付款方式。阅读域名注册协议、服务条款和隐私政策，确认无误后勾选页面要求的选项，再点击 Complete purchase。

不要因为浏览器已经记住付款方式就直接提交。域名拼写错误、选错后缀或者没有看清续费价格，通常不能在购买后通过退款解决。

等待注册完成

Cloudflare 通常会在几十秒内完成注册。页面显示 Your domain is on its way，并在域名前出现成功标记后，说明域名已经注册到当前账户。

点击域名右侧的 Manage，可以直接进入管理页面；以后也可以从 Domain Registration → Manage Domains 找到它。

检查域名状态

在域名管理页面确认状态为 Active，并检查到期时间、续费价格和 Auto renew 是否符合预期。

如果 Cloudflare 或注册局发来注册人邮箱验证邮件，要及时完成验证。注册人邮箱未验证或验证失效时，域名可能被暂停解析。联系人信息和付款方式以后发生变化，也应及时更新。

在 Spaceship 购买域名

打开 Spaceship 域名搜索，输入准备注册的完整域名。加入购物车前，重点核对域名拼写、注册价格、续费价格、注册年限和可能产生的 ICANN 费用，不要只看第一年的促销价。

填写真实的联系人信息并完成付款后，回到 Domain List，确认域名已经出现在账户中并且可以管理。结算时推荐的主机、Spacemail 和其它附加服务都不是接入 Cloudflare 的必要条件，暂时用不到可以不购买。

打开 Cloudflare 的域名接入入口

登录 Cloudflare Dashboard，切换到准备部署 Saavo 的账户。打开 Domains，在页面右上方点击 Add domain。

选择连接已有域名

Cloudflare 会列出三种操作：连接已有域名、把域名转移到 Cloudflare，以及购买新域名。域名已经在 Spaceship 注册，因此选择 Connect a domain。

不要选择 Transfer a domain。连接域名只是把 DNS 交给 Cloudflare，转移域名则会更换注册商，两者不是一回事。

输入根域名

在 Domain name 中填写根域名，例如 webpagetopdf.dev，不要填写 www.webpagetopdf.dev，也不要带 https://、端口或路径。

页面下方还会显示 AI 爬虫策略和 DNS 记录导入方式。这些选项不会影响域名能否接入 Cloudflare，第一次配置可以先保留默认值，之后再根据网站需要单独调整。确认域名无误后，点击 Continue。

选择 Cloudflare 计划

Cloudflare 会让你为这个域名选择计划。Saavo 项目刚开始部署时，选择 Free 即可；以后确实需要更高级的安全、缓存或支持能力，再升级也不迟。

检查 Cloudflare 扫描到的 DNS 记录

选择计划后会进入 Review your DNS records 页面。Cloudflare 会尝试从原来的 DNS 服务中扫描记录，但扫描结果不一定完整，不能把它当作原记录的完整备份。

如果这是刚购买、还没有使用过的域名，页面中通常只有 Spaceship 自动添加的停放页记录，这些记录可以删除。如果域名已经有网站、邮箱或其它服务，不要全部删除，应先把原 DNS 中的 A、AAAA、CNAME、MX、TXT 等有效记录逐项核对并补齐。

确认记录后，点击 Continue to activation。以后还可以在 Cloudflare 的 DNS → Records 中继续添加或修改记录。

保存 Cloudflare 分配的域名服务器地址

Cloudflare 会显示需要替换的旧地址，以及分配给当前域名的两条 Cloudflare 域名服务器地址。先不要关闭这个页面，下一步需要把这两条地址填入 Spaceship。

每个域名分配到的地址可能不同。请复制自己页面中显示的内容，不要直接照抄本教程截图里的 guss.ns.cloudflare.com 和 june.ns.cloudflare.com。

如果域名原来开启了 DNSSEC，先在原 DNS 服务中关闭，并删除旧的 DS 记录。等 Cloudflare 确认域名接入成功后，再通过 Cloudflare 重新开启 DNSSEC。

打开 Spaceship 的域名详情

回到 Spaceship，在 Domain List 中找到刚才添加到 Cloudflare 的域名，点击该域名，打开右侧的详情面板。

进入 Nameservers & DNS

在详情面板中点击 Nameservers & DNS。进入设置页面后，可以看到当前使用的是 Spaceship 域名服务器，点击 Change。

改用 Cloudflare 域名服务器

在打开的面板中选择 Custom nameservers，删除 Spaceship 原来的地址：

launch1.spaceship.net
launch2.spaceship.net

然后填入 Cloudflare 为当前域名分配的两条地址。以本页截图中的域名为例：

guss.ns.cloudflare.com
june.ns.cloudflare.com

上面只是示例，实际操作必须以你自己的 Cloudflare 页面为准。核对两条地址，确认没有遗漏、没有多余空格，也没有混入原来的 Spaceship 地址，然后保存设置。

如果 Spaceship 提示现有产品连接和 DNS 记录将停止生效，先确认需要保留的记录已经添加到 Cloudflare，再确认切换。Spaceship 中的原记录不会继续对外解析。

通知 Cloudflare 并等待接入完成

回到刚才的 Cloudflare 引导页面，点击底部的 I updated my nameservers。Cloudflare 会开始检查域名服务器，域名状态会先显示 Pending Nameserver Update，确认成功后变成 Active。

域名服务器更新通常不会立刻完成。Cloudflare 提示最长可能需要 24 小时，Spaceship 提示全球 DNS 完整生效可能需要 48 小时。等待期间不要反复切回 Spaceship 的域名服务器，否则只会让状态更难判断。

域名变成 Active 后，DNS 记录就改在 Cloudflare 中管理。如果前面关闭了 DNSSEC，此时再按照 Cloudflare 提供的 DS 信息重新开启。

为域名启用 Email Routing

登录 Cloudflare Dashboard，打开 Compute → Email Service → Email Routing，点击 Onboard Domain，然后选择 webpagetopdf.dev。

Cloudflare 会为根域名添加接收邮件所需的 MX、SPF 和 DKIM 记录。确认页面中的域名无误后完成接入。DNS 记录通常几分钟内生效，少数情况下可能需要更长时间。

添加并验证实际接收邮件的邮箱

打开 Destination Addresses，在页面下方填写你平时真正使用的邮箱，然后点击 Add address。

Cloudflare 会向这个地址发送验证邮件，打开邮件并点击验证链接。Destination Address 属于整个 Cloudflare 账户，同一个已经验证的地址可以被多个域名重复使用。完成验证之前，指向它的转发规则不会生效。

创建 support 转发规则

回到 Email Routing，选择 webpagetopdf.dev，打开 Routing Rules，点击 Create routing rule。

按下面的方式填写：

保存后，发给 support@webpagetopdf.dev 的邮件就会被转发到这个邮箱。除非确实需要接收任意地址的来信，否则不建议一开始就开启 Catch-all；公开域名的全域收件很容易带来大量垃圾邮件。

测试转发并修改 Saavo 配置

使用另一个邮箱向 support@webpagetopdf.dev 发送测试邮件。不要用 Destination Address 给自己发信，有些邮件服务会合并、隐藏或丢弃这种邮件，容易误以为转发失败。

确认能够收到邮件后，再修改 Saavo 配置：

supportEmail: 'support@webpagetopdf.dev',

打开 Email Sending

登录 Cloudflare Dashboard，进入 Compute → Email Service → Email Sending。

页面右侧会显示当前周期的用量和发送额度。点击右上角的 Onboard Domain，开始添加发送域名。

选择发送域名

Zone 选择 webpagetopdf.dev。建议再使用一个专门发送邮件的子域名，例如 email.webpagetopdf.dev；如果不填写 Subdomain，则使用根域名发送。

后面的发件人地址必须属于这里添加的域名。截图中使用的是 email.webpagetopdf.dev，Saavo 的发件人就可以设置为 send@email.webpagetopdf.dev，不能继续使用属于其它发送域的地址。

确认后点击 Continue。

核对并添加 DNS 记录

Cloudflare 会列出准备添加的 MX 和 TXT 记录，分别用于退信处理、SPF、DKIM 和 DMARC。它们通常位于 cf-bounce、_domainkey 和 _dmarc 等专用名称下。

不要照抄本教程截图里的记录值。确认页面没有提示需要删除仍在使用的冲突记录后，点击 Activate，让 Cloudflare 自动写入当前域名需要的内容。

等待发送域名生效

返回 Email Sending 列表，等待域名状态显示为 Enabled，DNS records 显示为 Configured。Cloudflare 表示使用其 DNS 时通常会在几分钟内完成，少数情况下可能需要更长时间。

域名尚未启用时不要急着部署生产环境，否则 Worker 即使存在 EMAIL Binding，也会因为发件域名未获允许而发送失败。

修改 Saavo 的邮件配置

将邮件提供方改成 Cloudflare：

emailProvider: {
    type: 'cloudflare',
},

再把发件人改成刚才启用的发送域名。supportEmail 是用户回复邮件时使用的地址，可以继续使用已经配置好接收能力的 support@webpagetopdf.dev。

fromEmailAddress: {
    name: 'Webpage to PDF',
    email: 'send@email.webpagetopdf.dev',
},
supportEmail: 'support@webpagetopdf.dev',

配置 EMAIL Binding 并部署

如果还没有执行首次部署，直接运行 npm run deploy:init。部署脚本会读取 emailProvider.type 和发件人地址，在 wrangler.jsonc 中生成限制了发件人的 send_email Binding，不会再询问 RESEND_API_KEY。

如果项目已经完成首次部署，后来才从 Resend 切换到 Cloudflare，需要先检查 wrangler.jsonc。当前没有 EMAIL Binding 时，手工添加：

"send_email": [
    {
        "name": "EMAIL",
        "allowed_sender_addresses": [
            "send@email.webpagetopdf.dev"
        ]
    }
],

send_email 是 wrangler.jsonc 的顶层配置，不要写成通用的 bindings: [{ type: 'email' }]。allowed_sender_addresses 还必须与 config/base.ts 中的 fromEmailAddress.email 完全一致。

配置完成后运行：

npm run doctor
npm run deploy:update

发送一封真实测试邮件

在生产环境触发一次注册验证或密码重置，确认外部邮箱可以收到邮件，并检查发件人、Reply-To 和邮件内容是否正确。如果没有收到，先查看垃圾邮件，再到 Cloudflare Email Sending 的日志和 Suppressions 中检查发送结果。

只看到域名 Enabled 不能说明 Saavo 已经配置正确；发件域名、fromEmailAddress、EMAIL Binding 和实际部署版本必须同时一致。