
go-message
Open-Source-Go-Bibliothek für E-Mail & Internetnachrichtenformat
Parsen, Erzeugen & Verarbeiten von RFC 5322-, MIME- und Content-Disposition-Headern über die Streaming-Go-API.
Was ist go-message?
go-message ist eine leistungsstarke, streaming‑fähige Go‑Bibliothek, die zum Parsen und Erzeugen von E‑Mail‑Nachrichten entwickelt wurde und dem Internet Message Format (RFC 5322), MIME‑Erweiterungen (RFC 2045–2047) sowie Content‑Disposition‑Headern (RFC 2183) entspricht. Sie ermöglicht Go‑Entwicklern, E‑Mail‑Inhalte effizient zu verarbeiten, ohne gesamte Nachrichten in den Speicher zu laden, was sie ideal für skalierbare Mail‑Server und -Clients macht. Die Bibliothek unterstützt die automatische Dekodierung von Zeichensätzen und integriert sich nahtlos in die Standardbibliothek von Go.
Mit Blick auf Modularität und Erweiterbarkeit entwickelt, enthält go-message dedizierte Subpakete wie `mail` für die hoch‑levelige Mail‑Verarbeitung und `textproto` für die low‑level‑Protokoll‑Analyse. Sein DKIM‑freundliches Design gewährleistet die Kompatibilität mit modernen E‑Mail‑Authentifizierungs‑Workflows. Durch integrierte Streaming‑Funktionen und Zeichensatz‑Normalisierung vereinfacht go-message komplexe E‑Mail‑Verarbeitungsaufgaben wie das Parsen von Multipart‑Körpern, das Dekodieren kodierter Header und das Handhaben verschachtelter MIME‑Strukturen – und das alles bei gleichzeitig hoher Speicher‑Effizienz und Leistung.
Erste Schritte mit go-message
Um go-message zu verwenden, installieren Sie es über `go get` aus dem offiziellen [go-message GitHub](https://github.com/emersion/go-message) Repository. Der empfohlene Ansatz ist die Verwendung von Go‑Modulen: Führen Sie `go get github.com/emersion/go-message` in Ihrem Projektverzeichnis aus. Für die Unterstützung der Zeichensatzdekodierung fügen Sie `import _ "github.com/emersion/go-message/charset"` hinzu, um alle Standardkodierungen zu aktivieren. Die Bibliothek ist leichtgewichtig, ohne Abhängigkeiten und lässt sich nahtlos in bestehende Go‑Anwendungen integrieren.
Installiere go-message über Go-Module
go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"
Streaming-E-Mail-Parsing
go-message bietet einen Streaming‑Parser, der E‑Mail‑Nachrichten schrittweise verarbeitet, ohne den gesamten Inhalt in den Speicher zu laden. Dies ist besonders vorteilhaft beim Umgang mit großen E‑Mails oder bei der Verarbeitung hoher Mail‑Volumina. Der Parser liest Header und Body‑Teile nacheinander und ermöglicht Entwicklern, Nachrichten in Echtzeit zu inspizieren oder weiterzuleiten. Er unterstützt sowohl RFC‑konforme als auch fehlerhafte Nachrichten elegant und ist damit für Produktions‑Mail‑Server geeignet. Durch die Nutzung von Go’s `io.Reader` integriert sich die Bibliothek nahtlos in Netzwerk‑ und Datei‑I/O‑Operationen.
Wie analysiert man eine E-Mail-Nachricht über die Streaming-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-Verarbeitung
go-message unterstützt vollständig das Parsen und Erzeugen von MIME‑Multipart‑Nachrichten gemäß RFC 2045 und RFC 2046. Entwickler können komplexe Multipart‑Strukturen – einschließlich verschachtelter Teile – mit intuitiven APIs navigieren. Die Bibliothek dekodiert automatisch Transfer‑Encodings (z. B. base64, quoted‑printable) und bietet Zugriff auf einzelne Teile über die `Part`‑Schnittstelle. Dies ermöglicht eine robuste E‑Mail‑Erstellung sowie das Extrahieren von Anhängen, HTML/Text‑Alternativen und eingebetteten Ressourcen. Durch seine Streaming‑Natur wird selbst bei großen Multipart‑Nachrichten mit vielen Teilen eine effiziente Verarbeitung gewährleistet.
Wie extrahiere ich Multipart-Teile aus einer E‑Mail?
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
}
Zeichensatz & Kodierungsunterstützung
go-message beinhaltet eine robuste automatische Zeichensatz- und Kodierungsbehandlung für E-Mail-Header und -Body-Inhalte. Es unterstützt das Dekodieren von RFC‑2047‑kodierten Headern (z. B. `=?utf-8?B?...?=`) und Body-Text in verschiedenen Zeichensätzen (UTF‑8, ISO‑8859 usw.). Durch das Importieren des optionalen Pakets `github.com/emersion/go-message/charset` erhalten Entwickler Zugriff auf alle registrierten IANA‑Zeichensätze über `golang.org/x/text/encoding`. Dies gewährleistet eine genaue Darstellung internationaler E‑Mail‑Inhalte, einschließlich nicht‑lateinischer Schriften und Sonderzeichen, ohne manuelle Zeichensatz‑Erkennung oder -Konvertierung.
Wie dekodiere ich einen charset‑kodierten Header?
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-freundliche Nachrichtenunterzeichnung
go-message ist so konzipiert, dass es DKIM‑freundlich ist und eine nahtlose Integration in kryptografische Signatur‑ und Verifizierungs‑Workflows ermöglicht. Sein Streaming‑Parser bewahrt die Integrität der Nachrichtenstruktur, sodass Unterzeichner nur den kanonisierten Body und ausgewählte Header signieren können, ohne eine erneute Kodierung. Die Bibliothek vermeidet unnötige Transformationen (z. B. Normalisierung von Zeilenenden), die DKIM‑Signaturen beschädigen könnten. Entwickler können E‑Mail‑Signatur‑Pipelines erstellen, indem sie go-message mit Bibliotheken wie `github.com/emersion/go-dkim` kombinieren, und damit die Konformität mit RFC 6376 für domänenbasierte Nachrichtenauthentifizierung sicherstellen.
Wie bereite ich eine Nachricht für das DKIM‑Signing vor?
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
}
