INTEGRITY Dokumentace

Směrování e-mailů

Příchozí e-maily zaslané na vaši doménu směrujte do stávajících schránek, na Workery ke zpracování nebo na jiná cílová místa.

Nastavení domény

Než začnete používat Email Routing, nakonfigurujte svou doménu.

  1. V Cloudflare dashboardu přejděte na Compute > Email Service > Email Routing.

    Přejděte na Email Routing ↗
  2. Vyberte Onboard Domain.

  3. Vyberte doménu ve svém účtu Cloudflare. Volitelně zkontrolujte záznamy DNS, které Cloudflare přidá do vaší kořenové domény:

    • Záznamy MX pro směrování příchozích e-mailů do Cloudflare.
    • Záznam TXT pro SPF autorizující směrování e-mailů.
    • Záznam TXT pro DKIM zajišťující ověření směrovaných e-mailů.
  4. Vyberte Hotovo.

Jakmile je vaše doména přidána, můžete začít směrovat e-maily.

Nasměrujte svůj první e-mail

První e-mail můžete směrovat nastavením pravidel směrování v dashboardu, nebo zpracováním e-mailů pomocí Workers.

Nejjednodušší způsob směrování e-mailů je jejich přeposílání na existující e-mailové adresy.

Přidat cílovou adresu

Než vytvoříte směrovací pravidlo, přidejte a ověřte cílovou adresu, na kterou se budou přeposílané e-maily doručovat. Cílové adresy se spravují na úrovni účtu a lze je použít napříč doménami.

  1. V Cloudflare dashboardu přejděte na Compute > Email Service > Email Routing > Cílové adresy.

    Přejděte na Email Routing ↗
  2. V části Cílové adresy, zadejte do vloženého formuláře e-mailovou adresu, kterou chcete použít jako cíl, a odešlete ji.

  3. Otevřete ověřovací e-mail, který Cloudflare na tuto adresu zašle, a vyberte Ověřit e-mailovou adresu.

Úplné podrobnosti najdete v Přidat cílovou adresu.

Vytvořte pravidlo směrování

  1. V Cloudflare dashboardu přejděte na Compute > Email Service > Email Routing.

    Přejděte na Email Routing ↗
  2. Vyberte doménu, pro kterou chcete vytvořit e-mailovou adresu.

  3. Vyberte Pravidla směrování kartě.

  4. Vyberte Vytvořit pravidlo směrování.

  5. Nakonfigurujte své první pravidlo (například přeposílání e-mailů na [email protected] na vaši osobní e-mailovou adresu):

    • Vzor e-mailu: Zadejte lokální část e-mailové adresy (například support pro [email protected]), a vyberte svou doménu
    • Akce: Odeslat na e-mail
    • Cíl: Vaše osobní e-mailová adresa (například [email protected])
  6. Vyberte Save.

Otestujte své směrovací pravidlo

Ověřte, že vaše směrovací pravidlo funguje:

  1. Odešlete e-mail z jiného e-mailového účtu na nově vytvořenou adresu (například [email protected]). Odesílejte z účtu, který se liší od cílové adresy. Někteří poskytovatelé zprávy zahazují, pokud zjevně přicházejí ze stejného účtu, na který jsou doručovány.

  2. Zkontrolujte cílovou schránku, zda obsahuje přeposlaný e-mail.

  3. Pokud e-mail hned nevidíte, zkontrolujte složku spam.

K zpracování e-mailů vlastní logikou před přeposláním nebo odpovědí na ně použijte Workers.

Vytvořte Worker pro zpracování e-mailů

  1. Vytvořte nový projekt Worker:

    npm create cloudflare@latest email-processor

    Po zobrazení výzvy vyberte Worker „Hello World“ jako šablonu. Poté přejděte do adresáře projektu:

    cd email-processor
  2. Nainstalujte požadovaný balíček pro vytváření odpovědí na e-maily:

    npm install mimetext
  3. Přidejte nodejs_compat compatibility flag do konfiguračního souboru Wrangler. To je vyžadováno pro mimetext balíček:

    {
    	"compatibility_flags": ["nodejs_compat"],
    }
    compatibility_flags = [ "nodejs_compat" ]
  4. Vytvořte svůj email handler v src/index.ts:

    import { EmailMessage } from "cloudflare:email";
    import { createMimeMessage } from "mimetext";
    
    // ============================================
    // Configuration - Update these values
    // ============================================
    const YOUR_DOMAIN = "yourdomain.com"; // Replace with your verified domain
    const FORWARD_TO_EMAIL = "[email protected]"; // Replace with where you want emails forwarded
    
    export default {
    	async email(message, env, ctx): Promise<void> {
    		const sender = message.from;
    		const recipient = message.to;
    		const subject = message.headers.get("subject") || "";
    
    		console.log(
    			`Processing email from ${sender} to ${recipient} with subject ${subject}`,
    		);
    
    		// Route based on recipient
    		if (recipient.includes("support@")) {
    			// Send auto-reply
    			const msg = createMimeMessage();
    			const messageId = message.headers.get("Message-ID");
    			if (messageId) {
    				msg.setHeader("In-Reply-To", messageId);
    				msg.setHeader("References", messageId);
    			}
    			msg.setSender({
    				name: "Support Team",
    				addr: `support@${YOUR_DOMAIN}`,
    			});
    			msg.setRecipient(message.from);
    			msg.setSubject(`Re: ${subject}`);
    
    			// Add plain text version
    			msg.addMessage({
    				contentType: "text/plain",
    				data: "Thank you for contacting support. Your ticket number is 123.\n\nA member of our support team will get back to you shortly.",
    			});
    
    			// Add HTML version
    			msg.addMessage({
    				contentType: "text/html",
    				data: "<p>Thank you for contacting support. Your ticket number is <strong>123</strong>.</p><p>A member of our support team will get back to you shortly.</p>",
    			});
    
    			const replyMessage = new EmailMessage(
    				`support@${YOUR_DOMAIN}`,
    				message.from,
    				msg.asRaw(),
    			);
    
    			await message.reply(replyMessage);
    
    			// Forward to support team
    			await message.forward(FORWARD_TO_EMAIL);
    		} else {
    			// Default: forward to admin
    			await message.forward(FORWARD_TO_EMAIL);
    		}
    	},
    } satisfies ExportedHandler<Env>;
  5. Nasaďte svůj Worker:

    npm run deploy

Nakonfigurujte směrování na Worker

  1. V Cloudflare dashboardu přejděte na Compute > Email Service > Email Routing.

    Přejděte na Email Routing ↗
  2. Vyberte doménu, pro kterou chcete nakonfigurovat směrování.

  3. Vyberte Pravidla směrování kartě.

  4. Vyberte Vytvořit pravidlo směrování.

  5. Nakonfigurujte směrování Worker:

    • Vzor e-mailu: Zadejte lokální část e-mailové adresy (například support pro [email protected]), a vyberte svou doménu
    • Akce: Odeslat do Workeru
    • Worker: Vyberte svůj email-processor Worker
  6. Vyberte Save.

Otestujte směrování e-mailů

Po nakonfigurování směrovacího pravidla otestujte, že funguje:

  1. Odešlete e-mail ze svého osobního e-mailového účtu na nakonfigurovanou adresu (například [email protected]).

  2. Zkontrolujte svůj FORWARD_TO_EMAIL schránku, zda neobsahuje přeposlaný e-mail.

  3. Pokud byl e-mail příjemce support@, měli byste na svou osobní e-mailovou adresu obdržet také automatickou odpověď.

Další kroky

Nyní, když umíte směrovat e-maily, si můžete prohlédnout pokročilé funkce: