Yuva Email Worker för Cloudflare

Support-mejl via Cloudflare.Ingen mejlserver att driva.

Cloudflare® Email Routing tar emot mejlen till dina supportadresser, och Yuva Email Worker med öppen källkod lämnar varje meddelande till Yuva, signerat. Det landar i din delade inkorg som en konversation som ditt team svarar på.

Läs installationsguiden Workers källkod på GitHub →

Vad det är

Email Routing framför

Cloudflare Email Routing blir din domäns MX och tar emot mejlen. Yuva lyssnar inte på SMTP, så det finns ingen mejlserver att installera eller hålla uppdaterad.

En liten Worker med öppen källkod

Yuva Email Worker läser det råa meddelandet och kuvertet, signerar begäran och skickar den till Yuva. Tolkning, trådning och skräppostbeslut stannar på servern.

Riktiga konversationer

Mejl till en supportadress öppnar eller fortsätter en konversation i inkorgen, och teamet svarar från samma panel som för chatt och appmeddelanden.

Hur ett meddelande tar sig från kunden till ditt team

1En kund skriver till en av dina supportadresser, till exempel support@example.com.
2Cloudflare Email Routing tar emot meddelandet och lämnar över det till Yuva Email Worker.
3Worker signerar det råa meddelandet, båda kuvertadresserna och en tidsstämpel med HMAC-SHA256 under en hemlighet du delar med Yuva och skickar dem till /ingress/email på din Yuva-server.
4Yuva kontrollerar signaturen och att tidsstämpeln ligger inom 5 minuter innan den läser meddelandet. En begäran med fel signatur avvisas.
5Yuva hittar mejlkanalen för mottagaradressen och trådar meddelandet med In-Reply-To och References i den konversation det hör till. Allt annat startar en ny konversation. Ett svar öppnar konversationen igen.
6Ditt team svarar i panelen. Svaret skickas via mejlkanalens eget SMTP-konto, som Amazon SES, Postmark eller ditt eget relä, från samma adress och i samma tråd. Svar går inte via Worker.

Avvisningar når avsändaren

När Yuva avvisar ett meddelande för gott, till exempel på grund av en okänd adress, en blockerad avsändare eller ett för stort meddelande, avvisar Worker det och avsändaren får ett permanent SMTP-fel med Yuvas skäl.

Om Yuva inte går att nå

Om Yuva svarar med ett serverfel, inte svarar inom 20 sekunder eller inte går att nå kan Worker vidarebefordra meddelandet till en adress du väljer, så länge du har satt FALLBACK_FORWARD. Adressen måste vara ett verifierat mål i Email Routing. Meddelandet kommer då som en vanlig vidarebefordran och syns inte i Yuva. Utan FALLBACK_FORWARD misslyckas leveransen med ett fel och den skickande servern kan försöka igen senare.

Sätt upp det i några steg

Du behöver en Yuva-server och ett Cloudflare-konto som hanterar domänen.

1
Öppna Inställningar → din inkorg → Kanaler → Mejl i Yuva och lägg till supportadressen. Ange en hemlighet på servern och starta om den:
```
YUVA_INGRESS_SECRET=<openssl rand -hex 32>
YUVA_INGRESS_AUTHSERV_ID=mx.cloudflare.net
```

Distribuera Worker till ditt Cloudflare-konto med samma hemlighet:

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

3
Öppna din domän → Email → Email Routing i Cloudflare-panelen och slå på det. Cloudflare lägger till sina MX- och SPF-poster.
4
Under Routing rules skickar du varje supportadress till Worker yuva-edge. För en upplockningskanal pekar du upplockningsregeln på den.
5
Skicka ett testmeddelande och se konversationen dyka upp i panelen.
6
Valfritt: behåll mejl under ett avbrott genom att lägga till en reservadress i distributionskommandot:
```
bunx wrangler deploy --var YUVA_URL:https://support.example.com --var FALLBACK_FORWARD:you@example.org
```

Email Routing blir domänens MX, så använd en domän eller underdomän som ingen annan mejlserver hanterar.

Läs installationsguiden →

Inte bundet till Cloudflare

Worker är ett sätt att anropa /ingress/email. Vilken mejlserver eller vilket relä som helst kan skicka det råa meddelandet med samma signerade rubriker, och en mejlserver som levererar till ett kommando kan skicka meddelandet vidare till yuva ingest-email. Begärans format är dokumenterat i Workers README.

Läs ingress-kontraktet →Andra sätt att få in mejl →

Frågor och svar

Måste jag driva en mejlserver?

Inte för inkommande mejl. Yuva lyssnar inte på SMTP; Cloudflare Email Routing tar emot mejlen och Worker för dem vidare. Svar kräver ett SMTP-konto för mejlkanalen, som Amazon SES, Postmark eller ditt eget relä.

Vad händer när Yuva ligger nere?

När FALLBACK_FORWARD är satt vidarebefordras meddelandet i stället till den adressen. Utan den misslyckas leveransen och den skickande servern kan försöka igen. Meddelanden som Yuva avvisar med flit, som mejl till en okänd adress, avvisas och vidarebefordras inte.

Vilka domäner och adresser kan jag använda?

Vilken domän som helst som du hanterar i Cloudflare och vars mejl ingen annan server hanterar, eftersom Email Routing blir dess MX. Varje mejlkanal har en adress, eller upplockningsadressen *@example.com för alla domänens adresser som ingen kanal har exakt. En underadress som support+billing@example.com når kanalen för support@example.com.

Hur stort kan ett meddelande vara?

Ett meddelande kan vara upp till 25 MiB inklusive bilagor, vilket är gränsen för Cloudflare Email Routing. Yuva behåller upp till 50 bilagor per meddelande, var och en inom serverns gräns för bilagestorlek (25 MiB som standard) och av tillåtna typer; resten utelämnas.

Kan någon förfalska mejl till min Yuva-server?

Yuva avvisar varje begäran utan giltig HMAC-signatur eller med en tidsstämpel som avviker mer än 5 minuter, innan den läser innehållet. Behåll hemligheten för dig själv.

Använder Yuva DMARC-resultatet från Cloudflare?

Ja, när du sätter YUVA_INGRESS_AUTHSERV_ID till mx.cloudflare.net. Yuva läser då DMARC-utlåtandet som Email Routing lägger till. En ny konversation som inte klarar DMARC markeras som skräppost.

Cloudflare, Cloudflare-logotypen och Cloudflare Workers är varumärken och/eller registrerade varumärken som tillhör Cloudflare, Inc. i USA och andra jurisdiktioner. Yuva är ett oberoende projekt med öppen källkod, varken anslutet till eller godkänt av Cloudflare.