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 ਕੱਚੇ ਸੁਨੇਹੇ, ਦੋਵੇਂ ਲਿਫ਼ਾਫ਼ੇ ਦੇ ਪਤਿਆਂ ਅਤੇ ਇੱਕ ਟਾਈਮਸਟੈਂਪ ਤੇ ਉਸ ਸੀਕਰੇਟ ਹੇਠ HMAC-SHA256 ਨਾਲ ਦਸਤਖ਼ਤ ਕਰਦਾ ਹੈ ਜੋ ਤੁਸੀਂ Yuva ਨਾਲ ਸਾਂਝਾ ਕਰਦੇ ਹੋ, ਅਤੇ ਉਨ੍ਹਾਂ ਨੂੰ ਤੁਹਾਡੇ 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 ਨਾਲ ਬੱਝਿਆ ਨਹੀਂ

Worker /ingress/email ਨੂੰ ਕਾਲ ਕਰਨ ਦਾ ਇੱਕ ਤਰੀਕਾ ਹੈ। ਕੋਈ ਵੀ ਮੇਲ ਸਰਵਰ ਜਾਂ ਰਿਲੇ ਉਨ੍ਹਾਂ ਹੀ ਦਸਤਖ਼ਤ ਵਾਲੇ ਹੈਡਰਾਂ ਨਾਲ ਕੱਚਾ ਸੁਨੇਹਾ ਪੋਸਟ ਕਰ ਸਕਦਾ ਹੈ, ਅਤੇ ਕਮਾਂਡ ਨੂੰ ਡਿਲੀਵਰ ਕਰਨ ਵਾਲਾ ਮੇਲ ਸਰਵਰ ਸੁਨੇਹੇ ਨੂੰ 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 ਉਸਨੂੰ ਮੁੱਖ ਭਾਗ ਪੜ੍ਹਨ ਤੋਂ ਪਹਿਲਾਂ ਹੀ ਠੁਕਰਾ ਦਿੰਦਾ ਹੈ। ਸੀਕਰੇਟ ਆਪਣੇ ਕੋਲ ਰੱਖੋ।

ਕੀ Yuva Cloudflare ਦਾ DMARC ਨਤੀਜਾ ਵਰਤਦਾ ਹੈ?

ਹਾਂ, ਜਦੋਂ ਤੁਸੀਂ YUVA_INGRESS_AUTHSERV_ID ਨੂੰ mx.cloudflare.net ਤੇ ਸੈੱਟ ਕਰਦੇ ਹੋ। ਫਿਰ Yuva ਉਹ DMARC ਫ਼ੈਸਲਾ ਪੜ੍ਹਦਾ ਹੈ ਜੋ Email Routing ਜੋੜਦਾ ਹੈ। DMARC ਵਿੱਚ ਫੇਲ੍ਹ ਹੋਣ ਵਾਲੀ ਨਵੀਂ ਗੱਲਬਾਤ ਸਪੈਮ ਵਜੋਂ ਨਿਸ਼ਾਨਦੇਹ ਹੁੰਦੀ ਹੈ।

Cloudflare, Cloudflare ਲੋਗੋ ਅਤੇ Cloudflare Workers ਸੰਯੁਕਤ ਰਾਜ ਅਤੇ ਹੋਰ ਅਧਿਕਾਰ ਖੇਤਰਾਂ ਵਿੱਚ Cloudflare, Inc. ਦੇ ਟ੍ਰੇਡਮਾਰਕ ਅਤੇ/ਜਾਂ ਰਜਿਸਟਰਡ ਟ੍ਰੇਡਮਾਰਕ ਹਨ। Yuva ਇੱਕ ਸੁਤੰਤਰ ਓਪਨ-ਸੋਰਸ ਪ੍ਰੋਜੈਕਟ ਹੈ, Cloudflare ਨਾਲ ਜੁੜਿਆ ਨਹੀਂ ਅਤੇ ਨਾ ਹੀ ਉਸ ਵੱਲੋਂ ਮਨਜ਼ੂਰ ਕੀਤਾ ਹੋਇਆ।