Керівництво з налаштування сервісу Mailpit у ServBay

ServBay інтегрує пакет Mailpit, забезпечуючи зручний локальний поштовий сервер, спеціально розроблений для тестування й діагностики функцій надсилання пошти у додатках. У цій статті детально описується, як встановити, активувати та налаштувати Mailpit у ServBay включно з чотирма основними вкладками конфігурації: Common, SMTP, POP3 та Relay.

Огляд пакету Mailpit

Mailpit — це інструмент з відкритим кодом, який надає простий у використанні локальний SMTP/POP3 сервер та інтуїтивно зрозумілий веб-інтерфейс. Він дозволяє перехоплювати всі листи, надіслані вашим застосунком, щоб ви могли перевірити вміст, заголовки, вкладення тощо в одному центрі, не надсилаючи тестову пошту до справжніх поштових скриньок. Це значно спрощує процес розробки й діагностики, особливо коли мова йде про функціонал, пов’язаний із реєстрацією користувачів, скиданням паролів, повідомленнями тощо.

У ServBay Mailpit — основний інтегрований пакет. Ви можете просто встановлювати й керувати ним, а завдяки потужній PKI-системі ServBay налаштування SSL/TLS для безпечного тестового середовища відбувається автоматично.

Встановлення та активація пакету Mailpit

Перш ніж використовувати Mailpit як локальний поштовий сервер, потрібно встановити та ввімкнути пакет Mailpit у ServBay.

1. Відкрийте програму ServBay.
2. У лівій навігації виберіть Пакети.
3. В списку пакетів знайдіть категорію Універсальні сервіси.
4. Знайдіть пакет Mailpit.
5. Якщо Mailpit не встановлено, натисніть зелену кнопку встановлення праворуч.
6. Після встановлення натисніть перемикач поряд для активації пакету Mailpit.

Завдяки потужній PKI-системі ServBay, система автоматично створить та налаштує необхідні SSL-сертифікати для веб-інтерфейсу управління Mailpit, а також сервісів SMTP і POP3. Це означає, що ви можете одразу вмикати STARTTLS чи SSL/TLS шифрування без ручного отримання чи налаштування сертифікатів.

Веб-інтерфейс управління поштою

Mailpit постачається з потужним веб-інтерфейсом для перегляду та керування перехопленою електронною поштою. ServBay автоматично налаштовує цей інтерфейс, тож після активації пакету Mailpit ви можете отримати доступ до нього через браузер:

Адреса доступу: https://mail.servbay.host

Через цей інтерфейс ви зручно переглядаєте список листів, відкриваєте подробиці обраного повідомлення (HTML, текст, сирцевий код), шукаєте, видаляєте пошту тощо.

Налаштування пакету Mailpit

ServBay пропонує графічний інтерфейс для налаштування всіх параметрів Mailpit. У лівому меню виберіть Mail, а потім натисніть Mailpit Service Config. Ви побачите чотири головних вкладки налаштувань: Common, SMTP, POP3 та Relay.

1. Вкладка Common

Вкладка Common відповідає за загальні параметри та поведінку Mailpit:

• Max Messages: Максимальна кількість листів, які може зберігати сервер Mailpit. Якщо кількість перевищує цю межу, найстаріші листи буде автоматично видалено.
• Max Age: Максимальний термін збереження листів на сервері Mailpit (у днях). Після закінчення вказаного часу листи буде автоматично видалено.
• SpamAssassin: Увімкнути або вимкнути фільтр спаму SpamAssassin. Якщо увімкнено, Mailpit пробує позначати вхідні листи як спам.
• Webhook URL: URL-адреса для Webhook. Коли Mailpit отримує новий лист, на цю адресу надсилається HTTP POST-запит для сповіщення сторонніх систем або сервісів. Особливо корисно для інтеграції автоматичного тестування чи систем сповіщення.
• Webhook Limit: Обмеження на кількість листів, про які буде відправлено Webhook-сповіщення.

2. Вкладка SMTP

TIP

Завдяки PKI-системі ServBay SSL-сертифікати вже згенеровано й налаштовано автоматично. Можна одразу увімкнути шифрування через STARTTLS чи SSL/TLS — додаткові кроки для отримання або конфігурації сертифікату не потрібні.

У вкладці SMTP задаються налаштування SMTP-сервера Mailpit. До цього сервера підключається ваш додаток для надсилання тестових листів:

• SMTP Port: Порт, на якому слухає Mailpit SMTP-сервер. Ваш застосунок має відправляти пошту на цей порт за адресою 127.0.0.1 або localhost. Типово це 1025.
• STARTTLS: Увімкнути або вимкнути STARTTLS-шифрування. Дозволяє підвищити безпеку після встановлення з’єднання.
• SSL/TLS: Увімкнути чи вимкнути SSL/TLS-шифрування. У цьому випадку шифрування запускається одразу після підключення.
• Username: Ім’я користувача для SMTP-сервера (необовʼязково). Якщо вказати, додаток має аутентифікуватися цим ім’ям.
• Password: Пароль для SMTP-сервера (необовʼязково). Використовується разом із Username.
• Max Recipients: Максимальна кількість одержувачів в одному листі — обмежує масову розсилку.
• Allowed Recipients: Дозволені адреси чи домени одержувачів (необовʼязково). Якщо не вказано, Mailpit приймає листи на всі адреси. Якщо вказано, приймаються лише листи на вказані адреси чи домени.

3. Вкладка POP3

TIP

Завдяки PKI-системі ServBay SSL-сертифікати згенеровано й налаштовано автоматично. Можна одразу вмикати захищене SSL/TLS-з’єднання без додаткових дій.

У вкладці POP3 задаються параметри POP3 сервера Mailpit. Якщо ви тестуєте отримання пошти у своєму застосунку, підключайте клієнт до цього серверу:

• Enable POP3 Server: Увімкнути або вимкнути POP3-сервер Mailpit.
• POP3 Server Port: Порт для прослуховування POP3 Mailpit (типово 1110).
• Username: Ім’я користувача для POP3-сервера (необовʼязково). Якщо встановлено, клієнт мусить аутентифікуватися при підключенні.
• Password: Пароль для POP3-сервера (необовʼязково). Використовується із Username.
• SSL/TLS: Увімкнути чи вимкнути SSL/TLS-шифрування.

4. Вкладка Relay

Вкладка Relay використовується для налаштування пересилання листів. Ви можете налаштувати Mailpit як сервер релея для передачі певних або всіх листів на реальний зовнішній SMTP-сервер:

• Enable SMTP Relay: Увімкнути чи вимкнути функцію SMTP-релея.
• Host: Адреса зовнішнього SMTP-сервера для релея (наприклад, smtp.gmail.com, smtp.sendgrid.net).
• Port: Порт зовнішнього SMTP-сервера. Зазвичай 25 (SMTP), 465 (SMTPS) або 587 (Submission).
• STARTTLS: Увімкнути чи вимкнути STARTTLS-шифрування для підключення до релею.
• Allow Insecure: Дозволити підключення до SMTP через релей із недовіреним сертифікатом (не рекомендується для продакшин).
• Auth: Спосіб автентифікації на сервері релея: Login (ім’я користувача й пароль), Plain (схоже на Login) або CRAM-MD5 (алгоритм challenge-response).
• Username: Ім’я користувача для підключення до SMTP-сервера релея.
• Password: Пароль для SMTP-сервера релея.
• Return Path: Адреса для зворотної пошти (Return-Path заголовок).
• Allowed Recipients: Список дозволених адрес чи доменів для релея (необовʼязково).
• Blocked Recipients: Список адрес чи доменів, яким релей заборонено пересилати пошту (необовʼязково).
• Relay All: Якщо ввімкнено, Mailpit спробує переслати всі перехоплені листи (з урахуванням Allowed/Blocked Recipients).
• Relay Matching: Якщо ввімкнено, Mailpit буде пересилати лише ті листи, які відповідають правилам Allowed Recipients та Blocked Recipients.

Збереження конфігурації

Після внесення будь-яких змін у налаштування Mailpit не забудьте натиснути кнопку Save внизу сторінки для збереження параметрів.

Кнопка Reset повертає всі налаштування Mailpit до заводських.

Поширені запитання (FAQ)

• Q: Чому мій застосунок не відображає відправлені листи у Mailpit?
  • A: Перевірте налаштування відправки пошти у вашому додатку (зазвичай це хост і порт SMTP). Переконайтеся, що вони вказують на адресу, де Mailpit запущено у ServBay (127.0.0.1 або localhost) та порт, заданий у налаштуваннях Mailpit (типово 1025). Також переконайтеся, що пакет Mailpit активовано та запущено — перевірити це можна у списку пакетів ServBay.
• Q: Чи потрібно налаштовувати SSL-сертифікат для Mailpit?
  • A: Ні, завдяки PKI-системі ServBay вона автоматично згенерує та налаштує необхідні сертифікати для веб-інтерфейсу, а також для STARTTLS/SSL/TLS у сервісах SMTP та POP3. Вам потрібно лише увімкнути відповідну опцію шифрування у вкладці налаштувань.
• Q: Які стандартні ім'я користувача й пароль для веб-інтерфейсу Mailpit?
  • A: За замовчуванням, для доступу до веб-інтерфейсу за адресою https://mail.servbay.host не потрібно імені користувача чи пароля. SMTP та POP3 служби також не вимагають автентифікації за стандартом. Якщо потрібно змусити SMTP або POP3 вимагати ім’я користувача й пароль — налаштуйте це у відповідній вкладці.

Підсумок

Завдяки інтеграції Mailpit у ServBay ви можете швидко налаштувати локальне тестове середовище для роботи з поштою. Налаштування SMTP, POP3 та Relay у поєднанні з інтуїтивним веб-інтерфейсом суттєво підвищать зручність та ефективність обробки функцій пошти у процесі розробки.

Зверніть увагу: після зміни конфігурацій може знадобитися перезапуск пакету Mailpit для застосування нових налаштувань. Зробити це можна у менеджері пакетів ServBay — знайдіть Mailpit та натисніть кнопку перезапуску.