Yuva Email Worker pro Cloudflare

E-mail podpory přes Cloudflare.Žádný poštovní server k provozu.

Cloudflare® Email Routing přijímá poštu pro vaše adresy podpory a open-source Yuva Email Worker předá každou zprávu Yuvě podepsanou. Dorazí do vaší sdílené schránky jako konverzace, kterou odpovídá váš tým.

Přečíst příručku k nastavení Zdroj Workeru na GitHubu →

Co to je

Email Routing vpředu

Cloudflare Email Routing se stane MX vaší domény a přijímá poštu. Yuva nenaslouchá na SMTP, takže není co instalovat ani záplatovat.

Malý open-source Worker

Yuva Email Worker přečte surovou zprávu a obálku, podepíše požadavek a odešle ho Yuvě. Parsování, vlákna a rozhodování o spamu zůstávají na serveru.

Skutečné konverzace

Pošta na adresu podpory otevře nebo naváže konverzaci ve schránce a tým odpovídá ze stejného panelu jako u chatu a zpráv z aplikací.

Jak se zpráva dostane od zákazníka k vašemu týmu

1Zákazník píše na jednu z vašich adres podpory, například support@example.com.
2Cloudflare Email Routing zprávu přijme a předá ji Yuva Email Workeru.
3Worker podepíše surovou zprávu, obě obálkové adresy a časové razítko pomocí HMAC-SHA256 s tajným klíčem, který sdílíte s Yuvou, a odešle je na /ingress/email na vašem serveru Yuva.
4Yuva před čtením zprávy ověří podpis a to, že časové razítko je v rozmezí 5 minut. Požadavek se špatným podpisem je odmítnut.
5Yuva najde e-mailový kanál podle adresy příjemce a zprávu zařadí podle In-Reply-To a References do konverzace, do které patří. Cokoli jiného zahájí novou konverzaci. Odpověď konverzaci znovu otevře.
6Váš tým odpovídá v panelu. Odpověď se odešle přes vlastní SMTP účet e-mailového kanálu, například Amazon SES, Postmark nebo váš vlastní relay, ze stejné adresy a ve stejném vlákně. Odpovědi neprocházejí Workerem.

Odmítnutí se dostanou k odesílateli

Když Yuva zprávu natrvalo odmítne, například kvůli neznámé adrese, blokovanému odesílateli nebo příliš velké zprávě, Worker ji odmítne a odesílatel dostane trvalou chybu SMTP s důvodem od Yuvy.

Pokud je Yuva nedostupná

Pokud Yuva odpoví chybou serveru, neodpoví do 20 sekund nebo není dosažitelná, může Worker zprávu přeposlat na adresu, kterou zvolíte, pokud nastavíte FALLBACK_FORWARD. Tato adresa musí být ověřeným cílem v Email Routing. Zpráva pak dorazí jako obyčejné přeposlání a v Yuvě se neobjeví. Bez FALLBACK_FORWARD doručení selže s chybou a odesílající server to může později zkusit znovu.

Nastavte to v několika krocích

Potřebujete server Yuva a účet Cloudflare, který spravuje doménu.

1
V Yuvě otevřete Nastavení → vaše schránka → Kanály → E-mail a přidejte adresu podpory. Nastavte na serveru tajný klíč a restartujte ho:
```
YUVA_INGRESS_SECRET=<openssl rand -hex 32>
YUVA_INGRESS_AUTHSERV_ID=mx.cloudflare.net
```

Nasaďte Worker do svého účtu Cloudflare se stejným tajným klíčem:

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

3
V panelu Cloudflare otevřete svou doménu → Email → Email Routing a zapněte ho. Cloudflare přidá své záznamy MX a SPF.
4
V části Routing rules pošlete každou adresu podpory Workeru yuva-edge. U zachytávacího kanálu na něj nasměrujte zachytávací pravidlo.
5
Odešlete testovací zprávu a sledujte, jak se v panelu objeví konverzace.

Volitelné: zachovejte poštu během výpadku přidáním záložní adresy do příkazu k nasazení:

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

Email Routing se stane MX domény, proto použijte doménu nebo subdoménu, kterou nezpracovává žádný jiný poštovní server.

Přečíst příručku k nastavení →

Není vázáno na Cloudflare

Worker je jeden ze způsobů, jak volat /ingress/email. Kterýkoli poštovní server nebo relay může odeslat surovou zprávu se stejnými podepsanými hlavičkami a poštovní server, který doručuje příkazu, může zprávu předat do yuva ingest-email. Formát požadavku je zdokumentován v README Workeru.

Přečíst kontrakt ingress →Další způsoby, jak přenést poštu →

Otázky a odpovědi

Musím provozovat poštovní server?

Ne pro příchozí poštu. Yuva nenaslouchá na SMTP; poštu přijímá Cloudflare Email Routing a Worker ji předá dál. Odpovědi potřebují SMTP účet pro e-mailový kanál, například Amazon SES, Postmark nebo vlastní relay.

Co se stane, když Yuva nefunguje?

Při nastaveném FALLBACK_FORWARD se zpráva přepošle na tuto adresu. Bez něj doručení selže a odesílající server to může zkusit znovu. Zprávy, které Yuva odmítne záměrně, například pošta na neznámou adresu, se odmítnou, nepřepošlou.

Které domény a adresy mohu použít?

Libovolná doména, kterou spravujete v Cloudflare a jejíž poštu nezpracovává jiný server, protože se Email Routing stane jejím MX. Každý e-mailový kanál má adresu, nebo zachytávací *@example.com pro všechny adresy domény, které žádný kanál nemá přesně. Subadresa jako support+billing@example.com dorazí do kanálu support@example.com.

Jak velká může být zpráva?

Zpráva může mít včetně příloh až 25 MiB, což je limit Cloudflare Email Routing. Yuva uchovává až 50 příloh na zprávu, každou v rámci limitu velikosti příloh serveru (výchozí 25 MiB) a povolených typů; zbytek vynechá.

Může někdo podvrhnout poštu na můj server Yuva?

Yuva odmítne každý požadavek bez platného podpisu HMAC nebo s časovým razítkem o více než 5 minut mimo, a to dřív, než přečte tělo. Tajný klíč nikomu neprozrazujte.

Používá Yuva výsledek DMARC z Cloudflare?

Ano, pokud nastavíte YUVA_INGRESS_AUTHSERV_ID na mx.cloudflare.net. Yuva pak čte verdikt DMARC, který přidává Email Routing. Nová konverzace, která v DMARC neprojde, je označena jako spam.

Cloudflare, logo Cloudflare a Cloudflare Workers jsou ochranné známky a/nebo registrované ochranné známky společnosti Cloudflare, Inc. ve Spojených státech a dalších jurisdikcích. Yuva je nezávislý open-source projekt, není s Cloudflare nijak spojen ani jí schválen.