← Cloudflare Email Service / email-service / get-started
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.
-
V Cloudflare dashboardu přejděte na Compute > Email Service > Email Routing.
Přejděte na Email Routing ↗ -
Vyberte Onboard Domain.
-
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ů.
-
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.
-
V Cloudflare dashboardu přejděte na Compute > Email Service > Email Routing > Cílové adresy.
Přejděte na Email Routing ↗ -
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.
-
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í
-
V Cloudflare dashboardu přejděte na Compute > Email Service > Email Routing.
Přejděte na Email Routing ↗ -
Vyberte doménu, pro kterou chcete vytvořit e-mailovou adresu.
-
Vyberte Pravidla směrování kartě.
-
Vyberte Vytvořit pravidlo směrování.
-
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
supportpro[email protected]), a vyberte svou doménu - Akce: Odeslat na e-mail
- Cíl: Vaše osobní e-mailová adresa (například
[email protected])
- Vzor e-mailu: Zadejte lokální část e-mailové adresy (například
-
Vyberte Save.
Otestujte své směrovací pravidlo
Ověřte, že vaše směrovací pravidlo funguje:
-
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. -
Zkontrolujte cílovou schránku, zda obsahuje přeposlaný e-mail.
-
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ů
-
Vytvořte nový projekt Worker:
npm create cloudflare@latest email-processorPo zobrazení výzvy vyberte Worker „Hello World“ jako šablonu. Poté přejděte do adresáře projektu:
cd email-processor -
Nainstalujte požadovaný balíček pro vytváření odpovědí na e-maily:
npm install mimetext -
Přidejte
nodejs_compatcompatibility flag do konfiguračního souboru Wrangler. To je vyžadováno promimetextbalíček:{ "compatibility_flags": ["nodejs_compat"], }compatibility_flags = [ "nodejs_compat" ] -
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>; -
Nasaďte svůj Worker:
npm run deploy
Nakonfigurujte směrování na Worker
-
V Cloudflare dashboardu přejděte na Compute > Email Service > Email Routing.
Přejděte na Email Routing ↗ -
Vyberte doménu, pro kterou chcete nakonfigurovat směrování.
-
Vyberte Pravidla směrování kartě.
-
Vyberte Vytvořit pravidlo směrování.
-
Nakonfigurujte směrování Worker:
- Vzor e-mailu: Zadejte lokální část e-mailové adresy (například
supportpro[email protected]), a vyberte svou doménu - Akce: Odeslat do Workeru
- Worker: Vyberte svůj
email-processorWorker
- Vzor e-mailu: Zadejte lokální část e-mailové adresy (například
-
Vyberte Save.
Otestujte směrování e-mailů
Po nakonfigurování směrovacího pravidla otestujte, že funguje:
-
Odešlete e-mail ze svého osobního e-mailového účtu na nakonfigurovanou adresu (například
[email protected]). -
Zkontrolujte svůj
FORWARD_TO_EMAILschránku, zda neobsahuje přeposlaný e-mail. -
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:
- Odesílání odchozích e-mailů - Odesílání e-mailů z vašich aplikací
- Referenční dokumentace API - Kompletní dokumentace API pro směrování
- Příklady - Vzory směrování z praxe