SaasOne v2.0 Docs
2026-11-21·4 分钟

邮箱:Cloudflare 邮件

Cloudflare Email Workers / SMTP 统一邮件传输通道,认证验证邮件与业务邮件共用同一入口。

三种邮件后端与配置#

邮件走统一传输缝 lib/mail.ts 的 sendMail(),三种后端由 MAIL_PROVIDER 决定:log(开发期仅打印到控制台)、cloudflare(Workers Email 绑定,边缘零出网延迟)、smtp(Docker / 私有服务器 nodemailer)。认证系统的验证邮件、重置密码邮件自动复用同一通道:

开发期零配置
不配置任何邮件变量时默认 MAIL_PROVIDER=log:所有邮件仅打印到服务端日志,认证流程照常走通,本地开发无需真实邮箱。
env.env.local(邮件段)
# Cloudflare Workers 部署:使用 Email Workers 绑定
MAIL_PROVIDER=cloudflare
CLOUDFLARE_MAIL_FROM="no-reply@your-domain.com"

# 或自托管 SMTP(Docker / Node 服务器)
# MAIL_PROVIDER=smtp
# SMTP_HOST=smtp.your-domain.com
# SMTP_PORT=465
# SMTP_USER=...
# SMTP_PASS=...

业务代码中发送邮件#

Cloudflare 侧的前提
使用 cloudflare 后端需在 Cloudflare 控制台为你的域名启用 Email Routing 并创建 Email Worker,域名 DNS 由 Cloudflare 托管是前置条件(见「域名解析」文档)。
typescriptsendMail 统一入口
import { sendMail } from '@/lib/mail';

await sendMail({
  to: 'user@example.com',
  subject: '欢迎加入 SaasOne',
  text: '你的账号已创建成功',
  html: '<h1>欢迎加入 SaasOne</h1>',
});