EasyStarter logoEasyStarter
邮件服务

Cloudflare 邮件服务

使用 Cloudflare Email Service 在线上和本地发送真实邮件

Cloudflare 邮件服务

Cloudflare Email Service 适合已经把域名托管在 Cloudflare 的项目。配置完成后,用户可以在自己的邮箱中收到注册验证、密码重置和邮箱验证码邮件。

Cloudflare 邮件服务不需要额外的邮件 API Key,也不需要新增邮件环境变量。

选择 Cloudflare 邮件服务

packages/app-config/src/app-config.ts 中将邮件服务商切换为 cloudflare,并将 yourdomain.com 替换为你自己的发件域名:

packages/app-config/src/app-config.ts
email: {
  provider: "cloudflare",
  from: {
    localPart: "noreply",
    domain: "yourdomain.com",
  },
},

本地开发接收邮件

本地开发时,邮件 HTML 会记录到 Wrangler 日志和临时目录。打开项目下的 .wrangler/tmp/email 目录,找到临时 HTML 文件并点击打开,即可查看邮件内容。

线上开启邮件发送

开通 Email Sending

  1. 登录 Cloudflare 控制台
  2. 进入 Compute → Email Service → Email Sending
  3. 点击 Onboard Domain,选择你的发件域名
  4. 验证并激活

如果域名本身就在 Cloudflare 管理,所需记录通常可以直接在控制台中完成配置。向任意真实用户邮箱发送邮件需要开通 Workers Paid 套餐

部署并收取测试邮件

正常部署服务端即可。线上 Worker 会直接连接真实的 Cloudflare 邮件服务。

部署完成后,使用一个真实邮箱触发注册验证、忘记密码或邮箱验证码。收到邮件即表示线上邮件发送已经生效;如果暂时没有看到,请检查垃圾邮件目录,并在 Cloudflare Email Sending 页面查看活动日志。