📧

Gmail 발급 가이드

난이도⭐⭐☆☆☆

💡 Gmail SMTP란?

본인 Gmail 계정으로 메일 자동 발송이 가능해요. 회원가입 환영 메일 / 비밀번호 재설정 / 주문 확인 메일 같은 용도에 진짜 편해요.

  • ✅ 본인 Gmail 주소로 발송 (사용자 친숙)
  • ✅ 무료 (하루 500통 / Workspace는 2,000통)
  • ✅ 5분이면 발급 완료

Google 2단계 인증 활성화 (필수)

앱 비밀번호 발급에 2FA가 필수예요. 안 되어있으면 메뉴 자체가 안 보여요!

myaccount.google.com/security 접속 → "2단계 인증" 활성화.

앱 비밀번호 발급

myaccount.google.com/apppasswords 직접 접속.

앱 이름 입력 (예: Foundry Mail) → "만들기" 클릭.

16자 비밀번호 표시 (예: abcd efgh ijkl mnop) — 복사 즉시 보관!

Foundry 환경변수 입력

발급 받은 정보 입력:

  • GMAIL_USER = myemail@gmail.com (본인 이메일)
  • GMAIL_APP_PASSWORD = abcd efgh ijkl mnop (16자 앱 비번)

공백은 있어도 / 없어도 OK (abcdefghijklmnop 도 작동).

(선택) 발송 테스트

저장 후 자동 재배포되면 회원가입 / 비밀번호 재설정 흐름에서 메일 수신 확인.

메일이 스팸함에 들어가면 → 발송자 신뢰도 개선 필요 (수동 "안전한 발신자" 추가).

❓ 자주 묻는 질문

앱 비밀번호 메뉴가 안 보여요
2단계 인증이 활성화 안 되어있어요. Step 1 다시 확인.
'Invalid login' 에러가 나요
  • Google 계정 비밀번호 아니라 앱 비밀번호 16자 사용했나요?
  • GMAIL_USER가 정확히 본인 이메일인가요?
  • "보안 수준이 낮은 앱" 설정은 deprecated (요즘은 앱 비밀번호로 대체)
하루 500통 한도 초과하면?
24시간 임시 차단돼요. 본격 사업이면 Resend 옵션 (무료 100/일 ~ 무제한 플랜) 추천.
발송한 메일이 스팸함에 들어가요
본인 Gmail은 SPF/DKIM 기본 OK인데, 받는 사람 메일 서버 분류 정책에 따라 다를 수 있어요. "안전한 발신자" 추가 안내 / Resend로 도메인 발송 전환.

🔗 참고 링크