자택 서버의 OSS 앱 메일을 Mailpit으로 받아 Discord로 알림 받기

자택 서버에서 OSS 앱을 돌리다 보면 회원가입이나 비밀번호 재설정 등으로 메일을 보내야 할 때가 있습니다. 하지만 집에서 직접 메일을 보내려면 SMTP 서버를 준비하고 발신 도메인을 설정해야 해서 생각보다 손이 많이 갑니다. Qiita에서 찾은 이 글은 이 문제를 Mailpit과 Discord로 깔끔하게 해결하는 방법을 소개하고 있었습니다.

Mailpit은 원래 메일 발송 테스트용 도구입니다. SMTP 서버로 쓸 수 있고 테스트용 API도 갖추고 있습니다. 여기에 Webhook을 설정하면 메일을 받은 순간 외부 애플리케이션을 호출할 수 있습니다. 글에서는 이 기능을 이용해 받은 메일 내용을 Discord로 알려주는 구조를 만들었습니다.

구성은 Docker Compose로 Mailpit과 webhook-handler 두 컨테이너를 띄우는 것이 전부입니다. webhook-handler는 FastAPI로 만든 작은 Python 앱으로, Mailpit의 Webhook을 받아 발신자와 수신자를 정리해 Discord Webhook으로 보냅니다. 알림에는 Mailpit 웹 UI 링크도 붙일 수 있어서 필요할 때 메일을 바로 확인할 수 있습니다. Webhook URL 같은 설정은 .env 파일로 분리되어 있습니다.

실제로 밖으로 메일을 내보내지 않아도, 비밀번호 재설정 메일이 도착했는지 바로 알 수 있다는 점이 편리해 보였습니다. 홈랩에서 앱을 여러 개 운영하는 사람에게는 메일 수신처를 한곳으로 모으는 것이 관리를 꽤 쉽게 해 줄 것 같습니다. 글은 2026년 8월 게시물입니다.

출처: Qiita