Docker로 Mailhog 설정 및 Laravel, Next.js, Django 연동 개발 이메일 테스트 가이드

핵심 기술

로컬 개발 환경에서 실제 이메일을 보내지 않고 이메일 발송 기능을 테스트할 수 있는 오픈소스 도구인 Mailhog를 Docker를 사용하여 간편하게 설정하고, Laravel, Next.js, Django 프레임워크와 연동하는 방법을 안내합니다.

기술적 세부사항

• Mailhog 소개: 인터넷 연결 없이도 사용 가능한 경량의 자체 호스팅 SMTP 서버 및 웹 UI 제공.
• Docker를 이용한 Mailhog 설치:
  • 기본 명령어: docker run -d --name docker-mailhog -p 1025:1025 -p 8025:8025 mailhog/mailhog
  • -d: 백그라운드 실행
  • --name mailhog: 컨테이너 이름 지정
  • -p 1025:1025: SMTP 포트 (1025) 매핑
  • -p 8025:8025: 웹 UI 포트 (8025) 매핑
  • Mailhog UI 접속: http://localhost:8025
  • 중지: docker stop mailhog, 삭제: docker rm mailhog
• Laravel 연동: .env 파일 설정
  • MAIL_MAILER=smtp
  • MAIL_HOST=localhost (또는 Docker 호스트 IP)
  • MAIL_PORT=1025
  • 테스트: php artisan tinker 또는 /send-mail-laravel 라우트
• Next.js (Node.js) 연동: Nodemailer 라이브러리 사용
  • 설치: npm install nodemailer 또는 yarn add nodemailer
  • API 라우트 (pages/api/send-mail.js) 설정 및 nodemailer.createTransport 사용
  • host: 'localhost', port: 1025, secure: false, ignoreTLS: true 설정
  • 테스트: curl -X POST http://localhost:3000/api/send-mail
• Django 연동: settings.py 설정
  • EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
  • EMAIL_HOST = 'localhost'
  • EMAIL_PORT = 1025
  • EMAIL_USE_TLS = False, EMAIL_USE_SSL = False
  • 테스트: python manage.py shell 또는 관리자 명령어 (send_test_email.py 예시)

개발 임팩트

• 실제 이메일 발송 없이 안전하고 효율적인 이메일 기능 테스트 가능.
• 로컬 개발 환경에서 인터넷 연결 없이도 이메일 테스트 가능.
• 다양한 프레임워크(Laravel, Next.js, Django)와의 통합으로 개발 생산성 향상.
• 외부 이메일 서비스 의존성 감소.

커뮤니티 반응

언급된 커뮤니티 반응은 없으나, 유사한 로컬 테스트 도구(Mailtrap 등)와의 비교를 통해 Mailhog의 장점(경량, 자체 호스팅, 오프라인 지원)을 부각하고 있습니다.