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>',
});