Cloudflare కోసం Yuva Email Worker

Cloudflare ద్వారా సపోర్ట్ ఇమెయిల్.నడపడానికి మెయిల్ సర్వర్ లేదు.

Cloudflare® Email Routing మీ సపోర్ట్ చిరునామాల మెయిల్ స్వీకరిస్తుంది, ఓపెన్-సోర్స్ Yuva Email Worker ప్రతి సందేశాన్ని సంతకం చేసి Yuva కు అందిస్తుంది. అది మీ షేర్డ్ ఇన్‌బాక్స్‌లో మీ బృందం సమాధానమిచ్చే సంభాషణగా చేరుతుంది.

సెటప్ గైడ్ చదవండి GitHub లో Worker సోర్స్ →

ఇది ఏమిటి

ముందు Email Routing

Cloudflare Email Routing మీ డొమైన్ MX అయి మెయిల్ స్వీకరిస్తుంది. Yuva SMTP వినదు, కాబట్టి ఇన్‌స్టాల్ చేయడానికి లేదా అప్‌డేట్‌గా ఉంచడానికి మెయిల్ సర్వర్ లేదు.

ఒక చిన్న ఓపెన్-సోర్స్ Worker

Yuva Email Worker ముడి సందేశం, ఎన్వలప్ చదివి, అభ్యర్థనకు సంతకం చేసి Yuva కు పోస్ట్ చేస్తుంది. పార్సింగ్, థ్రెడింగ్, స్పామ్ నిర్ణయాలు సర్వర్‌లోనే ఉంటాయి.

నిజమైన సంభాషణలు

సపోర్ట్ చిరునామాకు వచ్చిన మెయిల్ ఇన్‌బాక్స్‌లో సంభాషణను తెరుస్తుంది లేదా కొనసాగిస్తుంది, చాట్, యాప్ సందేశాల ప్యానెల్ నుంచే బృందం సమాధానమిస్తుంది.

కస్టమర్ నుంచి మీ బృందానికి సందేశం ఎలా చేరుతుంది

1ఒక కస్టమర్ మీ సపోర్ట్ చిరునామాల్లో ఒకదానికి రాస్తారు, ఉదాహరణకు support@example.com.
2Cloudflare Email Routing సందేశాన్ని స్వీకరించి Yuva Email Worker కు అందిస్తుంది.
3Worker ముడి సందేశం, రెండు ఎన్వలప్ చిరునామాలు, టైమ్‌స్టాంప్‌ను మీరు Yuva తో పంచుకునే రహస్యంతో HMAC-SHA256 ద్వారా సంతకం చేసి మీ Yuva సర్వర్‌లోని /ingress/email కు పంపుతుంది.
4సందేశం చదివే ముందు Yuva సంతకాన్ని, టైమ్‌స్టాంప్ 5 నిమిషాల్లో ఉందా అనేదాన్ని తనిఖీ చేస్తుంది. తప్పు సంతకంతో వచ్చిన అభ్యర్థన తిరస్కరించబడుతుంది.
5Yuva గ్రహీత చిరునామా ఇమెయిల్ ఛానెల్‌ను కనుగొని, In-Reply-To, References ద్వారా సందేశాన్ని అది చెందిన సంభాషణలో థ్రెడ్ చేస్తుంది. మిగతావన్నీ కొత్త సంభాషణను మొదలుపెడతాయి. సమాధానం సంభాషణను తిరిగి తెరుస్తుంది.
6మీ బృందం ప్యానెల్‌లో సమాధానమిస్తుంది. సమాధానం ఇమెయిల్ ఛానెల్ స్వంత SMTP ఖాతా ద్వారా, ఉదాహరణకు Amazon SES, Postmark లేదా మీ స్వంత రిలే, అదే చిరునామా నుంచి అదే థ్రెడ్‌లో పంపబడుతుంది. సమాధానాలు Worker ద్వారా వెళ్లవు.

తిరస్కరణలు పంపినవారికి చేరతాయి

తెలియని చిరునామా, బ్లాక్ చేసిన పంపినవారు లేదా చాలా పెద్ద సందేశం వంటి కారణాలతో Yuva ఒక సందేశాన్ని శాశ్వతంగా తిరస్కరించినప్పుడు, Worker దాన్ని తిరస్కరిస్తుంది, పంపినవారికి Yuva కారణంతో శాశ్వత SMTP లోపం వస్తుంది.

Yuva ను చేరుకోలేకపోతే

Yuva సర్వర్ లోపంతో సమాధానమిచ్చినా, 20 సెకన్లలో సమాధానమివ్వకపోయినా లేదా చేరుకోలేకపోయినా, మీరు FALLBACK_FORWARD సెట్ చేసి ఉంటే Worker సందేశాన్ని మీరు ఎంచుకున్న చిరునామాకు ఫార్వర్డ్ చేయగలదు. ఆ చిరునామా Email Routing లో ధృవీకరించిన గమ్యంగా ఉండాలి. అప్పుడు సందేశం సాధారణ ఫార్వర్డ్‌గా వస్తుంది, Yuva లో కనిపించదు. FALLBACK_FORWARD లేకపోతే డెలివరీ లోపంతో విఫలమవుతుంది, పంపే సర్వర్ తర్వాత మళ్లీ ప్రయత్నించవచ్చు.

కొన్ని దశల్లో సెటప్ చేయండి

మీకు ఒక Yuva సర్వర్, డొమైన్‌ను నిర్వహించే Cloudflare ఖాతా కావాలి.

1
Yuva లో సెట్టింగ్‌లు → మీ ఇన్‌బాక్స్ → ఛానెల్‌లు → ఇమెయిల్ తెరిచి సపోర్ట్ చిరునామా జోడించండి. సర్వర్‌లో ఒక రహస్యం సెట్ చేసి రీస్టార్ట్ చేయండి:
```
YUVA_INGRESS_SECRET=<openssl rand -hex 32>
YUVA_INGRESS_AUTHSERV_ID=mx.cloudflare.net
```

అదే రహస్యంతో Worker ను మీ Cloudflare ఖాతాలో డిప్లాయ్ చేయండి:

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

3
Cloudflare డ్యాష్‌బోర్డ్‌లో మీ డొమైన్ → Email → Email Routing తెరిచి ఆన్ చేయండి. Cloudflare తన MX, SPF రికార్డులను జోడిస్తుంది.
4
Routing rules కింద ప్రతి సపోర్ట్ చిరునామాను Worker yuva-edge కు పంపండి. క్యాచ్-ఆల్ ఛానెల్ కోసం క్యాచ్-ఆల్ నియమాన్ని దాని వైపు మళ్లించండి.
5
ఒక పరీక్ష సందేశం పంపి సంభాషణ ప్యానెల్‌లో కనిపించడం చూడండి.
6
ఐచ్ఛికం: డిప్లాయ్ కమాండ్‌కు ప్రత్యామ్నాయ చిరునామా జోడించి అంతరాయం సమయంలో మెయిల్ ఉంచుకోండి:
```
bunx wrangler deploy --var YUVA_URL:https://support.example.com --var FALLBACK_FORWARD:you@example.org
```

Email Routing డొమైన్ MX అవుతుంది, కాబట్టి మరే మెయిల్ సర్వర్ నిర్వహించని డొమైన్ లేదా సబ్‌డొమైన్ వాడండి.

సెటప్ గైడ్ చదవండి →

Cloudflare కు కట్టుబడి లేదు

/ingress/email ను పిలవడానికి Worker ఒక మార్గం. ఏ మెయిల్ సర్వర్ లేదా రిలే అయినా అవే సంతకం చేసిన హెడర్‌లతో ముడి సందేశాన్ని పోస్ట్ చేయవచ్చు, కమాండ్‌కు డెలివర్ చేసే మెయిల్ సర్వర్ సందేశాన్ని yuva ingest-email కు పైప్ చేయవచ్చు. అభ్యర్థన ఫార్మాట్ Worker README లో డాక్యుమెంట్ చేయబడింది.

ఇన్‌గ్రెస్ ఒప్పందం చదవండి →మెయిల్ తీసుకురావడానికి ఇతర మార్గాలు →

ప్రశ్నలు, సమాధానాలు

నేను మెయిల్ సర్వర్ నడపాలా?

ఇన్‌కమింగ్ మెయిల్ కోసం కాదు. Yuva SMTP వినదు; మెయిల్‌ను Cloudflare Email Routing స్వీకరిస్తుంది, Worker దాన్ని ముందుకు పంపుతుంది. సమాధానాలకు ఇమెయిల్ ఛానెల్ కోసం Amazon SES, Postmark లేదా మీ స్వంత రిలే వంటి SMTP ఖాతా కావాలి.

Yuva పనిచేయకపోతే ఏమవుతుంది?

FALLBACK_FORWARD సెట్ చేసి ఉంటే సందేశం బదులుగా ఆ చిరునామాకు ఫార్వర్డ్ అవుతుంది. అది లేకపోతే డెలివరీ విఫలమవుతుంది, పంపే సర్వర్ మళ్లీ ప్రయత్నించవచ్చు. తెలియని చిరునామాకు మెయిల్ వంటి Yuva ఉద్దేశపూర్వకంగా తిరస్కరించే సందేశాలు తిరస్కరించబడతాయి, ఫార్వర్డ్ కావు.

నేను ఏ డొమైన్‌లు, చిరునామాలు వాడవచ్చు?

మీరు Cloudflare లో నిర్వహించే, మరే సర్వర్ మెయిల్ నిర్వహించని ఏ డొమైన్ అయినా, ఎందుకంటే Email Routing దాని MX అవుతుంది. ప్రతి ఇమెయిల్ ఛానెల్‌కు ఒక చిరునామా ఉంటుంది, లేదా ఏ ఛానెల్‌కూ ఖచ్చితంగా లేని డొమైన్‌లోని ప్రతి చిరునామా కోసం క్యాచ్-ఆల్ *@example.com. support+billing@example.com వంటి ఉప-చిరునామా support@example.com ఛానెల్‌కు చేరుతుంది.

ఒక సందేశం ఎంత పెద్దదిగా ఉండవచ్చు?

అటాచ్‌మెంట్‌లతో సహా ఒక సందేశం 25 MiB వరకు ఉండవచ్చు, ఇది Cloudflare Email Routing పరిమితి. Yuva ప్రతి సందేశానికి 50 అటాచ్‌మెంట్‌ల వరకు ఉంచుకుంటుంది, ప్రతిదీ సర్వర్ అటాచ్‌మెంట్ పరిమాణ పరిమితి (డిఫాల్ట్‌గా 25 MiB), అనుమతించిన రకాల పరిధిలో ఉండాలి; మిగతావి వదిలేస్తుంది.

నా Yuva సర్వర్‌కు ఎవరైనా నకిలీ మెయిల్ పంపగలరా?

చెల్లుబాటు అయ్యే HMAC సంతకం లేని లేదా టైమ్‌స్టాంప్ 5 నిమిషాలకు మించి తేడా ఉన్న ఏ అభ్యర్థననైనా Yuva బాడీ చదివే ముందే తిరస్కరిస్తుంది. రహస్యాన్ని మీ దగ్గరే ఉంచుకోండి.

Cloudflare నుంచి వచ్చే DMARC ఫలితాన్ని Yuva వాడుతుందా?

అవును, మీరు YUVA_INGRESS_AUTHSERV_ID ను mx.cloudflare.net కు సెట్ చేసినప్పుడు. అప్పుడు Email Routing జోడించే DMARC తీర్పును Yuva చదువుతుంది. DMARC లో విఫలమయ్యే కొత్త సంభాషణ స్పామ్‌గా గుర్తించబడుతుంది.

Cloudflare, Cloudflare లోగో, Cloudflare Workers అనేవి అమెరికా సంయుక్త రాష్ట్రాలు, ఇతర అధికార పరిధుల్లో Cloudflare, Inc. యొక్క ట్రేడ్‌మార్క్‌లు మరియు/లేదా నమోదిత ట్రేడ్‌మార్క్‌లు. Yuva ఒక స్వతంత్ర ఓపెన్-సోర్స్ ప్రాజెక్ట్, Cloudflare తో అనుబంధం లేదు, దాని ఆమోదం కూడా లేదు.