Yuva Email Worker za Cloudflare

E-pošta za podporo prek Cloudflare.Poštnega strežnika ni treba zagnati.

Cloudflare® Email Routing sprejema pošto vaših naslovov za podporo, odprtokodni Yuva Email Worker pa vsako sporočilo preda Yuvi, podpisano. V vaš skupni nabiralnik pride kot pogovor, na katerega odgovarja vaša ekipa.

Preberi vodnik za nastavitev Izvorna koda Workerja na GitHubu →

Kaj je

Email Routing spredaj

Cloudflare Email Routing postane MX vaše domene in sprejema pošto. Yuva ne posluša SMTP, zato ni poštnega strežnika, ki bi ga morali namestiti ali posodabljati.

Majhen odprtokodni Worker

Yuva Email Worker prebere surovo sporočilo in ovojnico, podpiše zahtevo in jo pošlje Yuvi. Razčlenjevanje, nitenje in odločitve o neželeni pošti ostanejo na strežniku.

Pravi pogovori

Pošta na naslov za podporo odpre ali nadaljuje pogovor v nabiralniku, ekipa pa odgovarja iz iste nadzorne plošče kot pri klepetu in sporočilih iz aplikacij.

Kako sporočilo pride od stranke do vaše ekipe

1Stranka piše na enega od vaših naslovov za podporo, na primer support@example.com.
2Cloudflare Email Routing sprejme sporočilo in ga preda Yuva Email Workerju.
3Worker podpiše surovo sporočilo, oba naslova ovojnice in časovni žig s HMAC-SHA256 s skrivnostjo, ki jo delite z Yuvo, ter jih pošlje na /ingress/email na vašem strežniku Yuva.
4Yuva pred branjem sporočila preveri podpis in da je časovni žig v 5 minutah. Zahteva z napačnim podpisom je zavrnjena.
5Yuva poišče e-poštni kanal za naslov prejemnika in sporočilo po In-Reply-To in References uvrsti v pogovor, kamor spada. Vse drugo začne nov pogovor. Odgovor pogovor znova odpre.
6Vaša ekipa odgovarja v nadzorni plošči. Odgovor se pošlje prek lastnega računa SMTP e-poštnega kanala, na primer Amazon SES, Postmark ali vašega releja, z istega naslova in v isti niti. Odgovori ne gredo prek Workerja.

Zavrnitve pridejo do pošiljatelja

Ko Yuva sporočilo dokončno zavrne, na primer zaradi neznanega naslova, blokiranega pošiljatelja ali prevelikega sporočila, ga Worker zavrne, pošiljatelj pa prejme trajno napako SMTP z Yuvinim razlogom.

Če Yuva ni dosegljiva

Če Yuva odgovori z napako strežnika, ne odgovori v 20 sekundah ali ni dosegljiva, lahko Worker sporočilo posreduje na naslov po vaši izbiri, če nastavite FALLBACK_FORWARD. Ta naslov mora biti preverjen cilj v Email Routing. Sporočilo nato pride kot navadno posredovanje in se v Yuvi ne prikaže. Brez FALLBACK_FORWARD dostava spodleti z napako, pošiljateljev strežnik pa lahko poskusi znova pozneje.

Nastavite v nekaj korakih

Potrebujete strežnik Yuva in račun Cloudflare, ki upravlja domeno.

1
V Yuvi odprite Nastavitve → vaš nabiralnik → Kanali → E-pošta in dodajte naslov za podporo. Na strežniku nastavite skrivnost in ga znova zaženite:
```
YUVA_INGRESS_SECRET=<openssl rand -hex 32>
YUVA_INGRESS_AUTHSERV_ID=mx.cloudflare.net
```

Namestite Worker v svoj račun Cloudflare z isto skrivnostjo:

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 nadzorni plošči Cloudflare odprite svojo domeno → Email → Email Routing in ga vklopite. Cloudflare doda svoja zapisa MX in SPF.
4
V Routing rules vsak naslov za podporo pošljite Workerju yuva-edge. Pri zbirnem kanalu nanj usmerite zbirno pravilo.
5
Pošljite testno sporočilo in opazujte, kako se pogovor pojavi v nadzorni plošči.

Neobvezno: med izpadom obdržite pošto, tako da ukazu za namestitev dodate rezervni naslov:

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

Email Routing postane MX domene, zato uporabite domeno ali poddomeno, ki je ne obdeluje noben drug poštni strežnik.

Preberi vodnik za nastavitev →

Ni vezano na Cloudflare

Worker je en način klica /ingress/email. Kateri koli poštni strežnik ali rele lahko pošlje surovo sporočilo z istimi podpisanimi glavami, poštni strežnik, ki dostavlja ukazu, pa lahko sporočilo prek cevi preda yuva ingest-email. Oblika zahteve je dokumentirana v README Workerja.

Preberi pogodbo ingress →Drugi načini za prenos pošte →

Vprašanja in odgovori

Ali moram zagnati poštni strežnik?

Ne za dohodno pošto. Yuva ne posluša SMTP; pošto sprejme Cloudflare Email Routing, Worker pa jo preda naprej. Odgovori potrebujejo račun SMTP za e-poštni kanal, na primer Amazon SES, Postmark ali vaš lasten rele.

Kaj se zgodi, ko Yuva ne deluje?

Ko je nastavljen FALLBACK_FORWARD, se sporočilo namesto tega posreduje na ta naslov. Brez njega dostava spodleti, pošiljateljev strežnik pa lahko poskusi znova. Sporočila, ki jih Yuva zavrne namerno, na primer pošta na neznan naslov, so zavrnjena in ne posredovana.

Katere domene in naslove lahko uporabim?

Katera koli domena, ki jo upravljate v Cloudflare in katere pošte ne obdeluje noben drug strežnik, ker Email Routing postane njen MX. Vsak e-poštni kanal ima naslov ali zbirni naslov *@example.com za vse naslove domene, ki jih noben kanal nima natančno. Podnaslov, kot je support+billing@example.com, pride v kanal naslova support@example.com.

Kako veliko je lahko sporočilo?

Sporočilo je lahko skupaj s prilogami veliko do 25 MiB, kar je omejitev Cloudflare Email Routing. Yuva obdrži do 50 prilog na sporočilo, vsako v okviru strežnikove omejitve velikosti prilog (privzeto 25 MiB) in dovoljenih vrst; preostale izpusti.

Ali lahko kdo ponaredi pošto za moj strežnik Yuva?

Yuva zavrne vsako zahtevo brez veljavnega podpisa HMAC ali s časovnim žigom, ki odstopa za več kot 5 minut, preden prebere telo. Skrivnost obdržite zase.

Ali Yuva uporablja rezultat DMARC iz Cloudflare?

Da, ko nastavite YUVA_INGRESS_AUTHSERV_ID na mx.cloudflare.net. Yuva nato prebere razsodbo DMARC, ki jo doda Email Routing. Nov pogovor, ki ne prestane DMARC, se označi kot neželena pošta.

Cloudflare, logotip Cloudflare in Cloudflare Workers so blagovne znamke in/ali registrirane blagovne znamke družbe Cloudflare, Inc. v Združenih državah in drugih jurisdikcijah. Yuva je neodvisen odprtokodni projekt, ni povezan s Cloudflare in ga Cloudflare ni potrdil.