Перейти к содержанию

Beego

Инструкция для приложений на Beego 2.x (Go 1.22+). Mailexam подключается как SMTP через стандартную библиотеку net/smtp с STARTTLS на порту 587.

Что понадобится

  • Аккаунт Mailexam и проект с SMTP-учётными данными.
  • Go 1.22+.

Скопируйте из приветственного письма (или кабинета) для вашего проекта:

  • ВАШ_ЛОГИН — SMTP-логин (например, xxxxx);
  • ВАШ_ПАРОЛЬ — SMTP-пароль (уникальная пара к логину);
  • хост — ВАШ_ЛОГИН.mailexam.ru (совпадает с логином).

1. Зависимости

go mod init example.com/mailexam-beego
go get github.com/beego/beego/v2@v2.3.4
go get github.com/joho/godotenv@v1.5.1

Файл go.mod (версии подтянутся после go get):

module example.com/mailexam-beego

go 1.22

require (
    github.com/beego/beego/v2 v2.3.4
    github.com/joho/godotenv v1.5.1
)

2. Переменные окружения

Файл .env в корне проекта (не коммитьте пароли в git):

MAILEXAM_LOGIN=ВАШ_ЛОГИН
MAILEXAM_PASSWORD=ВАШ_ПАРОЛЬ
MAILEXAM_PORT=587
MAIL_FROM=noreply@example.test

Хост SMTP: ВАШ_ЛОГИН.mailexam.ru.

Адрес отправителя

MAIL_FROM может быть любым тестовым адресом — письмо попадёт в Mailexam, а не реальному получателю.

Альтернативные порты

MAILEXAM_PORT=587

Отправка через client.StartTLS (см. mail.go).

MAILEXAM_PORT=2525

Тот же путь, что для 587.

MAILEXAM_PORT=25

Используется smtp.SendMail без STARTTLS.

3. Модуль отправки почты

Тот же подход, что в Gin: mail.go в корне проекта.

// mail.go
package main

import (
    "crypto/tls"
    "fmt"
    "net"
    "net/smtp"
    "os"
    "strconv"
)

func sendTest(to, subject, body string) error {
    login := os.Getenv("MAILEXAM_LOGIN")
    password := os.Getenv("MAILEXAM_PASSWORD")
    if login == "" || password == "" {
        return fmt.Errorf("MAILEXAM_LOGIN and MAILEXAM_PASSWORD must be set")
    }

    port, _ := strconv.Atoi(os.Getenv("MAILEXAM_PORT"))
    if port == 0 {
        port = 587
    }

    from := os.Getenv("MAIL_FROM")
    if from == "" {
        from = "noreply@example.test"
    }
    if to == "" {
        to = "user@example.test"
    }
    if subject == "" {
        subject = "Beego + Mailexam"
    }
    if body == "" {
        body = "Тест Mailexam из Beego"
    }

    host := login + ".mailexam.ru"
    addr := fmt.Sprintf("%s:%d", host, port)
    auth := smtp.PlainAuth("", login, password, host)

    msg := []byte(fmt.Sprintf(
        "From: %s\r\nTo: %s\r\nSubject: %s\r\nMIME-Version: 1.0\r\nContent-Type: text/plain; charset=UTF-8\r\n\r\n%s",
        from, to, subject, body,
    ))

    if port == 587 || port == 2525 {
        return sendWithSTARTTLS(addr, host, auth, from, []string{to}, msg)
    }

    return smtp.SendMail(addr, auth, from, []string{to}, msg)
}

func sendWithSTARTTLS(addr, host string, auth smtp.Auth, from string, to []string, msg []byte) error {
    conn, err := net.Dial("tcp", addr)
    if err != nil {
        return err
    }
    defer conn.Close()

    client, err := smtp.NewClient(conn, host)
    if err != nil {
        return err
    }
    defer client.Close()

    if ok, _ := client.Extension("STARTTLS"); ok {
        if err = client.StartTLS(&tls.Config{ServerName: host}); err != nil {
            return err
        }
    }

    if auth != nil {
        if err = client.Auth(auth); err != nil {
            return err
        }
    }

    if err = client.Mail(from); err != nil {
        return err
    }
    for _, rcpt := range to {
        if err = client.Rcpt(rcpt); err != nil {
            return err
        }
    }

    w, err := client.Data()
    if err != nil {
        return err
    }
    if _, err = w.Write(msg); err != nil {
        return err
    }
    if err = w.Close(); err != nil {
        return err
    }

    return client.Quit()
}

4. Контроллер и маршрут

// main.go
package main

import (
    "encoding/json"

    "github.com/joho/godotenv"
    beego "github.com/beego/beego/v2/server/web"
)

type sendRequest struct {
    To      string `json:"to"`
    Subject string `json:"subject"`
    Body    string `json:"body"`
}

type MailController struct {
    beego.Controller
}

func (c *MailController) PostTest() {
    var req sendRequest
    if len(c.Ctx.Input.RequestBody) > 0 {
        _ = json.Unmarshal(c.Ctx.Input.RequestBody, &req)
    }

    if err := sendTest(req.To, req.Subject, req.Body); err != nil {
        c.Ctx.Output.SetStatus(500)
        c.Data["json"] = map[string]string{"error": err.Error()}
        c.ServeJSON()
        return
    }

    c.Data["json"] = map[string]string{"status": "ok"}
    c.ServeJSON()
}

func main() {
    _ = godotenv.Load()

    beego.BConfig.Listen.HTTPAddr = "127.0.0.1"
    beego.BConfig.Listen.HTTPPort = 8080

    beego.Router("/mail/test", &MailController{}, "post:PostTest")

    beego.Run()
}

Запуск и проверка:

go run .

curl -X POST http://127.0.0.1:8080/mail/test \
  -H 'Content-Type: application/json' \
  -d '{"to":"user@example.test","subject":"Проверка","body":"Привет"}'

Письмо появится в кабинете Mailexam → ваш проект → входящие.

Структура bee new (опционально)

После bee new вынесите MailController в controllers/mail.go, маршрут — в routers/router.go:

beego.Router("/mail/test", &controllers.MailController{}, "post:PostTest")

5. Локальная разработка и CI

Среда Рекомендация
local .env + godotenv.Load() в main
CI секреты MAILEXAM_LOGIN, MAILEXAM_PASSWORD в GitLab CI/CD Variables

Пример для .gitlab-ci.yml:

variables:
  MAILEXAM_LOGIN: $MAILEXAM_LOGIN
  MAILEXAM_PASSWORD: $MAILEXAM_PASSWORD
  MAILEXAM_PORT: "587"
  MAIL_FROM: "noreply@example.test"

После интеграционного теста проверьте доставку через API Mailexam.

6. Типичные проблемы

Ошибка TLS или authentication failed

  • host в коде — {логин}.mailexam.ru, в PlainAuth — тот же логин.
  • Логин и пароль — пара из письма одного проекта.

Порт 587

  • Нужен STARTTLS (sendWithSTARTTLS), а не прямой smtp.SendMail без TLS.

Пустое тело POST

  • Beego читает тело в c.Ctx.Input.RequestBody; для JSON передайте заголовок Content-Type: application/json.

Письмо не в кабинете

  • Смотрите входящие того же проекта Mailexam.
  • Включите beego.BConfig.RunMode = "dev" и смотрите логи при ответе 500.

См. также