go-message

 
 

کتابخانه منبع باز Go برای ایمیل و فرمت پیام اینترنتی

تجزیه، تولید و مدیریت هدرهای RFC 5322، MIME و Content-Disposition از طریق API استریمینگ Go.

go-message چیست؟

go-message یک کتابخانهٔ Go با عملکرد بالا و پخش‌پذیر است که برای تجزیه و تولید پیام‌های ایمیل مطابق با فرمت پیام اینترنت (RFC 5322)، افزونه‌های MIME (RFC 2045–2047) و هدرهای Content‑Disposition (RFC 2183) طراحی شده است. این کتابخانه به توسعه‌دهندگان Go امکان می‌دهد محتویات ایمیل را به‌صورت کارآمد پردازش کنند بدون اینکه کل پیام‌ها را در حافظه بارگذاری کنند، که آن را برای سرورهای ایمیل و کلاینت‌های مقیاس‌پذیر ایده‌آل می‌سازد. این کتابخانه از رمزگشایی خودکار charset پشتیبانی می‌کند و به‌صورت یکپارچه با کتابخانهٔ استاندارد Go ادغام می‌شود.

با در نظر گرفتن ماژولار بودن و قابلیت گسترش، go-message شامل زیرپکیج‌های اختصاصی مانند `mail` برای مدیریت سطح بالای ایمیل و `textproto` برای تجزیهٔ پروتکل سطح پایین است. طراحی سازگار با DKIM این کتابخانه اطمینان می‌دهد که با جریان‌های کاری احراز هویت ایمیل مدرن سازگار باشد. با قابلیت‌های پخش داخلی و نرمال‌سازی charset، 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` را اجرا کنید. برای پشتیبانی از رمزگشایی charset، `import _ "github.com/emersion/go-message/charset"` را اضافه کنید تا تمام رمزگذاری‌های استاندارد فعال شوند. این کتابخانه سبک، بدون وابستگی و به‌راحتی در برنامه‌های Go موجود یکپارچه می‌شود.

نصب go-message از طریق ماژول‌های Go

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، کتابخانه به‌طور طبیعی با عملیات 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 به‌طور کامل از تجزیه و تولید پیام‌های چندبخشی MIME طبق RFC 2045 و RFC 2046 پشتیبانی می‌کند. توسعه‌دهندگان می‌توانند ساختارهای پیچیده چندبخشی — از جمله بخش‌های تو در تو — را با استفاده از APIهای بصری مرور کنند. کتابخانه به‌صورت خودکار رمزگذاری‌های انتقالی (مانند base64، quoted-printable) را رمزگشایی می‌کند و دسترسی به بخش‌های منفرد را از طریق رابط `Part` فراهم می‌آورد. این امکان ترکیب ایمیل قوی و استخراج پیوست‌ها، گزینه‌های HTML/text و منابع جاسازی‌شده را می‌دهد. طبیعت جریان‌دار آن تضمین می‌کند که حتی برای پیام‌های چندبخشی بزرگ با تعداد زیاد بخش‌ها نیز به‌صورت کارآمد پردازش شود.

چگونه بخش‌های چندقسمتی را از یک ایمیل استخراج کنیم؟

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 شامل مدیریت خودکار و قوی charset و رمزگذاری برای هدرها و محتوای بدنه ایمیل است. این کتابخانه از رمزگشایی هدرهای رمزگذاری‌شده با RFC 2047 (مثلاً `=?utf-8?B?...?=`) و متن بدنه در charsetهای مختلف (UTF-8، ISO-8859 و غیره) پشتیبانی می‌کند. با وارد کردن بسته اختیاری `github.com/emersion/go-message/charset`، توسعه‌دهندگان به تمام charsetهای ثبت‌شده توسط IANA از طریق `golang.org/x/text/encoding` دسترسی پیدا می‌کنند. این امر رندر دقیق محتوای ایمیل‌های بین‌المللی، از جمله اسکریپت‌های غیرلاتین و نمادهای خاص، را بدون نیاز به تشخیص یا تبدیل دستی charset فراهم می‌کند.

چگونه یک هدر رمزگذاری‌شده با charset را رمزگشایی کنیم؟

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
}
 فارسی