1. 製品
  2.   Eメール
  3.   GO
  4.   go-message

go-message

 
 

メールとインターネットメッセージフォーマット向けのオープンソース Go ライブラリ

ストリーミング Go API を通じて RFC 5322、MIME、Content-Disposition ヘッダーを解析、生成、処理します。

go-message とは何ですか?

go-message は、高性能でストリーミング対応の Go ライブラリで、Internet Message Format (RFC 5322)、MIME 拡張 (RFC 2045–2047)、および Content-Disposition ヘッダー (RFC 2183) に準拠したメールメッセージの解析と生成を目的としています。メモリに全メッセージを読み込むことなくメールコンテンツを効率的に処理できるため、スケーラブルなメールサーバーやクライアントに最適です。このライブラリは自動文字セットデコードをサポートし、Go の標準ライブラリとシームレスに統合されます。

モジュラリティと拡張性を念頭に設計された go-message には、ハイレベルなメール処理のための `mail` や、低レベルのプロトコル解析のための `textproto` といった専用サブパッケージが含まれています。その DKIM フレンドリーな設計により、最新のメール認証ワークフローとの互換性が確保されています。組み込みのストリーミング機能と文字セット正規化により、go-message はマルチパートボディの解析、エンコードされたヘッダーのデコード、入れ子になった MIME 構造の処理など、複雑なメール処理タスクをシンプルにします――メモリ効率とパフォーマンスを維持しながら。

Previous Next

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 Modules を使用して 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 を使用して、ネストされたパーツを含む複雑なマルチパート構造をナビゲートできます。ライブラリは転送エンコーディング(例: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
}
 日本