go-message

 
 

Открытая библиотека Go для электронной почты и формата интернет‑сообщений

Разбирайте, генерируйте и обрабатывайте заголовки RFC 5322, MIME и Content-Disposition с помощью потокового API Go.

Что такое go-message?

go-message — это высокопроизводительная потоковая библиотека Go, предназначенная для разбора и создания email‑сообщений, соответствующих формату Internet Message Format (RFC 5322), расширениям MIME (RFC 2045–2047) и заголовкам Content‑Disposition (RFC 2183). Она позволяет разработчикам Go эффективно обрабатывать содержимое писем без загрузки полностью сообщений в память, что делает её идеальной для масштабируемых почтовых серверов и клиентов. Библиотека поддерживает автоматическое декодирование наборов символов и бесшовно интегрируется со стандартной библиотекой Go.

Созданная с учётом модульности и расширяемости, go-message включает специализированные подпакеты, такие как `mail` для высокоуровневой обработки почты и `textproto` для низкоуровневого разбора протоколов. Её дизайн, ориентированный на DKIM, обеспечивает совместимость с современными рабочими процессами аутентификации электронной почты. Благодаря встроенным возможностям потоковой передачи и нормализации наборов символов, go-message упрощает сложные задачи обработки email, такие как разбор multipart‑телов, декодирование закодированных заголовков и обработка вложенных MIME‑структур — всё это при сохранении эффективности использования памяти и производительности.

Previous Next

Начало работы с go-message

Чтобы начать использовать go-message, установите его через `go get` из официального репозитория [GitHub go-message](https://github.com/emersion/go-message). Рекомендуемый подход — использовать модули Go: выполните `go get github.com/emersion/go-message` в каталоге вашего проекта. Для поддержки декодирования наборов символов включите `import _ "github.com/emersion/go-message/charset"`, чтобы активировать все стандартные кодировки. Библиотека лёгкая, не имеет зависимостей и легко интегрируется в существующие Go‑приложения.

Установите go-message через Go Modules

go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"

Потоковый разбор электронной почты

go-message предоставляет потоковый парсер, который обрабатывает электронные сообщения постепенно, не загружая весь контент в память. Это особенно полезно при работе с большими письмами или обработкой большого объёма почты. Парсер последовательно читает заголовки и части тела, позволяя разработчикам инспектировать или пересылать сообщения в реальном времени. Он поддерживает как сообщения, соответствующие RFC, так и некорректные, делая его пригодным для производственных почтовых серверов. Используя `io.Reader` из Go, библиотека естественно интегрируется с сетевыми и файловыми операциями ввода‑вывода.

Как разобрать сообщение электронной почты через потоковый 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 multipart

go-message полностью поддерживает разбор и генерацию MIME multipart сообщений в соответствии с RFC 2045 и RFC 2046. Разработчики могут перемещаться по сложным multipart структурам — включая вложенные части — с помощью интуитивных API. Библиотека автоматически декодирует кодировки передачи (например, base64, quoted-printable) и предоставляет доступ к отдельным частям через интерфейс `Part`. Это обеспечивает надёжную композицию писем и извлечение вложений, альтернатив HTML/текст, а также встроенных ресурсов. Его потоковая природа гарантирует эффективную обработку даже больших multipart сообщений с множеством частей.

Как извлечь части multipart из электронного письма?

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` разработчики получают доступ ко всем зарегистрированным наборам символов IANA через `golang.org/x/text/encoding`. Это обеспечивает точное отображение международного почтового контента, включая нелатинские скрипты и специальные символы, без необходимости ручного определения или преобразования кодировки.

Как декодировать заголовок, закодированный в наборе символов?

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‑подписи. Разработчики могут создавать конвейеры подписи писем, комбинируя go-message с библиотеками вроде `github.com/emersion/go-dkim`, гарантируя соответствие 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
}
 Русский