<div id="readability-page-1" class="page"><div>
<p>Mailpit은 로컬 개발 환경에서 메일 전송을 테스트할 때, 메일을 외부로 보내지 않고 로컬에서 보내고 로컬에서 받아볼 수 있게 해주는 도구다.</p>



<p>회원가입 메일, 비밀번호 재설정 메일, 결제 완료 메일 같은 기능을 개발할 때 유용하다.</p>


<h2 id="%25ec%2582%25ac%25ec%259a%25a9-%25ea%25b0%259c%25eb%2585%2590">사용 개념</h2>


<ul>
<li>애플리케이션은 실제 메일 서버 대신 Mailpit의 SMTP 서버로 메일을 보낸다.</li>



<li>Mailpit은 그 메일을 저장하고,</li>



<li>우리는 웹 UI로 메일 내용을 확인한다.</li>
</ul>


<h2 id="%25ec%2584%25a4%25ec%25b9%2598-%25eb%25b0%258f-%25ec%258b%25a4%25ed%2596%2589">설치 및 실행</h2>


<p>공식 문서 참고: <a href="https://mailpit.axllent.org/docs/install/">https://mailpit.axllent.org/docs/install/</a></p>


<h2 id="smtp-%25ec%2584%25a4%25ec%25a0%2595">SMTP 설정</h2>


<p>메일 전송 설정에서 SMTP 서버를 다음처럼 지정하면 된다. 당연히 암호화나 계정 같은 건 없다.</p>



<ul>
<li>SMTP 서버: <code>localhost</code></li>



<li>SMTP 포트: <code>1025</code></li>
</ul>



<p>이 상태에서 애플리케이션이 메일을 보내면, 실제 메일은 외부로 나가지 않는다.</p>


<h2 id="%25eb%25a9%2594%25ec%259d%25bc-%25ed%2599%2595%25ec%259d%25b8">메일 확인</h2>


<p>받은 메일을 보려면 브라우저에서 아래 주소로 접속하면 된다.</p>



<pre><code>http://localhost:8025</code></pre>



<p>로컬 개발 환경에서 메일 기능을 테스트할 때, 매우 유용하다.</p>


<h2 id="%25ec%2597%25ac%25eb%258b%25b4">여담</h2>


<p>원래는 <a href="https://mytory.net/archives/15992">FakeSMTP</a>를 사용했는데, 맥 자바 17에서 이런 에러가 났다.</p>



<pre><code>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
(이하 생략)</code></pre>



<p>보니까 이렇게 실행을 하면 해결이 됐다.</p>



<pre><code><code>java --add-exports=java.desktop/com.apple.eawt=ALL-UNNAMED -jar fakeSMTP-2.0.jar</code></code></pre>



<p>좀 번거로워졌다고 생각한 참에 알게 돼 사용해 봤는데 편리해서 소개해 봤다.</p>
</div></div>

웹으로 말하기

Mailpit은 로컬 개발 환경에서 메일 전송을 테스트할 때, 메일을 외부로 보내지 않고 로컬에서 보내고 로컬에서 받아볼 수 있게 해주는 도구다. 회원가입 메일, 비밀번호 재설정 메일, 결제 완료 메일 같은 기능을 개발할 때 유용하다. 사용 개념 설치 및 실행 공식 문서 참고: https://mailpit.axllent.org/docs/install/ SMTP 설정 메일 전송 설정에서 SMTP 서버를 다음처럼 지정하면 된다. 당연히 암호화나 계정 […]

로컬 개발시 이메일 전송 테스트할 수 있는 유용한 프로그램 Mailpit

댓글