Mailpit은 로컬 개발 환경에서 메일 전송을 테스트할 때, 메일을 외부로 보내지 않고 로컬에서 보내고 로컬에서 받아볼 수 있게 해주는 도구다.
회원가입 메일, 비밀번호 재설정 메일, 결제 완료 메일 같은 기능을 개발할 때 유용하다.
사용 개념
- 애플리케이션은 실제 메일 서버 대신 Mailpit의 SMTP 서버로 메일을 보낸다.
- Mailpit은 그 메일을 저장하고,
- 우리는 웹 UI로 메일 내용을 확인한다.
설치 및 실행
공식 문서 참고: https://mailpit.axllent.org/docs/install/
SMTP 설정
메일 전송 설정에서 SMTP 서버를 다음처럼 지정하면 된다. 당연히 암호화나 계정 같은 건 없다.
- SMTP 서버:
localhost - SMTP 포트:
1025
이 상태에서 애플리케이션이 메일을 보내면, 실제 메일은 외부로 나가지 않는다.
메일 확인
받은 메일을 보려면 브라우저에서 아래 주소로 접속하면 된다.
http://localhost:8025로컬 개발 환경에서 메일 기능을 테스트할 때, 매우 유용하다.
여담
원래는 FakeSMTP를 사용했는데, 맥 자바 17에서 이런 에러가 났다.
java -jar fakeSMTP-2.0.jar
30 12월 2025 00:46:58 ERROR com.nilhcem.fakesmtp.core.exception.UncaughtExceptionHandler -
java.lang.IllegalAccessError: class com.nilhcem.fakesmtp.FakeSMTP$1 (in unnamed module @0x6e31c3e1) cannot access class com.apple.eawt.Application (in module java.desktop) because module java.desktop does not export com.apple.eawt to unnamed module @0x6e31c3e1
(이하 생략)보니까 이렇게 실행을 하면 해결이 됐다.
java --add-exports=java.desktop/com.apple.eawt=ALL-UNNAMED -jar fakeSMTP-2.0.jar좀 번거로워졌다고 생각한 참에 알게 돼 사용해 봤는데 편리해서 소개해 봤다.
댓글 남기기