Yuva Email Worker untuk Cloudflare

E-mel sokongan melalui Cloudflare.Tiada pelayan mel untuk dijalankan.

Cloudflare® Email Routing menerima mel untuk alamat sokongan anda, dan Yuva Email Worker sumber terbuka menyerahkan setiap mesej kepada Yuva, bertandatangan. Ia masuk ke peti masuk kongsi anda sebagai perbualan yang dijawab oleh pasukan anda.

Baca panduan persediaan Sumber Worker di GitHub →

Apa itu

Email Routing di hadapan

Cloudflare Email Routing menjadi MX domain anda dan menerima mel. Yuva tidak mendengar SMTP, jadi tiada pelayan mel untuk dipasang atau dikemas kini.

Worker sumber terbuka yang kecil

Yuva Email Worker membaca mesej mentah dan sampul, menandatangani permintaan dan menghantarnya kepada Yuva. Penghuraian, pengutasan dan keputusan spam kekal pada pelayan.

Perbualan sebenar

Mel ke alamat sokongan membuka atau menyambung perbualan dalam peti masuk, dan pasukan menjawab daripada panel yang sama dengan sembang dan mesej aplikasi.

Bagaimana mesej sampai daripada pelanggan kepada pasukan anda

1Seorang pelanggan menulis kepada salah satu alamat sokongan anda, contohnya support@example.com.
2Cloudflare Email Routing menerima mesej dan menyerahkannya kepada Yuva Email Worker.
3Worker menandatangani mesej mentah, kedua-dua alamat sampul dan cap masa dengan HMAC-SHA256 di bawah rahsia yang anda kongsi dengan Yuva, dan menghantarnya ke /ingress/email pada pelayan Yuva anda.
4Yuva menyemak tandatangan dan bahawa cap masa berada dalam 5 minit sebelum membaca mesej. Permintaan dengan tandatangan yang salah ditolak.
5Yuva mencari saluran e-mel untuk alamat penerima dan mengutaskan mesej mengikut In-Reply-To dan References ke dalam perbualan yang dimilikinya. Selain itu akan memulakan perbualan baharu. Balasan membuka semula perbualan.
6Pasukan anda menjawab dalam panel. Balasan dihantar melalui akaun SMTP saluran e-mel itu sendiri, seperti Amazon SES, Postmark atau geganti anda sendiri, dari alamat yang sama dan dalam utas yang sama. Balasan tidak melalui Worker.

Penolakan sampai kepada penghantar

Apabila Yuva menolak mesej secara kekal, contohnya alamat tidak dikenali, penghantar yang disekat atau mesej yang terlalu besar, Worker menolaknya dan penghantar mendapat ralat SMTP kekal dengan sebab daripada Yuva.

Jika Yuva tidak dapat dicapai

Jika Yuva menjawab dengan ralat pelayan, tidak menjawab dalam 20 saat atau tidak dapat dicapai, Worker boleh memajukan mesej ke alamat yang anda pilih, selagi anda menetapkan FALLBACK_FORWARD. Alamat itu mestilah destinasi yang disahkan dalam Email Routing. Mesej kemudian tiba sebagai pemajuan biasa dan tidak muncul dalam Yuva. Tanpa FALLBACK_FORWARD penghantaran gagal dengan ralat dan pelayan penghantar mungkin mencuba semula kemudian.

Sediakan dalam beberapa langkah

Anda memerlukan pelayan Yuva dan akaun Cloudflare yang mengurus domain.

1
Dalam Yuva, buka Tetapan → peti masuk anda → Saluran → E-mel dan tambah alamat sokongan. Tetapkan rahsia pada pelayan dan mulakan semula:
```
YUVA_INGRESS_SECRET=<openssl rand -hex 32>
YUVA_INGRESS_AUTHSERV_ID=mx.cloudflare.net
```

Gunakan Worker pada akaun Cloudflare anda, dengan rahsia yang sama:

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

3
Dalam papan pemuka Cloudflare, buka domain anda → Email → Email Routing dan dayakannya. Cloudflare menambah rekod MX dan SPF-nya.
4
Di bawah Routing rules, hantar setiap alamat sokongan ke Worker yuva-edge. Untuk saluran tangkap-semua, halakan peraturan tangkap-semua kepadanya.
5
Hantar mesej ujian dan lihat perbualan muncul dalam panel.

Pilihan: simpan mel semasa gangguan dengan menambah alamat sandaran pada arahan penggunaan:

bunx wrangler deploy --var YUVA_URL:https://support.example.com --var FALLBACK_FORWARD:you@example.org

Email Routing menjadi MX domain, jadi gunakan domain atau subdomain yang tidak dikendalikan oleh pelayan mel lain.

Baca panduan persediaan →

Tidak terikat dengan Cloudflare

Worker ialah satu cara untuk memanggil /ingress/email. Mana-mana pelayan mel atau geganti boleh menghantar mesej mentah dengan pengepala bertandatangan yang sama, dan pelayan mel yang menghantar kepada arahan boleh menyalurkan mesej ke yuva ingest-email. Format permintaan didokumenkan dalam README Worker.

Baca kontrak ingress →Cara lain membawa masuk mel →

Soalan dan jawapan

Adakah saya perlu menjalankan pelayan mel?

Bukan untuk mel masuk. Yuva tidak mendengar SMTP; Cloudflare Email Routing menerima mel dan Worker meneruskannya. Balasan memerlukan akaun SMTP untuk saluran e-mel, seperti Amazon SES, Postmark atau geganti anda sendiri.

Apa yang berlaku apabila Yuva tidak berfungsi?

Dengan FALLBACK_FORWARD ditetapkan, mesej dimajukan ke alamat itu sebagai gantinya. Tanpanya penghantaran gagal dan pelayan penghantar mungkin mencuba semula. Mesej yang sengaja ditolak Yuva, seperti mel ke alamat tidak dikenali, ditolak, tidak dimajukan.

Domain dan alamat apa yang boleh saya gunakan?

Mana-mana domain yang anda urus dalam Cloudflare dan yang melaluinya tiada pelayan lain mengendalikan mel, kerana Email Routing menjadi MX-nya. Setiap saluran e-mel mempunyai satu alamat, atau alamat tangkap-semua *@example.com untuk setiap alamat domain yang tiada saluran memilikinya dengan tepat. Subalamat seperti support+billing@example.com sampai ke saluran support@example.com.

Sebesar mana mesej boleh jadi?

Satu mesej boleh mencapai 25 MiB termasuk lampiran, iaitu had Cloudflare Email Routing. Yuva menyimpan sehingga 50 lampiran bagi setiap mesej, setiap satu dalam had saiz lampiran pelayan (25 MiB secara lalai) dan jenis yang dibenarkan; selebihnya ditinggalkan.

Bolehkah seseorang memalsukan mel ke pelayan Yuva saya?

Yuva menolak sebarang permintaan tanpa tandatangan HMAC yang sah atau dengan cap masa yang tersasar lebih daripada 5 minit, sebelum membaca badan. Simpan rahsia untuk diri anda.

Adakah Yuva menggunakan keputusan DMARC daripada Cloudflare?

Ya, apabila anda menetapkan YUVA_INGRESS_AUTHSERV_ID kepada mx.cloudflare.net. Yuva kemudian membaca keputusan DMARC yang ditambah oleh Email Routing. Perbualan baharu yang gagal DMARC ditandakan sebagai spam.

Cloudflare, logo Cloudflare dan Cloudflare Workers ialah tanda dagangan dan/atau tanda dagangan berdaftar Cloudflare, Inc. di Amerika Syarikat dan bidang kuasa lain. Yuva ialah projek sumber terbuka bebas, tidak bergabung dengan atau disokong oleh Cloudflare.