MakiSend 如何在 Cloudflare 上运行

背后的 Cloudflare 产品

• Workers（Cloudflare 文档，在新标签页中打开）

  一个 Worker 运行所有内容：Hono API、登录、控制台和投递代码。

  nodejs_compat 让 nodemailer 及其 SMTP 客户端无需改动即可运行。没有服务器，也没有容器。

• Static Assets（Cloudflare 文档，在新标签页中打开）

  从同一个 Worker 提供控制台（Astro 构建），与 API 同源。

  同源意味着没有 CORS，只需记住一个 URL。

• D1（Cloudflare 文档，在新标签页中打开）

  数据库：邮件日志和历史、加密的内容和附件、SMTP 配置、API keys、模板、账号。

  收件人、正文、附件和 SMTP 凭据在写入前都经过 AES-256-GCM 加密。Schema 由 Drizzle 迁移管理。

• Queues（Cloudflare 文档，在新标签页中打开）

  将 API 与投递解耦：邮件 id 一进入队列，请求就结束。

  每批最多 10 条，消费者重试 3 次，间隔 30 秒，之后进入死信队列（makisend-send-email-dlq）。

• Workflows（Cloudflare 文档，在新标签页中打开）

  每封邮件一次持久运行。它的 id 就是邮件 id，因此同一封邮件不可能被两次运行重复发送。

  4 次 SMTP 尝试，间隔 30 秒，重启后依然继续。永久错误（auth、TLS、DNS、5xx）会立即停止。每一步都写入这封邮件的历史。

• TCP sockets（Cloudflare 文档，在新标签页中打开）

  Worker 自己通过 TLS 打开到你的服务商的 SMTP 连接。

  端口 465、587、2465、2525 和 2587。端口 25 被 Cloudflare 封锁。连接从共享的 Cloudflare IP 发出。

• Email Service（Cloudflare 文档，在新标签页中打开）

  SMTP 之外的另一种选择：使用 smtp.mx.cloudflare.net 的配置通过 Worker 的 send_email binding 发送。

  不需要 SMTP 密码；发件地址必须使用已接入 Cloudflare Email Sending 的域名。

• Cron Triggers（Cloudflare 文档，在新标签页中打开）

  无需额外服务的后台任务：健康检查、更新检查和密钥轮换。

  每天 03:17 UTC，以及每小时第 17 分钟（见下文）。

• Workers Logs（Cloudflare 文档，在新标签页中打开）

  Worker 的请求和调用日志，显示在你的 Cloudflare 控制台中。

  在 wrangler.jsonc 中开启。邮件内容永远不会被记录。