发信配置

在系统设置 → 邮件收发选择全站发信通道。新安装默认 Resend；Cloudflare Email Sending 为 Beta 备选。选择通道不会清除另一通道的配置，失败也不会自动切换服务。

从免费方案开始可选择 Resend，验证自己的发件域名后再发送测试邮件。如果希望发信也使用 Cloudflare，先确认 Workers Paid 与域名开通条件。两种路径均无需 VPS，费用与准备说明各自额度与前提。

Resend

  1. 在 Resend 账号中添加你拥有的发件域名，例如 example.com，按要求配置 DNS 并等待验证通过。
  2. 创建允许该域名发信的 API Key。
  3. 在 FlareMail 系统设置 → 邮件收发选择 Resend，将 Key 填入对应域名一栏，保存并按提示验证管理员密码。
  4. 写信时选择该域名下的发件地址，发送到自己的外部邮箱，检查实际收到的邮件。

每个发件域名都需可用的 Key 和域名验证。输入框留空通常表示保留已有密钥，不是清除。不要把 Key 写进源码或文档。Resend 的测试发件域名和测试收件限制不能代替自己的正式域名配置。域名验证 · API Key

发送成功后，FlareMail 会尝试读取真实 Message-ID，供后续回复关联原邮件。Sending access 仅支持发信；当前实现的邮件详情查询需要 Full access，该权限也允许管理其他 Resend 资源，并非单独的邮件读取权限。若保留仅发送权限，或读取请求失败，发送仍然有效，界面会显示已发送并单独说明会话关联限制；后续回复可能无法归入原会话，无需重新发送。Resend 权限说明 · 邮件关联说明

完整权限也不能保证发送受理后立即得到 Message-ID：Resend 排队期间该字段可能为 null。FlareMail 最多查询 3 次，总等待不超过 5 秒；超过后仍保留已发送结果及会话关联提示，不会重新发送。当前不通过投递回调补齐历史记录。

Cloudflare Email Sending（Beta）

向任意外部收件人发送需要 Workers Paid，并在当前账号为每个发件域名启用 Email Sending。免费发送到账号已验证目标的例外不能代替一般邮箱发信路径。费用与前提

  1. 在 Cloudflare Email Service → Email Sending 接入发件域名，完成 DNS 验证。
  2. 在自己的 apps/worker/wrangler.toml 中启用模板注释中的绑定：
toml
[[send_email]]
name = "email"
  1. 在仓库根目录重新部署：
sh
npx --yes pnpm@10.34.5 run deploy
  1. 在系统设置 → 邮件收发确认绑定已就绪，选择 Cloudflare 并保存。若提示数据库待升级，先在系统维护完成升级。
  2. 发送到自己的外部邮箱，检查收件、垃圾箱与 Cloudflare 发信日志。

仅添加绑定不会改变当前通道。项目本地模拟绑定不投递真实邮件；不要为普通本地测试添加 remote = true。平台配置

附件与大小

网页及 CLI 的发送、回复请求，完整 HTTP 请求体最多 32 MiB，包含正文、附件编码和 JSON 开销。超限会在完整读取或解析前返回 413。此整包上限不增加附件或服务商的限额。

应用发信最多 10 个附件（含内嵌图片），单个不超过 10 MiB，合计不超过 20 MiB。Cloudflare 通道还按整封邮件的编码后估算体积提前限制为 5 MiB，因此实际可用附件体积更小。服务商可能另有额度、收件人数或内容限制。Cloudflare 限制

发送结果与重试

已发送中查看状态和提示。服务接受发送请求不保证邮件进入收件人的主收件箱，需检查垃圾箱或服务商日志。

未验证域名、凭据无效、未绑定通道、超额或大小不符，应先修正配置。网络超时或结果未知时不要立即重发；CLI/Agent 重试同一次发送必须复用原 requestId，详见 CLI / Agent。