Panduan Konfigurasi Servis Mailpit di ServBay

ServBay telah mengintegrasikan pakej perisian Mailpit, menyediakan pelayan e-mel tempatan yang mudah digunakan, direka khas untuk pengujian dan debugging ciri penghantaran e-mel dalam aplikasi oleh pembangun. Dokumen ini akan menerangkan secara terperinci cara memasang, mengaktifkan dan mengkonfigurasi pakej Mailpit dalam ServBay, termasuk penjelasan keempat-empat tab konfigurasi utama: Common, SMTP, POP3, dan Relay.

Pengenalan Mailpit

Mailpit ialah alat sumber terbuka yang menawarkan pelayan SMTP/POP3 tempatan dan antara muka web yang intuitif. Ia dapat menangkap semua e-mel yang dihantar oleh aplikasi anda, membolehkan anda menyemak kandungan, header, lampiran dan sebagainya di satu tempat tanpa menghantar e-mel ujian ke peti masuk sebenar. Ini sangat memudahkan proses pembangunan dan debugging, terutamanya untuk fungsi yang melibatkan penghantaran e-mel seperti pendaftaran pengguna, penetapan semula kata laluan, pemberitahuan, dan lain-lain.

Dalam ServBay, Mailpit dipakejkan sebagai komponen utama dan pengurusannya mudah. Ia juga mengaplikasikan sistem PKI ServBay yang berkuasa untuk konfigurasi automatik SSL/TLS, menjamin persekitaran pengujian yang selamat.

Memasang dan Mengaktifkan Pakej Mailpit

Sebelum menggunakan Mailpit sebagai pelayan e-mel tempatan, anda perlu memasang dan mengaktifkan pakej Mailpit dalam ServBay.

1. Buka aplikasi ServBay.
2. Pada bar navigasi kiri, pilih Pakej Perisian.
3. Dalam senarai pakej, cari kategori Perkhidmatan Umum.
4. Temui pakej Mailpit.
5. Jika Mailpit belum dipasang, klik butang hijau “Pasang” di sebelah kanan untuk memulakan pemasangan.
6. Setelah pemasangan selesai, aktifkan pakej Mailpit dengan menekan suis di sebelahnya.

Dengan kelebihan sistem PKI ServBay, sijil SSL yang diperlukan akan dijana dan dikonfigurasikan secara automatik untuk antaramuka web pengurusan Mailpit serta perkhidmatan SMTP dan POP3. Ini bermaksud anda boleh terus mengaktifkan penyulitan STARTTLS atau SSL/TLS tanpa perlu memohon atau mengkonfigurasi sijil secara manual.

Antaramuka Web Pengurusan E-mel

Mailpit didatangkan dengan antara muka web yang hebat untuk melihat dan mengurus e-mel yang ditangkap. Konfigurasi antara muka ini telah dilakukan secara automatik oleh ServBay dan boleh diakses melalui pelayar setelah Mailpit diaktifkan:

Alamat akses: https://mail.servbay.host

Melalui antaramuka ini, anda boleh dengan mudah meneliti senarai e-mel yang diterima, melihat kandungan terperinci setiap e-mel (termasuk HTML, teks biasa, kod sumber), mencari e-mel, memadam e-mel, dan lain-lain.

Mengkonfigurasi Pakej Mailpit

ServBay menyediakan antaramuka grafik untuk mengkonfigurasi pelbagai parameter Mailpit. Pada bar navigasi kiri ServBay, pilih Mail, kemudian klik Konfigurasi Servis Mailpit untuk masuk ke halaman tetapan. Anda akan lihat empat tab utama: Common, SMTP, POP3, dan Relay.

1. Tab Common

Tab Common digunakan untuk tetapan umum dan perilaku Mailpit:

• Max Messages: Menetapkan jumlah maksimum e-mel yang boleh disimpan oleh pelayan Mailpit. Jika melebihi had, e-mel terawal akan dipadam secara automatik.
• Max Age: Menetapkan tempoh maksimum (dalam hari) e-mel kekal dalam pelayan Mailpit. E-mel lebih lama akan dihapuskan secara automatik.
• SpamAssassin: Aktifkan atau nyahaktifkan fungsi penapisan spam melalui SpamAssassin. Jika diaktifkan, Mailpit akan menandakan e-mel spam secara automatik.
• Webhook URL: Tetapkan URL webhook yang akan menerima permintaan HTTP POST setiap kali e-mel baru tiba, membolehkan integrasi automasi pengujian atau sistem notifikasi.
• Webhook Limit: Had maksimum e-mel untuk pemberitahuan Webhook.

2. Tab SMTP

TIP

Dengan sistem PKI ServBay yang canggih, sijil SSL telah dijana dan dikonfigurasikan secara lalai. Anda boleh mengaktifkan sambungan terenkripsi STARTTLS atau SSL/TLS dengan serta-merta tanpa konfigurasi sijil tambahan.

Tab SMTP adalah untuk tetapan pelayan Mailpit SMTP. Aplikasi anda akan berhubung dengan pelayan ini bagi menghantar e-mel ujian:

• SMTP Port: Tentukan nombor port yang digunakan oleh pelayan SMTP Mailpit. Aplikasi anda harus mengarahkan penghantaran ke 127.0.0.1 atau localhost pada port ini. Lalai: 1025.
• STARTTLS: Aktifkan atau nyahaktifkan penyulitan STARTTLS, membolehkan pengaktifan enkripsi selepas sambungan dibentuk.
• SSL/TLS: Aktifkan atau nyahaktifkan penyulitan SSL/TLS bagi sambungan terenkripsi ketika sambungan bermula.
• Username: Nama pengguna untuk pelayan SMTP (pilihan). Jika ditetapkan, aplikasi anda perlu menyediakannya untuk pengesahan.
• Password: Kata laluan untuk pelayan SMTP (pilihan), digunakan bersama Username untuk pengesahan.
• Max Recipients: Tetapan jumlah maksimum penerima bagi setiap e-mel, mengelak penghantaran ke terlalu banyak penerima sekaligus.
• Allowed Recipients: Senarai alamat atau domain penerima yang dibenarkan (pilihan). Jika kosong, Mailpit menerima e-mel ke sebarang alamat. Jika diisi, hanya alamat/domain dalam senarai ini akan diterima.

3. Tab POP3

TIP

Sistem PKI ServBay telah menyediakan sijil SSL secara automatik. Anda boleh terus mengaktifkan sambungan terlindung SSL/TLS tanpa konfigurasi tambahan.

Tab POP3 untuk mengkonfigurasi pelayan POP3 Mailpit. Untuk menguji penerimaan e-mel oleh aplikasi, hubungkan klien ke pelayan ini:

• Enable POP3 Server: Aktifkan/nyahaktifkan fungsi pelayan POP3 dalam Mailpit.
• POP3 Server Port: Nombor port yang digunakan oleh pelayan POP3 Mailpit. Lalai: 1110.
• Username: Nama pengguna untuk POP3 (pilihan). Jika diisi, klien perlu menyediakannya semasa pengesahan.
• Password: Kata laluan untuk POP3 (pilihan), digunakan bersama Username untuk pengesahan.
• SSL/TLS: Aktifkan atau nyahaktifkan penyulitan SSL/TLS.

4. Tab Relay

Tab Relay untuk tetapan fungsi pengalihan e-mel Mailpit. Anda boleh menyusun Mailpit sebagai pelayan relay untuk menghantar semula e-mel yang diterima ke pelayan SMTP sebenar luar:

• Enable SMTP Relay: Aktifkan atau nyahaktifkan fungsi relay SMTP.
• Host: Alamat pelayan SMTP luaran untuk relay e-mel (cth: smtp.gmail.com, smtp.sendgrid.net).
• Port: Nombor port pelayan SMTP luaran untuk relay. Lalai: 25 (SMTP), 465 (SMTPS), atau 587 (Submission).
• STARTTLS: Aktifkan/nyahaktifkan sambungan enkripsi STARTTLS ke pelayan relay.
• Allow Insecure: Benarkan sambungan ke pelayan SMTP relay yang menggunakan sijil tidak dipercayai (tidak digalakkan untuk penggunaan produksi).
• Auth: Pilihan mod pengesahan dengan pelayan relay. Pilihan biasa termasuk Login (nama pengguna & kata laluan), Plain (seperti Login), dan CRAM-MD5 (mekanisme cabaran/respons).
• Username: Nama pengguna untuk sambungan SMTP relay.
• Password: Kata laluan untuk sambungan SMTP relay.
• Return Path: Tetapkan alamat balasan (Return-Path) untuk e-mel yang dihantar melalui relay.
• Allowed Recipients: Senarai alamat atau domain penerima yang dibenarkan untuk relay (pilihan).
• Blocked Recipients: Senarai alamat atau domain penerima yang disekat daripada relay (pilihan).
• Relay All: Jika ditandakan, Mailpit akan cuba relay semua e-mel yang ditangkap (tertakluk kepada Allowed/Blocked Recipients).
• Relay Matching: Jika ditandakan, Mailpit hanya akan relay e-mel yang memenuhi peraturan Allowed Recipients atau Blocked Recipients.

Menyimpan Konfigurasi

Selepas membuat sebarang perubahan pada konfigurasi Mailpit, pastikan anda klik butang Save di bahagian bawah antaramuka untuk menyimpan tetapan anda.

Klik butang Reset untuk mengembalikan semua seting ke konfigurasi lalai Mailpit.

Soalan Lazim (FAQ)

• S: Kenapa e-mel yang dihantar oleh aplikasi saya tidak kelihatan dalam Mailpit?
  • J: Periksa tetapan penghantaran e-mel aplikasimu – biasanya host dan port SMTP. Pastikan ia ditetapkan kepada alamat tempat Mailpit berjalan dalam ServBay (127.0.0.1 atau localhost) serta port SMTP yang ditetapkan (lalai biasanya 1025). Pastikan juga pakej Mailpit sudah dijalankan dan diaktifkan dalam Senarai Pakej ServBay.
• S: Perlukah saya mengkonfigurasi sijil SSL untuk Mailpit?
  • J: Tidak perlu. Sistem PKI ServBay secara automatik akan menjana dan mengkonfigurasi sijil untuk antaramuka web serta perkhidmatan SMTP dan POP3 Mailpit. Cukup aktifkan pilihan penyulitan dalam tab konfigurasi berkaitan.
• S: Apakah nama pengguna dan kata laluan lalai untuk antaramuka web Mailpit?
  • J: Secara lalai, antara muka web Mailpit diakses via https://mail.servbay.host tanpa nama pengguna dan kata laluan. Servis SMTP dan POP3 juga secara lalai tidak memerlukan pengesahan. Jika anda ingin memaksa pengesahan untuk SMTP atau POP3, sila tetapkan nama pengguna dan kata laluan dalam tab yang berkaitan.

Rumusan

Dengan integrasi Mailpit dalam ServBay, anda boleh membina persekitaran ujian e-mel tempatan dengan mudah. Konfigurasikan tetapan SMTP, POP3 dan Relay Mailpit mengikut keperluan, digabungkan dengan antaramuka web intuitif yang disediakan, akan meningkatkan kecekapan dan kemudahan tugasan pembangunan fungsi e-mel anda.

Sila ambil perhatian; selepas mengubah konfigurasi, anda mungkin perlu mulakan semula pakej Mailpit supaya perubahan berkuat kuasa. Anda boleh lakukannya melalui antaramuka pengurusan pakej dalam ServBay dengan klik pada butang mulakan semula untuk Mailpit.