이 explanation 가이드는 관리자(Admin)가 Discourse 사이트에서 나가는 이메일 문제를 해결하는 방법에 대해 설명합니다.
필요한 사용자 권한: 관리자(Administrator)
Discourse는 사용자 알림 및 계정 관리 작업을 위해 이메일에 크게 의존합니다. 사용자가 Discourse 사이트에서 이메일을 수신하지 못하면 누락된 알림이나 계정 관리 문제 등 다양한 문제가 발생할 수 있습니다.
요약
이 문서에서는 다음 내용을 학습하게 됩니다:
- 전송된 이메일 로그 확인 방법
- 건너뛴(skipped) 및 반송(bounced)된 이메일 조사 방법
- 이메일 전달(deliverability) 문제의 일반적인 문제 해결 단계
- 주요 설정 및 해당 설정을 찾을 수 있는 위치
전송된 이메일 확인
이메일 문제를 해결할 때 첫 번째로 확인해야 할 곳은 사이트의 Admin → Emails → Sent 페이지(경로: .../admin/email/sent)입니다. Discourse의 Emails → Sent 페이지는 관리자가 포럼의 이메일 기능을 모니터링하고 문제를 해결하는 데 유용한 자료입니다. 이 페이지는 Discourse 인스턴스에서 성공적으로 전송된 모든 이메일에 대한 상세한 로그를 제공합니다.
이 페이지에서 전송된 이메일에 대해 확인할 수 있는 모든 정보는 다음과 같습니다:
- Sent At (전송 시각): 이메일이 전송된 지 얼마나 지났는지.
- User (사용자): 이메일을 수신한 사용자.
- To Address (수신자 주소): 수신자의 이메일 주소.
- Email Type (이메일 유형): 전송된 이메일의 유형입니다. 다이제스트, 메일링 리스트, 사용자 게시글, 사용자 개인 메시지 등일 수 있습니다.
- Reply Key (답장 키): 각 전송된 이메일에 대한 고유 식별자입니다. 이 키는 사용자가 알림 이메일에 답장할 때 Discourse가 해당 답장을 올바른 게시글과 사용자에게 정확히 매칭할 수 있도록 하여, 사용자가 이메일에서 직접 포럼 토론에 참여할 수 있게 합니다.
- Post (게시글): 이메일이 생성된 게시글의 ID입니다. 이 ID를 클릭하면 포럼의 실제 게시글로 이동합니다.
- SMTP Details (SMTP 상세 정보): 이메일 전송 시도를 한 후 SMTP 서버로부터 받은 응답을 나타내는 필드입니다.
250 2.0.0응답은 이메일이 첫 번째 이메일 서버(아웃바운드 릴레이)에 의해 전달을 위해 수락되었음을 의미합니다.
사용자가 Discourse에서 이메일을 받지 못했다고 보고하고, Discourse에서 해당 사용자의
Post & SMTP Details아래에250 2.0.0 Ok: queued as ...메시지가 표시되는 경우, 해당 사용자에게 다시 받은편지함을 확인하고, 혹시 이메일을 놓치지 않았는지 스팸 폴더도 함께 확인해 보도록 권장할 수 있습니다. 이 상태는 이메일이 첫 번째 메일 서버에 의해 수락되었음을 나타내지만, 최종 받은편지함으로의 전달을 보장하지는 않습니다. 이메일은 후속 서버에 의해 필터링, 지연 또는 삭제될 수 있습니다.또한, 사용자가 이메일 서버를 관리하는 지원 팀이나 IT 부서에 연락하여 큐에 추가된 것으로 보고된 후 이메일에 무슨 일이 일어나고 있는지 파악하고 있는지 확인해 보도록 권장할 수도 있습니다. 아웃바운드 메일 서버 로그에 액세스 권한이 있거나(또는 Discourse 호스팅 인프라를 사용하는 경우), SMTP Details에 표시된 큐 ID를 사용하여 전달 체인을 통해 이메일의 경로를 추적할 수 있습니다.
이메일이 Discourse의 Emails → Sent 페이지에 표시되지 않으면, 해당 이메일이 Discourse 인스턴스에서 성공적으로 전송되지 않았음을 의미합니다.
이메일 문제 해결에 사용할 수 있는 다른 페이지들을 살펴봅시다.
건너뛴 이메일 조사
사이트의 .../admin/email/skipped 페이지에 위치한 Skipped Emails 페이지에는 Discourse가 다양한 이유로 전송하지 않기로 결정한 모든 이메일이 나열됩니다. 각 건너뛴 이메일 옆에는 이메일이 전송되지 않은 이유에 대한 통찰을 제공하는 Skip Reason(건너뜀 이유)가 표시됩니다.
이 페이지에서 건너뛴 이메일에 대해 확인할 수 있는 정보는 다음과 같습니다:
- Time (시간): 이메일이 전송되어야 했지만 대신 건너뛴 날짜와 시간.
- User (사용자): 이메일을 수신해야 했던 사용자.
- To Address (수신자 주소): 수신자의 이메일 주소.
- Email Type (이메일 유형): 건너뛴 이메일의 유형으로,
digest,mailing list,user posted,user private message등이 될 수 있습니다. - Skip Reason (건너뜀 이유): 이메일이 건너뛴 이유입니다. 일반적인 이유로는 사용자가 사이트에 활동 중임, 사용자가 게시글을 이미 읽음, 사용자가 반송 점수(bounce score) 임계값을 초과한 것 등이 있습니다.
Exceeded bounce_score_threshold(반송 점수 임계값 초과)가 무엇을 의미합니까?
Discourse에서 사용자의 이메일 주소로 전송된 이메일이 반송될 때마다 사용자의 '반송 점수(bounce score)'가 증가합니다. '반송 점수’는 특정 주소로 전송된 이메일의 실패한 전달 시도 횟수를 측정하는 지표입니다.
Discourse의 Exceeded bounce_score_threshold 메시지는 사용자의 '반송 점수’가 특정 한도를 초과하는 상황을 가리키며, Discourse에서 나가는 이메일 문제를 해결해야 하는 가장 일반적인 이유 중 하나입니다.
반송된 이메일은 수신자에게 전달할 수 없어 발신자에게 반환되는 이메일입니다. 이는 다양한 이유로 발생할 수 있으며, 이 경우 발신자의 이메일 시스템은 전달 문제에 대한 알림을 수신합니다.
이메일 반송에는 두 가지 유형이 있습니다:
- Hard Bounce (경질 반송): 이는 영구적인 전달 실패입니다. 일반적으로 수신자의 이메일 주소가 유효하지 않거나 더 이상 사용되지 않을 때 발생합니다. 다른 이유는 도메인 이름이 존재하지 않거나 수신자의 이메일 서버가 전달을 완전히 차단한 경우일 수 있습니다.
- Soft Bounce (연질 반송): 이는 일시적인 전달 문제입니다. 수신자의 메일함이 가득 차 있거나, 이메일 서버가 일시적으로 다운되거나 과부하 상태이거나, 이메일 메시지가 너무 큰 경우 등이 원인이 될 수 있습니다.
bounce_score_threshold를 조정할 수 있습니까?
네! 참고: Bounce Score Site Settings.
그러나 반송 점수 설정을 조정하기 전에 이메일 전달 관련 근본적인 문제가 완전히 해결되었는지 확인하는 것이 중요합니다.
이를 염두에 두고, Discourse에서 반송된 이메일에 대해 볼 수 있는 다른 정보들을 논의해 보겠습니다.
반송된 이메일 문제 해결
반송된 이메일 페이지는 .../admin/email/bounced에 위치하며, 모든 반송된 이메일에 대한 상세한 개요를 제공합니다. 이 페이지에서 반송된 이메일에 대해 볼 수 있는 내용은 다음과 같습니다:
- Time (시간): 이메일이 반송된 날짜와 시간.
- User (사용자): 이메일을 수신해야 했던 사용자.
- To Address (수신자 주소): 수신자의 이메일 주소.
- Email Type (이메일 유형): 건너뛴 이메일의 유형입니다. 다이제스트, 메일링 리스트, 사용자 게시글, 사용자 개인 메시지 등일 수 있습니다.
Bounced 페이지에서 (i) 아이콘을 클릭하여 반송된 이메일에 대한 추가 세부 정보를 볼 수 있습니다:
Incoming Email Details 창에는 반송된 이메일에 대한 상세한 정보가 포함되어 있으며, 일반적으로 Body 섹션에서 이메일이 반송된 이유에 대한 설명을 제공합니다.
Discourse에서 온 이메일이 반송될 수 있는 몇 가지 이유는 다음과 같습니다:
- 유효하지 않은 이메일 주소: 수신자의 이메일 주소가 유효하지 않거나, 존재하지 않거나, 삭제된 경우 이메일이 반송됩니다.
- 메일함 만료: 수신자의 메일함이 가득 차 새로운 메시지를 받을 수 없는 경우 이메일이 반송됩니다.
- 서버 문제: 수신자의 이메일 서버가 다운되었거나 일시적으로 사용할 수 없는 경우 이메일이 반송됩니다. 이는 일반적으로 일시적인 문제입니다.
- 차단된 발신자: 수신자의 이메일 서버가 Discourse 이메일 주소를 차단했거나, 일반적으로 이메일 보안 정책으로 인해 특정 도메인에서만 수신 이메일을 허용할 수 있습니다.
- 공격적인 스팸 필터: 이메일 내용이 수신자의 이메일 서버에 의해 스팸으로 플래그 지정되면, 이메일이 반송될 수 있습니다.
- 자동 응답: 일부 자동 응답 시스템(예: 부재중 응답)은 연질 반송(soft bounce)을 일으킬 수 있습니다.
이러한 상황에서 이메일이 반송되고 있는 사용자에게 이메일 서비스 제공업체에 문의하도록 하는 것이 최선의 선택입니다. 이메일 서비스 제공업체는 이메일이 차단되거나 거부되는 등의 이유에 대한 구체적인 통찰을 제공하고, 보안 설정을 조정하거나 Discourse 이메일 서비스를 화이트리스트에 추가할 수 있습니다. 또한 진행 중인 이메일 서버 유지 관리나 이메일 반송을 일으키는 다른 문제들을 알고 있을 수도 있습니다.
사용자가 자신의 이메일 서비스에 대한 제어 권한을 가지고 있으며 Microsoft Hosted Exchange 또는 Google Workspace를 사용하는 경우, Microsoft Hosted Exchange에서 CDCK 호스팅 사이트의 이메일 스팸 우회 및 Google Workspace에서 Discourse 호스팅 사이트의 이메일 스팸 우회에 대한 절차도 제공합니다.
사용자의 반송 점수 초기화를 수행하거나, 문제가 여러 사용자에게 영향을 미쳤다면 모든 사용자의 반송 점수 일괄 초기화를 수행해야 합니다. 반송 점수가 초기화된 후, Discourse는 bounce_score_threshold를 초과했던 사용자에게 이메일 전달을 재개하려고 시도합니다.
추가 단계
이메일 설정 및 문제 해결은 관련 변수가 많아 복잡할 수 있습니다. 사이트의 Admin → Email 섹션을 통해 이메일 문제를 해결하는 것 외에도, 여전히 이메일이 Discourse 사이트에서 올바르게 전달되지 않는 이유를 파악하는 데 어려움을 겪고 있다면 이메일 전달 구성 체크리스트를 살펴보는 것도 좋습니다.
Discourse 사이트가 최근에 설정된 경우, 새로운 Discourse 설치 환경에서의 이메일 문제 해결에 대한 가이드도 제공합니다(셀프 호스팅 설치만 해당).
마지막으로, Admin > Logs(.../logs/)로 이동하여 Discourse 로그 페이지를 확인하고, 이메일 전달과 관련된 오류가 있는지 살펴볼 수 있습니다.
