Yuva Email Worker per a Cloudflare

Correu de suport amb Cloudflare.Cap servidor de correu per gestionar.

Cloudflare® Email Routing rep el correu de les vostres adreces de suport, i el Yuva Email Worker de codi obert lliura cada missatge a Yuva, signat. Arriba a la vostra safata compartida com una conversa que respon el vostre equip.

Llegeix la guia de configuració Codi del Worker a GitHub →

Què és

Email Routing al davant

Cloudflare Email Routing passa a ser l'MX del vostre domini i rep el correu. Yuva no escolta SMTP, així que no cal instal·lar ni mantenir cap servidor de correu.

Un Worker petit de codi obert

El Yuva Email Worker llegeix el missatge en brut i el sobre, signa la sol·licitud i l'envia a Yuva. L'anàlisi, el fil i les decisions sobre correu brossa es queden al servidor.

Converses reals

El correu a una adreça de suport obre o continua una conversa a la safata, i l'equip respon des del mateix tauler que el xat i els missatges de l'aplicació.

Com arriba un missatge del client al vostre equip

1Un client escriu a una de les vostres adreces de suport, per exemple support@example.com.
2Cloudflare Email Routing rep el missatge i el passa al Yuva Email Worker.
3El Worker signa el missatge en brut, les dues adreces del sobre i una marca de temps amb HMAC-SHA256 sota un secret que compartiu amb Yuva, i els envia a /ingress/email al vostre servidor Yuva.
4Yuva comprova la signatura i que la marca de temps sigui dins dels 5 minuts abans de llegir el missatge. Una sol·licitud amb una signatura incorrecta es rebutja.
5Yuva troba el canal de correu de l'adreça destinatària i enfila el missatge amb In-Reply-To i References a la conversa a la qual pertany. Qualsevol altra cosa comença una conversa nova. Una resposta reobre la conversa.
6El vostre equip respon al tauler. La resposta s'envia pel compte SMTP del mateix canal de correu, com ara Amazon SES, Postmark o el vostre propi relé, des de la mateixa adreça i dins del mateix fil. Les respostes no passen pel Worker.

Els rebuigs arriben al remitent

Quan Yuva rebutja un missatge definitivament, per exemple una adreça desconeguda, un remitent bloquejat o un missatge massa gran, el Worker el rebutja i el remitent rep un error SMTP permanent amb el motiu de Yuva.

Si no es pot contactar amb Yuva

Si Yuva respon amb un error del servidor, no respon en 20 segons o no es pot contactar, el Worker pot reenviar el missatge a una adreça que trieu, sempre que definiu FALLBACK_FORWARD. Aquesta adreça ha de ser una destinació verificada a Email Routing. Aleshores el missatge arriba com un reenviament normal i no apareix a Yuva. Sense FALLBACK_FORWARD el lliurament falla amb un error i el servidor remitent pot tornar-ho a provar més tard.

Configureu-ho en uns quants passos

Necessiteu un servidor Yuva i un compte de Cloudflare que gestioni el domini.

1
A Yuva, obriu Configuració → la vostra bústia → Canals → Correu i afegiu l'adreça de suport. Definiu un secret al servidor i reinicieu-lo:
```
YUVA_INGRESS_SECRET=<openssl rand -hex 32>
YUVA_INGRESS_AUTHSERV_ID=mx.cloudflare.net
```

Desplegueu el Worker al vostre compte de Cloudflare, amb el mateix secret:

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

3
Al tauler de Cloudflare, obriu el vostre domini → Email → Email Routing i activeu-lo. Cloudflare afegeix els seus registres MX i SPF.
4
A Routing rules, envieu cada adreça de suport al Worker yuva-edge. Per a un canal de captura global, apunteu-hi la regla de captura global.
5
Envieu un missatge de prova i mireu com apareix la conversa al tauler.
6
Opcional: conserveu el correu durant una caiguda afegint una adreça de reserva a l'ordre de desplegament:
```
bunx wrangler deploy --var YUVA_URL:https://support.example.com --var FALLBACK_FORWARD:you@example.org
```

Email Routing passa a ser l'MX del domini, per tant feu servir un domini o subdomini que no gestioni cap altre servidor de correu.

Llegeix la guia de configuració →

No lligat a Cloudflare

El Worker és una manera de cridar /ingress/email. Qualsevol servidor de correu o relé pot enviar el missatge en brut amb les mateixes capçaleres signades, i un servidor de correu que lliura a una ordre pot canalitzar el missatge cap a yuva ingest-email. El format de la sol·licitud està documentat al README del Worker.

Llegeix el contracte d'ingress →Altres maneres de portar correu →

Preguntes i respostes

Necessito executar un servidor de correu?

No per al correu entrant. Yuva no escolta SMTP; Cloudflare Email Routing rep el correu i el Worker el passa. Les respostes necessiten un compte SMTP per al canal de correu, com ara Amazon SES, Postmark o el vostre propi relé.

Què passa quan Yuva està caigut?

Amb FALLBACK_FORWARD definit, el missatge es reenvia a aquesta adreça. Sense ell el lliurament falla i el servidor remitent pot tornar-ho a provar. Els missatges que Yuva rebutja a propòsit, com el correu a una adreça desconeguda, es rebutgen, no es reenvien.

Quins dominis i adreces puc fer servir?

Qualsevol domini que gestioneu a Cloudflare i el correu del qual no gestioni cap altre servidor, perquè Email Routing en passa a ser l'MX. Cada canal de correu té una adreça, o la captura global *@example.com per a totes les adreces del domini que cap canal té exactament. Una subadreça com support+billing@example.com arriba al canal de support@example.com.

Quina mida pot tenir un missatge?

Un missatge pot ocupar fins a 25 MiB amb els adjunts, que és el límit de Cloudflare Email Routing. Yuva conserva fins a 50 adjunts per missatge, cadascun dins del límit de mida d'adjunts del servidor (25 MiB per defecte) i dels tipus permesos; la resta els omet.

Algú pot falsificar correu cap al meu servidor Yuva?

Yuva rebutja qualsevol sol·licitud sense una signatura HMAC vàlida o amb una marca de temps a més de 5 minuts, abans de llegir el cos. Guardeu el secret per a vosaltres.

Yuva fa servir el resultat DMARC de Cloudflare?

Sí, quan definiu YUVA_INGRESS_AUTHSERV_ID a mx.cloudflare.net. Aleshores Yuva llegeix el veredicte DMARC que afegeix Email Routing. Una conversa nova que falla DMARC es marca com a correu brossa.

Cloudflare, el logotip de Cloudflare i Cloudflare Workers són marques comercials i/o marques comercials registrades de Cloudflare, Inc. als Estats Units i en altres jurisdiccions. Yuva és un projecte independent de codi obert, no afiliat a Cloudflare ni avalat per ella.