Cloudflare Workers से email कैसे भेजें

भेजने के तीन तरीके

Worker के पास बाहर जाने के तीन रास्ते हैं. चुनाव इस आधार पर करें कि आप किस पर निर्भर रहना चाहते हैं, code के आधार पर नहीं: code हर हाल में छोटा है.

SMTP वह तरीका है जो आपको किसी एक provider से बँधने नहीं देता: वही code Google Workspace, Zoho, Microsoft 365, Amazon SES, SendGrid, Mailgun, Postmark, Brevo या Resend के अपने SMTP से भेजता है. इसी में सबसे ज़्यादा फँसने वाली बातें भी हैं.

Worker कौन से SMTP ports इस्तेमाल कर सकता है

Cloudflare port 25 पर outbound connections block करता है, इसलिए Worker सीधे recipient के MX server तक mail नहीं पहुँचा सकता. उसे message किसी submission server को सौंपना होता है, इनमें से किसी एक port पर:

Port के साथ सही mode जोड़ें. 465 के साथ STARTTLS, या 587 के साथ implicit TLS, TLS handshake के दौरान fail होता है (wrong version number), कोई भी credential भेजे जाने से पहले. MakiSend configuration save करते समय port 25 को मना कर देता है और port से mode तय करता है.

Workers पर nodemailer चलाना

nodejs_compat compatibility flag चालू होते ही nodemailer Workers पर चलता है: node:net और node:tls Cloudflare के TCP sockets पर map होते हैं. फिर भी तीन चीज़ों ने हमें परेशान किया.

1. nodemailer hostname resolve करके IP address से connect करता है. workerd port 465 पर implicit TLS के साथ IP address से connection मना कर देता है (proxy request failed, cannot connect to the specified address), जबकि वही server नाम से ठीक खुल जाता है. Error असली वजह के बारे में कुछ नहीं बताता.
2. Local development में dns.resolve4 और dns.resolve6 implement नहीं हैं, इसलिए default transport wrangler dev में अटक सकता है.
3. family: 4 के बिना workerd हर send पर network warnings log करता है.

पहली दो समस्याओं का हल nodemailer का getSocket option है: socket खुद hostname से खोलें और nodemailer को दे दें. ज़रूरत होने पर nodemailer तब भी STARTTLS चलाता है और certificate को hostname से check करता है.

import * as net from "node:net";
import * as tls from "node:tls";
import nodemailer from "nodemailer";

export function createTransport(env: { SMTP_USER: string; SMTP_PASSWORD: string }) {
  const host = "smtp.example.com";
  const port = 465; // 465 or 2465: implicit TLS. 587, 2525, 2587: STARTTLS.
  const implicitTls = port === 465 || port === 2465;

  return nodemailer.createTransport({
    host,
    port,
    secure: implicitTls,
    requireTLS: !implicitTls,
    family: 4,
    tls: { rejectUnauthorized: true },
    auth: { user: env.SMTP_USER, pass: env.SMTP_PASSWORD },
    // Open the socket by name: workerd refuses implicit TLS to a bare IP address.
    getSocket(_options, callback) {
      const socket = implicitTls
        ? tls.connect({ host, port, servername: host, rejectUnauthorized: true })
        : net.connect({ host, port });
      socket.once(implicitTls ? "secureConnect" : "connect", () =>
        callback(null, implicitTls ? { connection: socket, secured: true } : { connection: socket }),
      );
      socket.once("error", (error) => callback(error, false));
    },
  });
}

MakiSend के version में timeout जुड़ा है, और connection check, test send और असली send तीनों इसी को इस्तेमाल करते हैं: smtp-connection.ts.

Cloudflare Email Service smtp.mx.cloudflare.net पर SMTP भी देता है, लेकिन Worker उस host के लिए socket नहीं खोल सकता. Worker से भेजने के लिए send_email binding इस्तेमाल करें.

Request के अंदर email न भेजें

SMTP हर command के जवाब का इंतज़ार करता है: TCP, TLS, EHLO, AUTH, MAIL FROM, RCPT TO, DATA, QUIT. Workers पर एक send में अच्छी स्थिति में 300 से 400 ms और सबसे खराब स्थिति में लगभग 2 सेकंड लगते हैं, और Worker हर email के लिए नया connection खोलता है. आपके user को इसका इंतज़ार नहीं करना चाहिए, और fail हुआ send खोना नहीं चाहिए.

• Email save होते ही 202 Accepted लौटाएँ, फिर उसकी id को Cloudflare Queue में डालें.
• Cloudflare Workflow से भेजें: हर step durable है, इसलिए retry वहीं से शुरू होता है जहाँ run रुका था.
• सिर्फ़ वही retry करें जो बाद में सफल हो सकता है. MakiSend एक कोशिश और 30 सेकंड के अंतर पर तीन retries करता है; authentication, TLS, DNS, configuration और 5xx errors तुरंत रुक जाते हैं, और जिस email की कोशिशें खत्म हो जाएँ वह dead-letter queue में जाता है.
• Idempotency-Key header स्वीकार करें, ताकि अपनी request दोबारा भेजने वाला client दो बार email न भेजे.

Network का इंतज़ार CPU limit में नहीं गिना जाता (Workers Free पर हर invocation के लिए 10 ms), इसलिए send खुद free plan में फ़िट हो जाता है. Architecture page एक email को इन steps से गुज़रते हुए दिखाता है.

Fixed IP और inbox

• Workers साझा Cloudflare addresses से connect करते हैं, जो बदलते रहते हैं. जो provider सिर्फ़ allow-list वाले IPs स्वीकार करता है वह connection मना कर देगा: allow-listing बंद करें और SMTP credentials पर भरोसा करें, या fixed IP वाले server से भेजें.
• Mail inbox तक पहुँचेगा या नहीं, यह sender domain (SPF, DKIM और DMARC) और provider की reputation पर निर्भर करता है, Worker पर नहीं. हमारे tests में ये तीनों records सेट होने के बाद MakiSend के emails inbox में पहुँचते हैं.
• Gmail और Google Workspace एक mailbox से रोज़ भेजे जाने वाले emails की सीमा तय करते हैं. ज़्यादा volume के लिए transactional provider इस्तेमाल करें.

या यह काम MakiSend को दें

इस पेज पर जो कुछ भी है, MakiSend में वह सब पहले से तैयार है: authenticated POST /send-email, एक queue, retries वाला durable Workflow, hostname से खुलने वाले sockets पर nodemailer, Cloudflare Email Service binding और logs वाला dashboard. यह open source है और आपके अपने Cloudflare account पर deploy होता है, Workers Free account पर भी.

• Coding agent के साथ: install prompt कॉपी करें और उसे Claude Code, Codex, Cursor या किसी दूसरे agent में पेस्ट करें.
• Agent के बिना: जो दो secrets माँगे जाते हैं उन्हें बनाने के बाद Deploy to Cloudflare.
• पहले code पढ़ें: github.com/lixalistudio-oss/makisend.

सवाल