Yuva Email Worker Cloudflarelle

Tukisähköposti Cloudflaren kautta.Ei sähköpostipalvelinta ylläpidettäväksi.

Cloudflare® Email Routing vastaanottaa tukiosoitteidesi postin, ja avoimen lähdekoodin Yuva Email Worker toimittaa jokaisen viestin Yuvalle allekirjoitettuna. Se päätyy jaettuun postilaatikkoosi keskusteluna, johon tiimisi vastaa.

Lue käyttöönotto-opas Workerin lähdekoodi GitHubissa →

Mikä se on

Email Routing edessä

Cloudflare Email Routingista tulee verkkotunnuksesi MX, ja se vastaanottaa postin. Yuva ei kuuntele SMTP:tä, joten sähköpostipalvelinta ei tarvitse asentaa eikä pitää ajan tasalla.

Pieni avoimen lähdekoodin Worker

Yuva Email Worker lukee raakaviestin ja kirjekuoren, allekirjoittaa pyynnön ja lähettää sen Yuvalle. Jäsentäminen, ketjutus ja roskapostipäätökset pysyvät palvelimella.

Oikeita keskusteluja

Tukiosoitteeseen tuleva posti avaa tai jatkaa keskustelua postilaatikossa, ja tiimi vastaa samasta paneelista kuin chattiin ja sovellusviesteihin.

Miten viesti pääsee asiakkaalta tiimillesi

1Asiakas kirjoittaa johonkin tukiosoitteistasi, esimerkiksi support@example.com.
2Cloudflare Email Routing vastaanottaa viestin ja välittää sen Yuva Email Workerille.
3Worker allekirjoittaa raakaviestin, molemmat kirjekuoriosoitteet ja aikaleiman HMAC-SHA256:lla Yuvan kanssa jakamallasi salaisuudella ja lähettää ne Yuva-palvelimesi osoitteeseen /ingress/email.
4Yuva tarkistaa allekirjoituksen ja sen, että aikaleima on 5 minuutin sisällä, ennen kuin se lukee viestin. Pyyntö, jonka allekirjoitus on väärä, hylätään.
5Yuva löytää vastaanottajan osoitteen sähköpostikanavan ja ketjuttaa viestin In-Reply-To- ja References-otsakkeiden perusteella keskusteluun, johon se kuuluu. Kaikki muu aloittaa uuden keskustelun. Vastaus avaa keskustelun uudelleen.
6Tiimisi vastaa paneelissa. Vastaus lähetetään sähköpostikanavan oman SMTP-tilin kautta, kuten Amazon SES, Postmark tai oma relay, samasta osoitteesta ja samassa ketjussa. Vastaukset eivät kulje Workerin kautta.

Hylkäykset tavoittavat lähettäjän

Kun Yuva hylkää viestin lopullisesti, esimerkiksi tuntemattoman osoitteen, estetyn lähettäjän tai liian suuren viestin vuoksi, Worker hylkää sen ja lähettäjä saa pysyvän SMTP-virheen Yuvan perusteluineen.

Jos Yuvaa ei tavoiteta

Jos Yuva vastaa palvelinvirheellä, ei vastaa 20 sekunnissa tai ei ole tavoitettavissa, Worker voi välittää viestin valitsemaasi osoitteeseen, kunhan olet asettanut FALLBACK_FORWARDin. Osoitteen on oltava vahvistettu kohde Email Routingissa. Viesti saapuu silloin tavallisena edelleenlähetyksenä eikä näy Yuvassa. Ilman FALLBACK_FORWARDia toimitus epäonnistuu virheeseen ja lähettävä palvelin voi yrittää myöhemmin uudelleen.

Määritä se muutamassa vaiheessa

Tarvitset Yuva-palvelimen ja Cloudflare-tilin, joka hallinnoi verkkotunnusta.

1
Avaa Yuvassa Asetukset → postilaatikkosi → Kanavat → Sähköposti ja lisää tukiosoite. Aseta palvelimelle salaisuus ja käynnistä se uudelleen:
```
YUVA_INGRESS_SECRET=<openssl rand -hex 32>
YUVA_INGRESS_AUTHSERV_ID=mx.cloudflare.net
```

Ota Worker käyttöön Cloudflare-tililläsi samalla salaisuudella:

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

3
Avaa Cloudflaren hallintapaneelissa verkkotunnuksesi → Email → Email Routing ja ota se käyttöön. Cloudflare lisää omat MX- ja SPF-tietueensa.
4
Reititys-säännöissä (Routing rules) ohjaa jokainen tukiosoite Workerille yuva-edge. Kaikenkattavalle kanavalle osoita kaikenkattava sääntö siihen.
5
Lähetä testiviesti ja katso keskustelun ilmestyvän paneeliin.

Valinnainen: säilytä posti katkon aikana lisäämällä varaosoite käyttöönottokomentoon:

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

Email Routingista tulee verkkotunnuksen MX, joten käytä verkkotunnusta tai alidomainia, jota mikään muu sähköpostipalvelin ei käsittele.

Lue käyttöönotto-opas →

Ei sidottu Cloudflareen

Worker on yksi tapa kutsua /ingress/email. Mikä tahansa sähköpostipalvelin tai relay voi lähettää raakaviestin samoilla allekirjoitetuilla otsakkeilla, ja komennolle toimittava sähköpostipalvelin voi putkittaa viestin komentoon yuva ingest-email. Pyyntömuoto on dokumentoitu Workerin README:ssä.

Lue ingress-sopimus →Muita tapoja tuoda postia →

Kysymykset ja vastaukset

Tarvitsenko sähköpostipalvelimen?

Ei saapuvalle postille. Yuva ei kuuntele SMTP:tä; Cloudflare Email Routing vastaanottaa postin ja Worker välittää sen eteenpäin. Vastauksiin tarvitaan sähköpostikanavan SMTP-tili, kuten Amazon SES, Postmark tai oma relay.

Mitä tapahtuu, kun Yuva on alhaalla?

Kun FALLBACK_FORWARD on asetettu, viesti välitetään sen sijaan siihen osoitteeseen. Ilman sitä toimitus epäonnistuu ja lähettävä palvelin voi yrittää uudelleen. Viestit, jotka Yuva hylkää tarkoituksella, kuten posti tuntemattomaan osoitteeseen, hylätään eikä niitä välitetä.

Mitä verkkotunnuksia ja osoitteita voin käyttää?

Mikä tahansa Cloudflaressa hallinnoimasi verkkotunnus, jonka postia ei käsittele mikään muu palvelin, koska Email Routingista tulee sen MX. Jokaisella sähköpostikanavalla on osoite tai kaikenkattava *@example.com verkkotunnuksen kaikille osoitteille, joita millään kanavalla ei ole täsmälleen. Aliosoite kuten support+billing@example.com päätyy osoitteen support@example.com kanavalle.

Kuinka suuri viesti voi olla?

Viesti voi olla enintään 25 MiB liitteineen, mikä on Cloudflare Email Routingin raja. Yuva säilyttää enintään 50 liitettä viestiä kohden, kunkin palvelimen liitekokorajan (oletuksena 25 MiB) ja sallittujen tyyppien rajoissa; loput se jättää pois.

Voiko joku väärentää postia Yuva-palvelimelleni?

Yuva hylkää jokaisen pyynnön, jolla ei ole kelvollista HMAC-allekirjoitusta tai jonka aikaleima poikkeaa yli 5 minuuttia, ennen kuin se lukee rungon. Pidä salaisuus itselläsi.

Käyttääkö Yuva Cloudflaren DMARC-tulosta?

Kyllä, kun asetat YUVA_INGRESS_AUTHSERV_ID:n arvoksi mx.cloudflare.net. Yuva lukee silloin DMARC-tuomion, jonka Email Routing lisää. Uusi keskustelu, joka ei läpäise DMARC:ia, merkitään roskapostiksi.

Cloudflare, Cloudflare-logo ja Cloudflare Workers ovat Cloudflare, Inc:n tavaramerkkejä ja/tai rekisteröityjä tavaramerkkejä Yhdysvalloissa ja muilla lainkäyttöalueilla. Yuva on itsenäinen avoimen lähdekoodin projekti, joka ei ole Cloudflaren sidosryhmä eikä sen hyväksymä.