透過 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 中。

問與答