通过 Cloudflare 接收支持邮件。无需运行邮件服务器。

是什么

一封邮件如何从客户送达你的团队

1. 1客户给你的某个支持地址发信，例如 support@example.com。
2. 2Cloudflare Email Routing 接收邮件并交给 Yuva Email Worker。
3. 3Worker 使用你与 Yuva 共享的密钥，以 HMAC-SHA256 对原始邮件、两个信封地址和时间戳签名，并发送到你 Yuva 服务器的 /ingress/email。
4. 4在读取邮件之前，Yuva 会检查签名以及时间戳是否在 5 分钟之内。签名错误的请求会被拒绝。
5. 5Yuva 根据收件地址找到邮件渠道，并按 In-Reply-To 和 References 把邮件归入它所属的对话。其他情况会开启新对话。回复会重新打开对话。
6. 6你的团队在面板中回复。回复通过邮件渠道自己的 SMTP 账号发送，例如 Amazon SES、Postmark 或你自己的中继，使用同一个地址并在同一个线程中。回复不经过 Worker。

几步即可完成设置

你需要一台 Yuva 服务器，以及一个管理该域名的 Cloudflare 账号。

1. 1

   在 Yuva 中，打开设置 → 你的收件箱 → 渠道 → 邮件，添加支持地址。在服务器上设置一个密钥并重启：

   YUVA_INGRESS_SECRET=<openssl rand -hex 32>
   YUVA_INGRESS_AUTHSERV_ID=mx.cloudflare.net

2. 2

   使用同一个密钥，将 Worker 部署到你的 Cloudflare 账号：

   cd edge
   bun install
   bunx wrangler login
   bunx wrangler secret put INGRESS_SECRET
   bunx wrangler deploy --var YUVA_URL:https://support.example.com

3. 3

   在 Cloudflare 控制台中，打开你的域名 → Email → Email Routing 并启用。Cloudflare 会添加它的 MX 和 SPF 记录。

4. 4

   在 Routing rules 下，把每个支持地址发送到名为 yuva-edge 的 Worker。对于兜底渠道，把兜底规则指向它。

5. 5

   发送一条测试消息，看对话出现在面板中。

6. 6

   可选：在部署命令中添加备用地址，以便在故障期间保留邮件：

   bunx wrangler deploy --var YUVA_URL:https://support.example.com --var FALLBACK_FORWARD:you@example.org

Email Routing 会成为域名的 MX，所以请使用没有其他邮件服务器处理的域名或子域名。

不与 Cloudflare 绑定

Worker 是调用 /ingress/email 的一种方式。任何邮件服务器或中继都可以用相同的签名标头发送原始邮件，而投递给命令的邮件服务器可以把邮件通过管道交给 yuva ingest-email。请求格式记录在 Worker 的 README 中。

问与答