INTEGRITY Dokumentace

← Cloudflare Email Service / email-service / local-development

Směrování e-mailů

Otestujte chování směrování e-mailů lokálně pomocí wrangler dev k simulaci příchozích e-mailů a ověření logiky směrování před nasazením.

Předpoklady

  1. Zaregistrujte si účet Cloudflare ↗.
  2. Nainstalujte Node.js ↗.

Správce verzí Node.js

Použijte správce verzí Node, jako je Volta ↗ nebo nvm ↗ abyste se vyhnuli problémům s oprávněními a mohli měnit verze Node.js. Wrangler, o kterém se dozvíte dále v této příručce, vyžaduje verzi Node 16.17.0 nebo novější.

Konfigurace

Nakonfigurujte soubor Wrangler:

{
	"name": "email-routing-worker",
	// Set this to today's date
	"compatibility_date": "2026-08-28",
}
name = "email-routing-worker"
# Set this to today's date
compatibility_date = "2026-08-28"

Základní směrovací Worker

import * as PostalMime from "postal-mime";

export default {
	async email(message, env, ctx) {
		// Parse the raw email message
		const parser = new PostalMime.default();
		const rawEmail = new Response(message.raw);
		const email = await parser.parse(await rawEmail.arrayBuffer());

		console.log("Received email:", {
			from: message.from,
			to: message.to,
			subject: email.subject,
			text: email.text,
			html: email.html,
		});

		// Route based on recipient
		if (message.to.includes("support@")) {
			await message.forward("[email protected]");
		} else {
			await message.forward("[email protected]");
		}
	},
};

Testování

Spusťte svůj vývojový server:

npx wrangler dev

Odešlete testovací e-mail přes lokální koncový bod. Tělo požadavku musí obsahovat nezpracovanou e-mailovou zprávu ve formátu RFC 5322 ↗ formát a zpráva musí obsahovat Message-ID hlavičku:

curl --request POST 'http://localhost:8787/cdn-cgi/handler/email' \
  --url-query '[email protected]' \
  --url-query '[email protected]' \
  --data-raw 'Received: from smtp.example.com (127.0.0.1)
        by cloudflare-email.com (unknown) id 4fwwffRXOpyR
        for <[email protected]>; Tue, 27 Aug 2024 15:50:20 +0000
From: "John" <[email protected]>
Reply-To: [email protected]
To: [email protected]
Subject: Testing Email Workers Local Dev
Content-Type: text/html; charset="windows-1252"
X-Mailer: Curl
Date: Tue, 27 Aug 2024 08:49:44 -0700
Message-ID: <6114391943504294873000@ZSH-GHOSTTY>

Hi there'

Tím se do konzole vypíše zpracovaná struktura e-mailu:

{
	"headers": [
		{
			"key": "received",
			"value": "from smtp.example.com (127.0.0.1) by cloudflare-email.com (unknown) id 4fwwffRXOpyR for <[email protected]>; Tue, 27 Aug 2024 15:50:20 +0000"
		},
		{ "key": "from", "value": "\"John\" <[email protected]>" },
		{ "key": "reply-to", "value": "[email protected]" },
		{ "key": "to", "value": "[email protected]" },
		{ "key": "subject", "value": "Testing Email Workers Local Dev" },
		{ "key": "content-type", "value": "text/html; charset=\"windows-1252\"" },
		{ "key": "x-mailer", "value": "Curl" },
		{ "key": "date", "value": "Tue, 27 Aug 2024 08:49:44 -0700" },
		{
			"key": "message-id",
			"value": "<6114391943504294873000@ZSH-GHOSTTY>"
		}
	],
	"from": { "address": "[email protected]", "name": "John" },
	"to": [{ "address": "[email protected]", "name": "" }],
	"replyTo": [{ "address": "[email protected]", "name": "" }],
	"subject": "Testing Email Workers Local Dev",
	"messageId": "<6114391943504294873000@ZSH-GHOSTTY>",
	"date": "2024-08-27T15:49:44.000Z",
	"html": "Hi there\n",
	"attachments": []
}

Další kroky