
go-message
이메일 및 인터넷 메시지 포맷을 위한 오픈 소스 Go 라이브러리
스트리밍 Go API를 통해 RFC 5322, MIME 및 Content-Disposition 헤더를 파싱, 생성 및 처리합니다.
go-message란 무엇인가요?
go-message는 고성능 스트리밍 Go 라이브러리로, 인터넷 메시지 포맷(RFC 5322), MIME 확장(RFC 2045–2047) 및 Content-Disposition 헤더(RFC 2183)를 준수하는 이메일 메시지를 파싱하고 생성하도록 설계되었습니다. 전체 메시지를 메모리에 로드하지 않고도 이메일 콘텐츠를 효율적으로 처리할 수 있게 하여 확장 가능한 메일 서버와 클라이언트에 이상적입니다. 이 라이브러리는 자동 문자셋 디코딩을 지원하며 Go 표준 라이브러리와 원활하게 통합됩니다.
모듈성 및 확장성을 염두에 두고 구축된 go-message는 고수준 메일 처리를 위한 `mail`과 저수준 프로토콜 파싱을 위한 `textproto`와 같은 전용 서브패키지를 포함합니다. DKIM 친화적인 설계로 최신 이메일 인증 워크플로와의 호환성을 보장합니다. 내장 스트리밍 기능과 문자셋 정규화를 통해 go-message는 멀티파트 본문 파싱, 인코딩된 헤더 디코딩, 중첩 MIME 구조 처리와 같은 복잡한 이메일 처리 작업을 단순화하며 메모리 효율성과 성능을 유지합니다.
go-message 시작하기
go-message 사용을 시작하려면 공식 [go-message GitHub](https://github.com/emersion/go-message) 저장소에서 `go get`으로 설치하십시오. 권장 방법은 Go 모듈을 사용하는 것이며, 프로젝트 디렉터리에서 `go get github.com/emersion/go-message`를 실행합니다. 문자셋 디코딩 지원을 위해 `import _ "github.com/emersion/go-message/charset"`를 포함하여 모든 표준 인코딩을 활성화하십시오. 이 라이브러리는 가볍고 의존성이 없으며 기존 Go 애플리케이션에 원활하게 통합됩니다.
Go 모듈을 통해 go-message 설치
go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"
스트리밍 이메일 파싱
go-message는 전체 내용을 메모리에 로드하지 않고 이메일 메시지를 점진적으로 처리하는 스트리밍 파서를 제공합니다. 이는 대용량 이메일이나 고볼륨 메일 처리에 특히 유용합니다. 파서는 헤더와 본문 파트를 순차적으로 읽어 개발자가 실시간으로 메시지를 검사하거나 전달할 수 있게 합니다. RFC를 준수하는 메시지와 손상된 메시지를 모두 우아하게 지원하여 프로덕션 메일 서버에 적합합니다. Go의 `io.Reader`를 활용함으로써 라이브러리는 네트워크 및 파일 I/O 작업과 자연스럽게 통합됩니다.
스트리밍 API를 사용하여 이메일 메시지를 파싱하는 방법은?
import (
"bytes"
"github.com/emersion/go-message"
)
func parseEmail(data []byte) error {
r := bytes.NewReader(data)
m, err := message.Read(r)
if err != nil {
return err
}
// Access headers and body parts
return nil
}
MIME 멀티파트 처리
go-message는 RFC 2045 및 RFC 2046에 정의된 MIME 멀티파트 메시지의 파싱 및 생성을 완벽하게 지원합니다. 개발자는 직관적인 API를 사용하여 복잡한 멀티파트 구조(중첩 파트 포함)를 탐색할 수 있습니다. 라이브러리는 전송 인코딩(e.g., base64, quoted-printable)을 자동으로 디코딩하고 `Part` 인터페이스를 통해 개별 파트에 접근할 수 있게 합니다. 이를 통해 견고한 이메일 작성 및 첨부 파일, HTML/텍스트 대체본, 임베디드 리소스 추출이 가능해집니다. 스트리밍 특성 덕분에 많은 파트를 가진 대용량 멀티파트 메시지도 효율적으로 처리됩니다.
이메일에서 멀티파트 파트를 추출하는 방법은?
import (
"github.com/emersion/go-message"
"github.com/emersion/go-message/textproto"
)
func extractParts(m *message.Message) error {
if m.Multipart() {
for _, p := range m.Parts() {
// Process each part (e.g., text, attachment)
mediaType, params, _ := p.Header.MediaType()
if mediaType == "text/plain" {
// Read plain text content
content, _ := io.ReadAll(p.Body)
}
}
}
return nil
}
문자 집합 및 인코딩 지원
go-message는 이메일 헤더와 본문 내용에 대한 강력한 자동 문자셋 및 인코딩 처리를 포함합니다. RFC 2047 인코딩된 헤더(예: `=?utf-8?B?...?=`)와 다양한 문자셋(UTF-8, ISO-8859 등)의 본문 텍스트 디코딩을 지원합니다. 선택적인 `github.com/emersion/go-message/charset` 패키지를 가져오면 개발자는 `golang.org/x/text/encoding`을 통해 등록된 모든 IANA 문자셋에 접근할 수 있습니다. 이를 통해 수동 문자셋 감지나 변환 없이도 비라틴 스크립트와 특수 기호를 포함한 국제 이메일 콘텐츠를 정확하게 렌더링할 수 있습니다.
문자셋 인코딩된 헤더를 디코딩하는 방법은?
import (
"github.com/emersion/go-message"
_ "github.com/emersion/go-message/charset" // Enable all charsets
)
func decodeSubject(m *message.Message) (string, error) {
subject, err := m.Header.Get("Subject")
if err != nil {
return "", err
}
// Automatically decoded using registered charsets
return subject, nil
}
DKIM 친화적인 메시지 서명
go-message는 DKIM 친화적으로 설계되어 암호화 서명 및 검증 워크플로와의 원활한 통합을 가능하게 합니다. 스트리밍 파서는 메시지 구조 무결성을 유지하여 서명자가 재인코딩 없이 정규화된 본문과 선택된 헤더만 서명할 수 있게 합니다. 이 라이브러리는 DKIM 서명을 깨뜨릴 수 있는 불필요한 변환(예: 줄 끝 정규화)을 피합니다. 개발자는 `github.com/emersion/go-dkim`와 같은 라이브러리와 go-message를 결합하여 이메일 서명 파이프라인을 구축할 수 있으며, 도메인 기반 메시지 인증을 위한 RFC 6376 준수를 보장합니다.
DKIM 서명을 위해 메시지를 준비하는 방법은?
import (
"bytes"
"github.com/emersion/go-message"
"github.com/emersion/go-message/textproto"
)
func prepareForDKIM(m *message.Message) (*bytes.Buffer, error) {
var buf bytes.Buffer
// Write canonicalized headers and body
h := m.Header
h.WriteTo(&buf)
buf.WriteString("\r\n")
if _, err := io.Copy(&buf, m.Body); err != nil {
return nil, err
}
return &buf, nil
}
