지식 베이스
자신의 Mailgun 계정을 통해 이메일 발송
나만의 Mailgun 계정 연결하기: 발신 서브도메인 추가, 게시할 SPF, DKIM 및 MX 레코드, 개인 API 키가 아닌 발신 키, 그리고 EU 호스팅 계정이 US 호스트에 대해 401 오류를 반환하는 이유.
Mailgun 계정과 도메인의 DNS에 대한 액세스 권한이 필요합니다.
Mailgun 자체 문서: 도메인 추가 및 확인 · API 키 · 가입하기
1. Mailgun에 발송 도메인 추가하기
Mailgun 대시보드에서 Send → Domains → Add New Domain으로 이동하여 mail.yourdomain.com과 같은 서브도메인을 입력합니다.
⚠️ Mailgun 자체 지침은 서브도메인을 사용하는 것이며, 이는 다른 일부 제공업체보다 여기서 더 중요합니다. Mailgun은 사용자가 제공하는 도메인에 자체 SPF 및 DKIM 레코드를 설정하므로, 루트 도메인을 가리키게 하면 해당 레코드가 비즈니스 메일함이 의존하는 레코드와 함께 배치됩니다.
데이터를 저장할 지역(미국 US 또는 유럽 EU)을 선택합니다. 이를 기록해 두십시오. 4단계에서 필요하며, 사람들이 가장 흔히 실수하는 부분입니다.
2. Mailgun이 제공하는 DNS 레코드 게시하기
Mailgun에 목록이 표시됩니다. DNS 제공업체에 해당 항목을 모두 추가하십시오.
| 유형 | 호스트 | 용도 | | --- | --- | --- | | TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all | | TXT | mailo._domainkey.mail.yourdomain.com | DKIM 공개 키 | | CNAME | email.mail.yourdomain.com | 추적 및 반송 처리 | | MX | mail.yourdomain.com | 반송 수신(Mailgun의 두 MX 호스트) |
⛔ 발송 서브도메인에 이미 SPF 레코드가 있는 경우, 두 번째로 추가하지 말고 기존 레코드를 편집하십시오. SPF TXT 레코드가 두 개 있는 도메인은 SPF 검사에 완전히 실패하며, 이는 아예 없는 것보다 더 나쁩니다.
그런 다음 Mailgun에서 Verify DNS Settings를 누릅니다. 녹색으로 바뀌는 데 최대 1시간이 걸릴 수 있습니다.
⭐ 발송만 하는 경우에도 MX 레코드를 추가하십시오. 이는 Mailgun이 반송을 수집하는 방법입니다. MX 레코드가 없으면 잘못된 주소로의 반송이 갈 곳을 잃고, Mailgun은 이를 차단할 수 없으며, 사용자는 영원히 아무것도 받지 못할 주소로 발송하는 비용을 계속 지불하게 됩니다.
3. API 키 가져오기
Send → Sending → Domain settings → API keys 또는 계정의 API Keys 페이지로 이동합니다.
계정의 개인 API 키 대신, 요금제에서 지원하는 경우 이 도메인으로 범위가 지정된 발송 키를 사용하십시오. 발송 키는 발송만 수행할 수 있는 반면, 개인 키는 로그를 읽고 계정을 변경할 수 있습니다. 당사가 두 번째 키를 보관해야 할 이유는 없습니다.
4. Zinn®에서 연결하기
대시보드에서 Email sending을 열고 다음을 입력합니다.
- Provider — Mailgun
- Send from this domain —
mail.yourdomain.com(주소가 아닌 도메인) - Mailgun sending domain — Mailgun에 추가한 것과 동일한 도메인
- Region — 1단계와 일치하는
us또는eu - Mailgun API key — 3단계의 키
⛔⛔ 지역을 올바르게 설정하십시오. EU 호스팅 Mailgun 계정은 완전히 다른 API 호스트에서 서비스됩니다. EU 계정의 키를 US 호스트로 전송하면 "401 Unauthorized"가 반환되며, 이는 잘못된 키로 인해 발생하는 현상과 정확히 일치합니다. 키가 확실히 맞는데도 401 오류가 발생하는 경우 거의 항상 이 때문입니다.
5. 테스트 발송 및 코드 입력
다른 도메인의 받은편지함(Gmail 주소가 이상적임)을 사용하여 Send test message를 누릅니다. 해당 받은편지함에서 코드를 확인하여 입력합니다. 메일이 즉시 전환됩니다.
작동하지 않는 경우
401 Unauthorized — 잘못된 지역(위 참조)이거나 다른 Mailgun 계정의 키를 붙여넣은 경우입니다. 키를 다시 입력하지 말고 새로 생성하십시오. 맨 앞의 key-를 놓치기 쉽습니다.
테스트 메시지가 도착하지 않음 — Mailgun의 Logs 페이지를 확인하십시오. Mailgun에 기록이 전혀 없다면 자격 증명이나 도메인 이름이 잘못된 것입니다. Mailgun이 수신을 수락한 후 실패한 경우, 그 이유는 평문으로 표시되며 거의 항상 DNS 문제입니다.
"Domain not found" — Mailgun sending domain 필드는 서브도메인을 포함하여 Mailgun에 나열된 도메인과 정확히 일치해야 합니다. yourdomain.com과 mail.yourdomain.com은 Mailgun에서 서로 다른 두 개의 도메인입니다.
작동하다가 중단됨 — 무료 평가판이 종료되었는지 확인하십시오. Mailgun 평가판 계정은 승인된 수신자에게만 발송할 수 있으므로, 자신의 주소로 보내는 테스트 메시지는 계속 작동하는 반면 고객에게 보내는 모든 메시지는 조용히 실패하게 됩니다.