文档
邮箱功能
邮箱功能
了解个人模式下的邮箱收发、Catch-all 和附件处理方式。
个人模式适合自用或小范围使用，不建议把它当成公开注册邮箱平台来开放给陌生人。
功能范围
个人模式下，站点主要围绕下面几项能力展开：
- 创建和管理自定义域名邮箱
- 接收外部来信
- 在站内发信
- 使用 Catch-all 统一接收未显式创建的地址
- 保存并访问邮件附件
发信链路
站内发信默认建议使用 Brevo：
wr.do
-> Brevo API
-> 外部收件箱你需要确保：
BREVO_API_KEY已配置- 发信域名已在 Brevo 验证
EMAIL_FROM使用的是已验证发件人
收信链路
收信建议使用 Cloudflare 这一套：
外部来信
-> Cloudflare Email Routing
-> Cloudflare Email Worker
-> R2
-> /api/v1/email-catcher
-> wr.do 收件箱这样做的好处是结构简单，附件也能统一进入 R2。
Catch-all 的作用
Catch-all 适合这些场景：
- 你想临时接收某个地址的来信
- 你不想为每个前缀都手动建邮箱
- 你希望把未命中的地址集中收敛到一个目标收件箱
建议在收信链路完全跑通后再打开 Catch-all，这样更容易排查问题。
附件处理
如果启用了 R2：
- 邮件附件会由 Worker 写入 R2
- 前端再通过附件地址展示或下载
- 如果配置了
NEXT_PUBLIC_EMAIL_R2_DOMAIN，附件访问地址会更统一
推荐限制
个人模式更适合做“精简、可控”的邮箱网站，建议默认采用下面的限制：
- 只允许管理员创建邮箱
- 不开放公开注册
- 不启用短链和子域名功能
- 只保留收件箱、已发送和后台配置入口
上线前检查
正式使用前，至少做一次完整验证：
- 从站内发信到 Gmail
- 从站内发信到 Outlook
- 从 Gmail 发信到你的域名邮箱
- 从 Outlook 发信到你的域名邮箱
- 发送一封包含图片或 PDF 附件的测试邮件
- 向一个未显式创建但受 Catch-all 覆盖的地址发信