ServBay Mailpit 服務設定指南

ServBay 已整合 Mailpit 軟體包，提供方便的本地電子郵件伺服器，專為開發者測試與除錯應用程式的郵件發送功能設計。本文將詳細說明如何在 ServBay 中安裝、啟用並設定 Mailpit 軟體包，包括 Common、SMTP、POP3 及 Relay 等四個主要設定頁籤。

Mailpit 軟體包概述

Mailpit 是一款開源工具，提供易於使用的本地 SMTP/POP3 伺服器與直覺的 Web 介面。它能攔截您的應用程式所發送的所有郵件，讓您可以在同一個位置方便檢查郵件內容、標頭、附檔等，不必真的把測試郵件發送到真實信箱。這大幅簡化了開發及除錯流程，特別是當功能涉及到用戶註冊、密碼重設、通知等需要發送郵件時。

在 ServBay 中，Mailpit 作為核心套件整合，您可以輕鬆安裝與管理，並善用 ServBay 強大 PKI 系統自動設定 SSL/TLS，確保安全的測試環境。

安裝並啟用 Mailpit 軟體包

在使用 Mailpit 做本地郵件伺服器之前，請先在 ServBay 中安裝並啟用此軟體包。

1. 開啟 ServBay 應用程式。
2. 在左側導航列選擇 軟體包。
3. 於軟體包列表中找到 通用服務 分類。
4. 尋找 Mailpit 軟體包。
5. 若 Mailpit 尚未安裝，請點選右側的綠色安裝按鈕完成安裝。
6. 安裝完成後，點擊旁邊的開關按鈕即可啟用 Mailpit。

得益於 ServBay 強大的 PKI 系統，ServBay 會自動為 Mailpit 的 Web 管理介面以及 SMTP、POP3 服務生成並配置所需的 SSL 憑證。這意味著您可以直接啟用 STARTTLS 或 SSL/TLS 加密，無需手動申請或配置憑證。

Web 郵件管理介面

Mailpit 提供功能完整的 Web 介面，方便查看與管理已攔截的電子郵件。ServBay 已經為您自動完成整合，只要啟用 Mailpit 軟體包，即可直接於瀏覽器存取該介面：

存取網址：https://mail.servbay.host

透過此介面，您可以方便瀏覽收件清單、檢視單封郵件詳細內容（包含 HTML、純文字、原始碼）、搜尋郵件、刪除郵件等。

設定 Mailpit 軟體包

ServBay 提供圖形化介面來設定 Mailpit 各項參數。於 ServBay 左側導航列選擇 Mail，再點選 Mailpit Service Config 進入設定畫面。您將可看到 Common、SMTP、POP3 及 Relay 四個主要設定頁籤。

1. Common 頁籤

Common 頁籤用於設定 Mailpit 的一般行為及限制：

• Max Messages: 設定 Mailpit 伺服器最多可儲存的郵件數量。超過此上限時，最早的郵件會自動刪除。
• Max Age: 定義郵件在 Mailpit 伺服器上保留的最長天數。超過後郵件將自動移除。
• SpamAssassin: 啟用或停用 SpamAssassin 垃圾信過濾功能。啟用時，Mailpit 會嘗試標記收到的垃圾郵件。
• Webhook URL: 設定一個 Webhook 位址。當 Mailpit 收到新信件時，會向該 URL 發送 HTTP POST 通知外部系統，適用自動化測試或整合通知系統。
• Webhook Limit: 定義 Webhook 通知的郵件數量上限。

2. SMTP 頁籤

TIP

得益於 ServBay 強大的 PKI 系統，ServBay 已預設生成並設定 SSL 憑證。您可以直接啟用 STARTTLS 或 SSL/TLS 加密連線，無需額外申請或設定 SSL 憑證。

SMTP 頁籤用於設定 Mailpit 的 SMTP 郵件伺服器。您的應用程式將透過此伺服器發送測試郵件：

• SMTP Port: 設定 Mailpit SMTP 伺服器的監聽連接埠。應用程式需將發信主機與連接埠指向 127.0.0.1 或 localhost 與設定的 Port，預設為 1025。
• STARTTLS: 啟用或停用 STARTTLS 加密，可於建立連線後升級成加密通訊。
• SSL/TLS: 啟用或停用 SSL/TLS 加密，建立連線時即啟用加密。
• Username: 設定 SMTP 伺服器的使用者名稱（選填）。如有設定，應用程式發信時需提供本帳號進行驗證。
• Password: 設定 SMTP 伺服器密碼（選填），搭配 Username 驗證使用。
• Max Recipients: 定義每封郵件最多允許寄送的收件人數，避免一次群發過多。
• Allowed Recipients: 指定允許收信的 email 或網域名單（選填）。若留空，Mailpit 將收下寄往任意信箱的郵件，否則僅接受名單內郵件。

3. POP3 頁籤

TIP

得益於 ServBay 強大的 PKI 系統，ServBay 已預設生成並設定 SSL 憑證。您可以直接啟用 SSL/TLS 加密連線，無需另外申請或設定 SSL 憑證。

POP3 頁籤用於設定 Mailpit 的 POP3 郵件伺服器。若您需測試接收郵件，可讓客戶端連接本伺服器：

• Enable POP3 Server: 啟用或停用 Mailpit 的 POP3 伺服器。
• POP3 Server Port: 設定 Mailpit POP3 伺服器接聽的連接埠，預設為 1110。
• Username: 設定 POP3 伺服器的使用者帳號（選填），如有需驗證。
• Password: 設定 POP3 伺服器密碼（選填），與 Username 一起使用。
• SSL/TLS: 啟用或者停用 SSL/TLS 加密連線。

4. Relay 頁籤

Relay 頁籤設定 Mailpit 郵件中繼功能。您可以將 Mailpit 作為郵件中繼，將攔截到的某些或全部郵件轉發至指定外部 SMTP 伺服器：

• Enable SMTP Relay: 啟用或停用 SMTP 中繼功能。
• Host: 指定作為中繼目的的外部 SMTP 伺服器（如：smtp.gmail.com、smtp.sendgrid.net）。
• Port: 外部 SMTP 伺服器的連接埠，預設有 25（SMTP 標準），465（SMTPS）或 587（Submission）。
• STARTTLS: 啟用或停用與中繼 SMTP 伺服器間的 STARTTLS 加密連線。
• Allow Insecure: 允許連線不受信任憑證的 SMTP 伺服器（不建議於正式環境啟用）。
• Auth: 選擇與中繼伺服器驗證方式。常見選項有 Login（帳號密碼）、Plain（類似 Login）、CRAM-MD5（挑戰式驗證）。
• Username: 連線中繼 SMTP 伺服器所需使用者帳號。
• Password: 連線中繼 SMTP 伺服器所需密碼。
• Return Path: 指定中繼發信的退信位址（Return-Path 標頭）。
• Allowed Recipients: 設定允許經由中繼發送的收件人郵箱或網域（選填）。
• Blocked Recipients: 設定禁止中繼的收件人郵箱或網域（選填）。
• Relay All: 勾選後，Mailpit 將嘗試轉發攔截到的所有郵件（受 Allowed/Blocked Recipients 限制）。
• Relay Matching: 勾選後，僅符合 Allowed Recipients 或 Blocked Recipients 規則的郵件才轉發。

儲存設定

調整 Mailpit 設定後，請務必點擊介面底部的 Save 按鈕保存變更。

點擊 Reset 按鈕可將所有設定恢復為 Mailpit 預設值。

常見問題解答（FAQ）

• Q: 為什麼我的應用程式寄出的郵件沒出現在 Mailpit？
  • A: 請先檢查應用程式的郵件發送設定（常見為 SMTP 主機與 Port），請確定皆指向 ServBay 執行 Mailpit 的主機（通常是 127.0.0.1 或 localhost）以及您於 Mailpit 設定頁所指定的 SMTP 連接埠（預設為 1025）。並確認 Mailpit 已於 ServBay 啟動並運行。可於 ServBay 軟體包列表檢查狀態。
• Q: 需要為 Mailpit 配置 SSL 憑證嗎？
  • A: 不需要。得益於 ServBay 強大 PKI 系統，ServBay 會自動為 Mailpit 的 Web 介面、SMTP 和 POP3 服務的 STARTTLS/SSL/TLS 產生與安裝所需憑證。您只要於對應設定頁籤啟用加密選項即可。
• Q: Mailpit 的 Web 管理介面預設有帳號密碼嗎？
  • A: 預設情況下，Mailpit 的 Web 介面（https://mail.servbay.host）不需帳號密碼；SMTP 與 POP3 服務預設也不須驗證。如果您需強制 SMTP 或 POP3 ，可於對應頁籤自行設定帳號與密碼。

總結

透過 ServBay 整合的 Mailpit 軟體包，您可以輕鬆建立本地郵件測試環境。只需簡單設定 Mailpit 的 SMTP、POP3 及 Relay 配置，結合直觀的 Web 介面，即可大幅提升開發過程中處理郵件功能的效率與便利性。

請注意，修改設定後可能需重啟 Mailpit 軟體包才能生效。您可透過 ServBay 軟體包管理介面找到 Mailpit 並點擊重啟按鈕。