Skip to main content

​
Зачем нужен SMTP

Email-уведомления используются в Cabinet для:
  • Верификации email при регистрации
  • Сброса пароля
  • Уведомлений о платежах, подписках, автопродлении
  • Реферальных бонусов и партнёрских заявок
  • Заявок на вывод средств
Email работает только при CABINET_ENABLED=true. Без Cabinet настройка SMTP не требуется.

​
Варианты настройки

ВариантПлюсыМинусы
Внешний SMTP (Yandex, Gmail, Mailgun)Простая настройка, высокая доставляемостьЛимиты на отправку, зависимость от сервиса
Свой PostfixБез лимитов, полный контрольСложная настройка, нужен чистый IP

​
Проверка доступности почтовых портов

Многие хостеры блокируют исходящие почтовые порты. Проверьте до начала настройки.

​
Проверка порта 25 (SMTP)

# Проверка через telnet
telnet smtp.gmail.com 25

# Или через nc (netcat)
nc -zv smtp.gmail.com 25

# Через timeout (если telnet/nc нет)
timeout 5 bash -c 'echo > /dev/tcp/smtp.gmail.com/25' && echo "OK" || echo "BLOCKED"

​
Проверка порта 587 (Submission/STARTTLS)

nc -zv smtp.gmail.com 587
timeout 5 bash -c 'echo > /dev/tcp/smtp.gmail.com/587' && echo "OK" || echo "BLOCKED"

​
Проверка порта 465 (SMTPS/SSL)

nc -zv smtp.gmail.com 465
timeout 5 bash -c 'echo > /dev/tcp/smtp.gmail.com/465' && echo "OK" || echo "BLOCKED"

​
Интерпретация результатов

РезультатЗначение
Connection to ... succeeded!Порт открыт
Connection timed outПорт заблокирован хостером
Connection refusedСервер не слушает этот порт (нормально, если проверяете свой сервер)
Если порт 25 заблокирован — свой Postfix не сможет доставлять почту напрямую. Используйте relay через внешний SMTP (порт 587) или обратитесь к хостеру для разблокировки.

​
Проверка наличия обратной DNS-записи (PTR)

# Узнайте IP сервера
curl -4 ifconfig.me

# Проверьте PTR-запись
dig -x YOUR_SERVER_IP +short
Если PTR-запись пустая или не совпадает с вашим доменом — многие почтовые серверы будут отклонять письма. Настройте PTR через панель хостера.

​
Вариант 1: Внешний SMTP (рекомендуется)

​
Yandex 360

  1. Подключите домен к Yandex 360 для бизнеса
  2. Создайте почтовый ящик (например, noreply@yourdomain.com)
  3. Сгенерируйте пароль приложения: Yandex ID → Безопасность → Пароли приложений
SMTP_HOST=smtp.yandex.ru
SMTP_PORT=587
SMTP_USER=noreply@yourdomain.com
SMTP_PASSWORD=app_password_here
SMTP_FROM_EMAIL=noreply@yourdomain.com
SMTP_FROM_NAME=My VPN Service
SMTP_USE_TLS=true
Лимит Yandex 360: 500 писем в сутки на бесплатном тарифе.

​
Gmail

  1. Включите двухфакторную аутентификацию в Google-аккаунте
  2. Создайте пароль приложения: myaccount.google.com/apppasswords
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your_email@gmail.com
SMTP_PASSWORD=app_password_here
SMTP_FROM_EMAIL=your_email@gmail.com
SMTP_FROM_NAME=My VPN Service
SMTP_USE_TLS=true
Лимит Gmail: 500 писем в сутки для обычного аккаунта, 2000 для Google Workspace.

​
Mailgun / Brevo / Resend

Для массовых рассылок используйте транзакционные email-сервисы: 
# Пример для Mailgun
SMTP_HOST=smtp.mailgun.org
SMTP_PORT=587
SMTP_USER=postmaster@mg.yourdomain.com
SMTP_PASSWORD=mailgun_api_key
SMTP_FROM_EMAIL=noreply@yourdomain.com
SMTP_FROM_NAME=My VPN Service
SMTP_USE_TLS=true

​
Вариант 2: Свой Postfix

​
Требования

  • Чистый IP-адрес (не в спам-листах)
  • PTR-запись, совпадающая с доменом
  • Открытый порт 25 (исходящий)
  • Выделенный домен для почты

​
Шаг 1: Установка Postfix

# Debian/Ubuntu
sudo apt update
sudo apt install postfix mailutils -y
При установке выберите Internet Site и укажите ваш домен (например, mail.yourdomain.com).

​
Шаг 2: Настройка Postfix

sudo nano /etc/postfix/main.cf
Основные параметры: 
# Имя хоста (должно совпадать с PTR-записью)
myhostname = mail.yourdomain.com
mydomain = yourdomain.com
myorigin = $mydomain

# Принимать подключения только с localhost
inet_interfaces = loopback-only
inet_protocols = ipv4

# Домены для которых принимаем почту (только localhost)
mydestination = $myhostname, localhost.$mydomain, localhost

# Не ретранслировать чужую почту
mynetworks = 127.0.0.0/8
relay_domains =

# Лимиты
message_size_limit = 10240000
mailbox_size_limit = 0

# TLS для исходящей почты
smtp_tls_security_level = may
smtp_tls_loglevel = 1
smtp_tls_CAfile = /etc/ssl/certs/ca-certificates.crt

# Имя отправителя в HELO
smtp_helo_name = mail.yourdomain.com

# Заголовки
header_size_limit = 4096000
Перезапустите: 
sudo systemctl restart postfix
sudo systemctl enable postfix

​
Шаг 3: DNS-записи

Добавьте в DNS вашего домена:

​
MX-запись

yourdomain.com.  IN  MX  10  mail.yourdomain.com.

​
A-запись для почтового сервера

mail.yourdomain.com.  IN  A  YOUR_SERVER_IP

​
SPF-запись

SPF указывает, какие серверы имеют право отправлять почту от имени домена. 
yourdomain.com.  IN  TXT  "v=spf1 ip4:YOUR_SERVER_IP -all"
-all означает строгий режим: письма с других IP будут отклоняться.

​
Проверка SPF

dig yourdomain.com TXT +short
# Должно содержать: "v=spf1 ip4:YOUR_SERVER_IP -all"

​
Шаг 4: DKIM (подпись писем)

DKIM подписывает каждое письмо криптографическим ключом, подтверждая что оно отправлено вашим сервером. 
# Установка OpenDKIM
sudo apt install opendkim opendkim-tools -y
Создайте директории и ключи: 
sudo mkdir -p /etc/opendkim/keys/yourdomain.com
sudo opendkim-genkey -b 2048 -d yourdomain.com -D /etc/opendkim/keys/yourdomain.com -s mail -v
sudo chown -R opendkim:opendkim /etc/opendkim
Настройте OpenDKIM: 
sudo nano /etc/opendkim.conf

Syslog          yes
LogWhy          yes
UMask           007
Mode            sv
Canonicalization relaxed/simple
OversignHeaders From
Domain          yourdomain.com
Selector        mail
KeyFile         /etc/opendkim/keys/yourdomain.com/mail.private
Socket          inet:8891@localhost
PidFile         /run/opendkim/opendkim.pid
TrustAnchorFile /usr/share/dns/root.key
Подключите OpenDKIM к Postfix: 
sudo nano /etc/postfix/main.cf
Добавьте в конец: 
# OpenDKIM
milter_default_action = accept
milter_protocol = 6
smtpd_milters = inet:localhost:8891
non_smtpd_milters = inet:localhost:8891
Перезапустите сервисы: 
sudo systemctl restart opendkim
sudo systemctl restart postfix
sudo systemctl enable opendkim
Добавьте DKIM DNS-запись. Посмотрите публичный ключ: 
sudo cat /etc/opendkim/keys/yourdomain.com/mail.txt
Скопируйте содержимое и добавьте TXT-запись: 
mail._domainkey.yourdomain.com.  IN  TXT  "v=DKIM1; h=sha256; k=rsa; p=MIIBIjANBg..."

​
Проверка DKIM

dig mail._domainkey.yourdomain.com TXT +short

​
Шаг 5: DMARC

DMARC объединяет SPF и DKIM, указывая получателям что делать с неподтверждёнными письмами. 
_dmarc.yourdomain.com.  IN  TXT  "v=DMARC1; p=quarantine; rua=mailto:dmarc@yourdomain.com; pct=100"
ПараметрОписание
p=noneНе блокировать (мониторинг)
p=quarantineОтправлять в спам
p=rejectОтклонять
ruaEmail для отчётов
pctПроцент писем для проверки
Рекомендация: начните с p=none для мониторинга, затем переключите на p=quarantine.

​
Проверка DMARC

dig _dmarc.yourdomain.com TXT +short

​
Шаг 6: Настройка .env бота

SMTP_HOST=localhost
SMTP_PORT=25
SMTP_USER=
SMTP_PASSWORD=
SMTP_FROM_EMAIL=noreply@yourdomain.com
SMTP_FROM_NAME=My VPN Service
SMTP_USE_TLS=false
При использовании локального Postfix аутентификация не нужна (SMTP_USER и SMTP_PASSWORD оставьте пустыми). TLS отключён, т.к. подключение локальное.

​
Postfix в Docker

Если бот запущен в Docker, у него нет доступа к localhost хоста. Варианты: Вариант A: host network Добавьте в docker-compose.yml для сервиса бота: 
extra_hosts:
  - "host.docker.internal:host-gateway"
В .env: 
SMTP_HOST=host.docker.internal
Вариант B: Postfix в контейнере
docker-compose.postfix.yml
services:
  postfix:
    image: boky/postfix
    container_name: postfix
    restart: unless-stopped
    environment:
      ALLOWED_SENDER_DOMAINS: yourdomain.com
      HOSTNAME: mail.yourdomain.com
    volumes:
      # Если настроен DKIM
      - /etc/opendkim/keys:/etc/opendkim/keys:ro
    networks:
      - bot_network

networks:
  bot_network:
    external: true
    name: remnawave_bot_network
В .env: 
SMTP_HOST=postfix
SMTP_PORT=587
SMTP_USE_TLS=false

​
Тестирование

​
Отправка тестового письма через командную строку

# Через mailutils (если Postfix на хосте)
echo "Test body" | mail -s "Test Subject" -r noreply@yourdomain.com your_real_email@gmail.com

​
Отправка через SMTP напрямую

# Через swaks (Swiss Army Knife for SMTP)
sudo apt install swaks -y

# Тест локального Postfix
swaks --to your_real_email@gmail.com \
      --from noreply@yourdomain.com \
      --server localhost \
      --header "Subject: Test from Postfix"

# Тест внешнего SMTP (Yandex)
swaks --to your_real_email@gmail.com \
      --from noreply@yourdomain.com \
      --server smtp.yandex.ru:587 \
      --auth LOGIN \
      --auth-user noreply@yourdomain.com \
      --auth-password "app_password" \
      --tls

​
Проверка логов Postfix

# Последние записи
sudo tail -50 /var/log/mail.log

# Только ошибки
sudo grep -i "error\|reject\|bounce" /var/log/mail.log | tail -20

# Очередь писем
sudo mailq

​
Проверка через бота

После настройки SMTP перезапустите бота и проверьте:
  1. Откройте Cabinet
  2. Зарегистрируйтесь по email
  3. Проверьте что письмо верификации пришло
Если письмо не пришло — проверьте логи бота и логи Postfix.

​
Проверка доставляемости

​
Онлайн-сервисы

Отправьте тестовое письмо и проверьте оценку:
  • mail-tester.com — оценка от 0 до 10, проверяет SPF/DKIM/DMARC, контент, блеклисты
  • mxtoolbox.com — проверка DNS-записей, блеклистов, SMTP-сервера

​
Проверка IP в спам-листах

# Через mxtoolbox
# Откройте: https://mxtoolbox.com/blacklists.aspx
# Введите IP сервера

# Через командную строку (пример для Spamhaus)
dig +short YOUR_IP_REVERSED.zen.spamhaus.org
# Пустой ответ = не в списке
# Ответ 127.0.0.x = в списке
Чтобы получить reversed IP: 1.2.3.4 → 4.3.2.1.

​
Проверка DNS-записей

# Все записи разом
dig yourdomain.com MX +short
dig yourdomain.com TXT +short
dig mail._domainkey.yourdomain.com TXT +short
dig _dmarc.yourdomain.com TXT +short
dig -x YOUR_SERVER_IP +short

​
Чеклист

Перед запуском в продакшн убедитесь:
  • Порты 25/587 открыты (исходящие)
  • PTR-запись настроена и совпадает с myhostname
  • MX-запись указывает на почтовый сервер
  • SPF-запись добавлена (v=spf1 ip4:... -all)
  • DKIM настроен и DNS-запись добавлена
  • DMARC-запись добавлена (начните с p=none)
  • IP сервера нет в спам-листах
  • Тестовое письмо доставляется в inbox (не в спам)
  • CABINET_ENABLED=true в .env бота
  • SMTP_* переменные заполнены в .env бота
  • Письмо верификации из Cabinet приходит