ServBay

한국어

English
简体中文
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Bahasa Melayu
Polski
Nederlands
Українська
ไทย

한국어

English
简体中文
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Bahasa Melayu
Polski
Nederlands
Українська
ไทย

Appearance

ServBay Mailpit 서비스 설정 가이드 ​

ServBay는 개발자가 애플리케이션의 이메일 전송 기능을 쉽고 편리하게 테스트하고 디버깅할 수 있도록 Mailpit 소프트웨어 패키지를 통합 제공합니다. 본 문서에서는 ServBay에서 Mailpit을 설치, 활성화 및 구성하는 방법과, Common, SMTP, POP3, Relay의 네 가지 주요 설정 탭에 대해 자세히 설명합니다.

Mailpit 소프트웨어 개요 ​

Mailpit은 오픈소스 도구로, 사용하기 쉬운 로컬 SMTP/POP3 서버와 직관적인 웹 인터페이스를 제공합니다. 애플리케이션이 전송하는 모든 이메일을 수집해서, 실메일함으로 테스트 메일을 보낼 필요 없이 한 곳에서 메일 내용, 헤더, 첨부파일 등을 확인할 수 있습니다. 회원가입, 비밀번호 재설정, 각종 알림 등 이메일 전송이 필요한 기능을 개발·테스트할 때 개발과 디버깅 과정을 대폭 간소화해줍니다.

ServBay에서는 Mailpit이 핵심 패키지로 통합되어 손쉽게 설치·관리할 수 있고, ServBay의 강력한 PKI 시스템을 이용해 SSL/TLS 인증서도 자동으로 설정되어 안전한 테스트 환경이 보장됩니다.

Mailpit 패키지 설치 및 활성화 ​

Mailpit을 로컬 메일 서버로 사용하기 전에 ServBay에서 Mailpit 패키지를 설치하고 활성화해야 합니다.

  1. ServBay 앱을 실행합니다.
  2. 왼쪽 사이드바에서 소프트웨어 패키지를 선택합니다.
  3. 패키지 목록에서 공통 서비스(통합 서비스) 카테고리를 찾습니다.
  4. Mailpit 패키지를 선택합니다.
  5. Mailpit이 설치되어 있지 않다면, 우측의 녹색 설치 버튼을 클릭해 설치합니다.
  6. 설치가 완료되면, 옆의 스위치 버튼을 눌러 Mailpit 패키지를 활성화합니다.

ServBay에서 Mailpit 패키지를 설치하는 방법

ServBay의 PKI 시스템 덕분에, Mailpit 웹 관리 페이지와 SMTP·POP3 서비스용 SSL 인증서는 자동 생성 및 설정됩니다. 즉, STARTTLS 또는 SSL/TLS 암호화를 별도의 인증서 발급·설정 없이 바로 사용할 수 있습니다.

웹 메일 관리 인터페이스 ​

Mailpit에는 강력한 웹 인터페이스가 내장되어 있어, 캡처된 이메일을 시각적으로 관리할 수 있습니다. ServBay에서 Mailpit 패키지를 활성화하면 별도의 설정 없이 다음 주소로 웹 메일 관리 페이지에 바로 접속할 수 있습니다:

접속 주소: https://mail.servbay.host

웹 인터페이스에서는 수신 메일 목록 조회, 개별 메일 상세 내용(HTML, 순수 텍스트, 소스 코드) 확인, 메일 검색 및 삭제 등 다양한 기능을 편리하게 사용할 수 있습니다.

ServBay의 Mailpit 웹 관리 페이지 접속 방법

Mailpit 패키지 설정 ​

ServBay는 Mailpit의 다양한 옵션을 시각적으로 쉽게 설정할 수 있도록 GUI를 제공합니다. 왼쪽 메뉴에서 Mail을 선택한 후, Mailpit Service Config를 클릭하면 설정 화면이 열립니다. 주요 설정 탭은 Common, SMTP, POP3, Relay의 네 가지입니다.

1. Common 탭 ​

Mailpit 기본 설정 방법

Common 탭에서는 Mailpit의 일반 동작과 관련된 설정을 할 수 있습니다:

  • Max Messages: Mailpit 서버에 저장할 수 있는 최대 메일 개수를 지정합니다. 제한을 초과할 경우, 가장 먼저 받은 메일부터 자동 삭제됩니다.
  • Max Age: 메일이 Mailpit 서버에 보관되는 최대 기간(일 단위)을 지정합니다. 기간을 넘긴 메일은 자동으로 삭제됩니다.
  • SpamAssassin: 스팸 필터 기능(SpamAssassin)을 켜거나 끕니다. 활성화 시 메일이 스팸 여부에 따라 표시됩니다.
  • Webhook URL: Webhook URL을 설정합니다. Mailpit이 새 메일을 수신할 때 지정한 URL로 HTTP POST 요청을 보내 외부 시스템 또는 서비스에 알릴 수 있습니다. 자동화 테스트, 알림 시스템 통합에 유용합니다.
  • Webhook Limit: Webhook 알림을 보낼 수 있는 최대 메일 수를 지정합니다.

2. SMTP 탭 ​

TIP

ServBay의 PKI 시스템 덕분에 SSL 인증서가 자동 발급 및 설정되어 있습니다. 따라서 STARTTLS 또는 SSL/TLS 암호화 연결을 별도 작업 없이 바로 활성화하실 수 있습니다.

Mailpit의 SMTP 서비스 설정

SMTP 탭에서는 Mailpit의 SMTP 서버 설정을 관리합니다. 애플리케이션은 이 SMTP 서버에 연결하여 테스트 메일을 발송하게 됩니다:

  • 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: 수신 허용 이메일 주소 또는 도메인 목록(옵션)입니다. 비워두면 모든 주소로 메일을 보낼 수 있으며, 설정 시 목록 내로 제한됩니다.

3. POP3 탭 ​

TIP

ServBay의 PKI 시스템 덕분에 SSL 인증서가 자동 발급 및 설정되어 있습니다. POP3 역시 SSL/TLS 암호화 연결을 즉시 활성화할 수 있습니다.

Mailpit의 POP3 서비스 설정 방법

POP3 탭에서는 Mailpit의 POP3 서버 설정을 관리할 수 있습니다. 애플리케이션의 메일 수신 기능 테스트가 필요한 경우 다음과 같이 POP3 클라이언트로 연결할 수 있습니다:

  • Enable POP3 Server: Mailpit의 POP3 서버를 활성화하거나 비활성화할 수 있습니다.
  • POP3 Server Port: Mailpit POP3 서버가 리스닝할 포트 번호를 지정합니다. 기본값은 1110입니다.
  • Username: POP3 서버 인증에 사용할 사용자 이름(옵션)입니다. 설정 시 연결할 때 필수로 입력해야 합니다.
  • Password: POP3 서버 인증에 사용할 비밀번호(옵션)입니다. Username과 함께 사용합니다.
  • SSL/TLS: SSL/TLS 암호화 연결 사용 여부를 설정합니다.

4. Relay 탭 ​

Mailpit의 메일 릴레이 기능 설정 방법

Relay 탭에서는 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: 체크 시 모든 캡처된 메일을 릴레이 시도(Allowed/Blocked Recipients 규칙 적용).
  • Relay Matching: 체크 시 Allowed/Blocked Recipients 규칙에 일치하는 메일만 릴레이합니다.

설정 저장 ​

Mailpit 설정을 변경한 경우, 반드시 화면 하단의 Save 버튼을 눌러 변경사항을 저장하세요.

Reset 버튼을 클릭하면 모든 설정이 Mailpit의 기본값으로 초기화됩니다.

FAQ (자주 묻는 질문) ​

  • Q: 내 앱이 보낸 메일이 Mailpit에 표시되지 않습니다.
    • A: 앱의 메일 발송(SMTP) 설정이 ServBay에서 Mailpit이 동작하는 주소(127.0.0.1 또는 localhost)와 Mailpit 구성에서 지정한 SMTP 포트(기본 1025)로 되어 있는지 확인하세요. 또한 ServBay에서 Mailpit 패키지가 활성화되어 있는지도 패키지 목록에서 확인할 수 있습니다.
  • Q: Mailpit에 SSL 인증서가 필요한가요?
    • A: 별도의 인증서가 필요 없습니다. ServBay의 PKI 시스템이 Mailpit의 웹, SMTP, POP3 서비스에 필요한 STARTTLS/SSL/TLS 인증서를 자동 생성 및 설정합니다. 옵션에서 암호화만 활성화하면 됩니다.
  • Q: Mailpit 웹 관리자 기본 아이디/비밀번호가 있나요?
    • A: 기본적으로 https://mail.servbay.host 주소의 Mailpit 웹 UI는 아이디/비밀번호 없이 접속할 수 있습니다. SMTP와 POP3 서비스 역시 인증이 필요 없도록 기본 설정되어 있습니다. 인증이 필요하다면 해당 설정 탭에서 직접 사용자명과 비밀번호를 입력하면 됩니다.

요약 ​

ServBay에 통합된 Mailpit 패키지를 활용하면 간편하게 로컬 메일 테스트 환경을 구축할 수 있습니다. SMTP, POP3, 릴레이 설정과 직관적인 웹 인터페이스를 조합하면 개발 중 이메일 관련 기능의 효율성과 편의성이 크게 높아집니다.

참고로 설정 변경 후에는 Mailpit 패키지를 재시작해야 설정이 적용될 수 있습니다. ServBay의 패키지 관리 화면에서 Mailpit을 찾아 재시작 버튼을 클릭하면 됩니다.