集成能力
邮件服务
Bunship 邮件上线指南:当前模板、React Email 预览流程与 Resend 配置。
Bunship 已把邮件能力接入认证流程。你上线前主要做这几件事:
- 完成 Resend 发件域名认证
- 配置环境变量
- 调整现有模板品牌文案
- 跑通完整收发测试
当前内置模板
| 模板 | 触发场景 | 文件 |
|---|---|---|
| 身份验证邮件 | 注册验证 / 登录验证 | packages/emails/src/templates/verify-identity.tsx |
| OTP 验证码邮件 | 二步验证 OTP 发送 | packages/emails/src/templates/request-send-otp.tsx |
| 重置密码邮件 | 忘记密码 / 重置密码 | packages/emails/src/templates/request-reset-password.tsx |
| 提现状态通知邮件 | 联盟提现状态变更通知 | packages/emails/src/templates/withdrawal-status-changed.tsx |
| 反馈工单状态通知邮件 | 工单状态变化通知(支持回复标题与反馈内容) | packages/emails/src/templates/feedback-status-updated.tsx |
feedback-status-updated 模板支持直接插入 replyTitle 和 feedbackContent(可选 replyContent)。
使用 React Email 预览与导出
现在可直接在 packages/emails 运行模板预览与导出。
cd packages/emails
bun run preview可用脚本:
bun run preview:本地预览(端口3333)bun run preview:build:构建预览应用bun run preview:start:启动已构建预览bun run preview:export:导出静态 HTML 到packages/emails/out
Resend 配置步骤
1. 在 Resend 验证发件域名
在 Resend 控制台添加你的发件域名,并完成 DNS 配置:
- SPF
- DKIM
- (建议)DMARC
2. 配置环境变量
RESEND_API_KEY="re_xxx"
EMAIL_FROM="Bunship <noreply@mail.yourdomain.com>"
NEXT_PUBLIC_SITE_URL="https://yourdomain.com"
BETTER_AUTH_URL="https://api.yourdomain.com"EMAIL_FROM 必须使用已在 Resend 验证通过的域名。
3. 认证链路实测
- 注册并验证邮箱
- 触发重置密码
- 触发 OTP 邮件(启用时)
- 校验中英文邮件内容与链接是否正确
上线前检查清单
- Resend 域名验证已完成。
EMAIL_FROM已切换到生产发件地址。- 邮件回跳链接全部指向生产域名。
- 模板文案、品牌信息和支持入口已替换。
- 已监控发送失败率和垃圾箱命中率。
当前模板截图
以下截图由 React Email 导出模板生成。



