1. Produkter
  2.   E-mail
  3.   GO
  4.   go-message

go-message

 
 

Open Source Go-bibliotek til e-mail & Internet Message Format

Parse, generer & håndter RFC 5322, MIME og Content-Disposition-headers via Streaming Go API.

Hvad er go-message?

go-message er et højtydende, streaming‑Go‑bibliotek designet til at parse og generere e‑mail‑beskeder, der overholder Internet Message Format (RFC 5322), MIME‑udvidelser (RFC 2045–2047) og Content‑Disposition‑headers (RFC 2183). Det gør det muligt for Go‑udviklere at behandle e‑mail‑indhold effektivt uden at indlæse hele beskeder i hukommelsen, hvilket gør det ideelt til skalerbare mail‑servere og -klienter. Biblioteket understøtter automatisk tegnsætkodning og integreres problemfrit med Go's standardbibliotek.

Bygget med modularitet og udvidelsesmuligheder for øje, indeholder go-message dedikerede underpakker som `mail` til høj‑niveau mail‑håndtering og `textproto` til lav‑niveau protokol‑parsing. Dens DKIM‑venlige design sikrer kompatibilitet med moderne e‑mail‑autentificerings‑arbejdsgange. Med indbyggede streaming‑funktioner og tegnsætnormalisering forenkler go-message komplekse e‑mail‑behandlingsopgaver såsom parsing af multipart‑kroppe, dekodning af kodede headers og håndtering af indlejrede MIME‑strukturer — alt sammen mens hukommelses‑effektivitet og ydeevne opretholdes.

Previous Next

Kom i gang med go-message

For at begynde at bruge go-message, installer det via `go get` fra det officielle [go-message GitHub](https://github.com/emersion/go-message) repository. Den anbefalede tilgang er at bruge Go-moduler: kør `go get github.com/emersion/go-message` i din projektmappe. For understøttelse af tegnsæt-dekodning, inkluder `import _ "github.com/emersion/go-message/charset"` for at aktivere alle standardkodninger. Biblioteket er letvægts, uden afhængigheder, og integreres problemfrit i eksisterende Go-applikationer.

Installer go-message via Go-moduler

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 leverer en streaming-parser, der behandler e‑mailbeskeder inkrementelt uden at indlæse hele indholdet i hukommelsen. Dette er især fordelagtigt ved håndtering af store e‑mails eller højvolumen postbehandling. Parseren læser headers og body‑dele sekventielt, så udviklere kan inspicere eller videresende beskeder i realtid. Den understøtter både RFC‑kompatible og fejlbehæftede beskeder på en elegant måde, hvilket gør den egnet til produktions‑mailservere. Ved at udnytte Go’s `io.Reader` integreres biblioteket naturligt med netværks‑ og fil‑I/O‑operationer.

Hvordan parser man en e-mailbesked via 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
}

Håndtering af MIME-multipart

go-message understøtter fuldt ud parsing og generering af MIME‑multipart‑beskeder som defineret i RFC 2045 og RFC 2046. Udviklere kan navigere i komplekse multipart‑strukturer—inklusive indlejrede dele—ved hjælp af intuitive API’er. Biblioteket dekoder automatisk overførselskodninger (f.eks. base64, quoted‑printable) og giver adgang til individuelle dele via `Part`‑interfacet. Dette muliggør robust e‑mail‑komposition og udtræk af vedhæftede filer, HTML/tekst‑alternativer og indlejrede ressourcer. Dets streaming‑karakter sikrer effektiv håndtering selv for store multipart‑beskeder med mange dele.

Hvordan udtrækker multipart‑dele fra en 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
}

Understøttelse af tegnsæt og kodning

go-message inkluderer robust automatisk håndtering af tegnsæt og kodning for e-mail‑headers og brødtekst. Det understøtter dekodning af RFC‑2047‑kodede headers (f.eks. `=?utf-8?B?...?=`) og brødtekst i forskellige tegnsæt (UTF-8, ISO-8859 osv.). Ved at importere den valgfrie `github.com/emersion/go-message/charset`‑pakke får udviklere adgang til alle registrerede IANA‑tegnsæt via `golang.org/x/text/encoding`. Dette sikrer nøjagtig gengivelse af international e‑mail‑indhold, inklusive ikke‑latinske skriftsystemer og specialtegn, uden manuel tegnsætdetektion eller konvertering.

Hvordan dekoder man et tegnsæt‑kodet 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-venlig beskedsignering

go-message er designet til at være DKIM‑venlig, hvilket muliggør problemfri integration med kryptografiske signerings‑ og verifikations‑arbejdsgange. Dens streaming‑parser bevarer beskedens strukturelle integritet, så underskrivere kan signere kun den kanoniserede brødtekst og udvalgte headers uden gen‑kodning. Biblioteket undgår unødvendige transformationer (f.eks. normalisering af linjeafslutninger), som kunne ødelægge DKIM‑signaturer. Udviklere kan bygge e‑mail‑signerings‑pipelines ved at kombinere go-message med biblioteker som `github.com/emersion/go-dkim`, hvilket sikrer overholdelse af RFC 6376 for domænebaseret beskedautentifikation.

Hvordan forbereder man en besked til DKIM‑signering?

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
}
 Dansk