Подключение к SMTP через релей
Webim Server умеет авторизоваться на SMTP-сервере только механизмами login, plain и cram-md5. Если у целевого сервера нет ни одного из этих механизмов (типичный пример — Microsoft Exchange Server с NTLM или GSSAPI), прямое подключение из Webim невозможно. Подробнее о поддерживаемых типах аутентификации см. в статье Интеграция с почтовыми сервисами.
В такой ситуации между Webim Server и целевым SMTP ставят релей/relay (шлюз):
Webim Server → SMTP-релей (Postfix) → целевой SMTP-сервер
-
Webim Server отправляет письма на релей по SMTP из доверенной сети (в типовой hosted-установке — из Docker-подсети). Релей принимает эту почту способом, совместимым с Webim.
-
Релей уже от своего имени доставляет письма на целевой сервер: с логином и паролем, которые тот принимает, либо как доверенный узел по IP — в зависимости от политики почтового сервера.
Релей не входит в поставку Webim. Ниже приведён рабочий пример на базе Postfix для hosted-инсталляции на Debian, когда Webim Server запущен в Docker. Тот же принцип применим и к другому MTA: задача релея — принять почту способом, совместимым с Webim, и передать её на целевой SMTP.
N.B.
Релей помогает, когда не совпадают механизмы SMTP AUTH. Он не заменяет двухфакторную аутентификацию и OAuth2 (Exchange Online). Если целевой сервер принимает от релея только OAuth2, этой схемы недостаточно — нужна учётная запись или коннектор, которые допускают парольную аутентификацию или релей по IP.
Когда нужен релей
Настраивайте релей, если выполняется хотя бы одно из условий:
-
целевой SMTP в ответе EHLO предлагает только механизмы, которых нет у Webim (например,
NTLMилиGSSAPI); -
при прямой отправке в логах Webim появляется
SMTP AUTH extension not supported by server, а указатьntlmвsmtp_auth_modeнельзя: этот тип Webim Server не поддерживает; -
корпоративный Exchange Server разрешает исходящую почту только с выделенных внутренних узлов (Receive Connector), а не напрямую из приложения.
Если целевой сервер уже поддерживает login, plain или cram-md5, релей не нужен: задайте параметры SMTP в main.ini по статье Интеграция с почтовыми сервисами.
Что понадобится
В командах ниже замените плейсхолдеры на значения Вашей инфраструктуры.
| Плейсхолдер | Пример | Назначение |
|---|---|---|
<SMTP_HOST> |
smtp.mail.example.local |
Имя или IP целевого SMTP-сервера |
<SMTP_PORT> |
25 |
Порт целевого SMTP (25, 587 или 465) |
<SMTP_USER> |
webim@mail.example.local |
Учётная запись на целевом SMTP (если сервер требует AUTH) |
<SMTP_PASSWORD> |
пароль этой учётной записи | Пароль на целевом SMTP |
<RELAY_LISTEN_IP> |
172.16.0.1 |
IP, на котором Postfix принимает почту от Webim |
<RELAY_NETWORK> |
172.16.0.0/28 |
Подсеть, из которой Webim шлёт почту на релей |
В типовой Docker-сборке Webim подсеть задаётся параметром docker_sub_net (по умолчанию 172.16.0.0/28, шлюз — 172.16.0.1). Если у Вас другая подсеть, подставьте её шлюз в <RELAY_LISTEN_IP> и CIDR в <RELAY_NETWORK>. См. главные файлы настроек.
Квадратные скобки вокруг имени хоста в Postfix отключают MX-запрос: почта идёт именно на указанный хост, а не на MX-запись его домена.
Установка Postfix
Команды рассчитаны на Debian 12.5 — ОС из требований к программному обеспечению. Пакет libsasl2-modules нужен, чтобы Postfix как клиент мог авторизоваться на целевом SMTP.
sudo apt-get update
sudo apt-get install -y postfix libsasl2-modules
При интерактивной установке выберите тип Satellite system или Internet with smarthost. Последующие команды postconf перезапишут эти ответы, поэтому достаточно любого из двух вариантов.
Postfix устанавливается на хост, где работают контейнеры Webim, а не внутрь контейнера: так релей слушает IP шлюза Docker-сети и доступен сервисам Webim.
Учётные данные для целевого SMTP
Файл /etc/postfix/sasl_passwd хранит логин и пароль, с помощью которых Postfix авторизуется на целевом сервере (это не учётная запись Webim).
-
Создайте файл
/etc/postfix/sasl_passwdс одной строкой:[<SMTP_HOST>]:<SMTP_PORT> <SMTP_USER>:<SMTP_PASSWORD>Пример:
[smtp.mail.example.local]:25 webim@mail.example.local:YOUR_SMTP_PASSWORD -
Защитите файл и постройте хеш-карту:
sudo chmod 600 /etc/postfix/sasl_passwd sudo postmap hash:/etc/postfix/sasl_passwd
N.B.
Если Exchange Server принимает письма с IP-адреса релея без аутентификации (отдельный Receive Connector), файл sasl_passwd и параметры smtp_sasl_* ниже не нужны. Пропустите этот шаг и не включайте smtp_sasl_auth_enable.
Карта маршрутизации
Карта транспорта отправляет всю исходящую почту на целевой SMTP, а не пытается доставлять её напрямую по MX.
-
Создайте файл
/etc/postfix/transport:* smtp:[<SMTP_HOST>]:<SMTP_PORT>Пример:
* smtp:[smtp.mail.example.local]:25 -
Постройте хеш-карту:
sudo postmap hash:/etc/postfix/transport
Настройка Postfix
Выполните команды на хосте с Postfix. Они задают релей, а не полноценный почтовый сервер организации: локальная доставка отключена, слушать интернет Postfix не должен. Подставьте свои <SMTP_HOST>, <SMTP_PORT>, <RELAY_NETWORK> и <RELAY_LISTEN_IP>. Значение myhostname замените на уникальное имя этого хоста.
Пример для типовой Docker-сети Webim и SMTP на порту 25:
sudo postconf -e "myhostname = smtp-relay.example.local"
sudo postconf -e "mydestination ="
sudo postconf -e "maillog_file = /var/log/mail.log"
sudo postconf -e "mynetworks = 127.0.0.0/8, 172.16.0.0/28"
sudo postconf -e "inet_interfaces = 127.0.0.1, 172.16.0.1"
sudo postconf -e "smtpd_relay_restrictions = permit_mynetworks, permit_sasl_authenticated, defer_unauth_destination"
sudo postconf -e "smtpd_sender_restrictions ="
sudo postconf -e "smtpd_discard_ehlo_keywords ="
sudo postconf -e "relayhost = [smtp.mail.example.local]:25"
sudo postconf -e "transport_maps = hash:/etc/postfix/transport"
sudo postconf -e "smtp_sasl_auth_enable = yes"
sudo postconf -e "smtp_sasl_security_options = noanonymous"
sudo postconf -e "smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd"
Смысл ключевых параметров:
-
inet_interfaces— Postfix принимает соединения только на localhost и на шлюзе Docker, а не на публичном IP. -
mynetworks— из этой подсети релей принимает почту без SMTP AUTH. Сюда должна входить подсеть контейнеров Webim. Без этой строки контейнеры, как правило, получат отказ в ретрансляции (Relay access denied). -
mydestinationпустой — хост не считает себя конечным получателем писем и только пересылает их дальше. -
smtp_sasl_*— аутентификация Postfix как клиента на целевом SMTP. Префиксsmtpd_относится к входящим соединениям (от Webim), префиксsmtp_— к исходящим (на целевой сервер). -
smtpd_discard_ehlo_keywordsпустой — Postfix не скрывает расширения EHLO от клиентов. Не путайте с одноимённым параметром безd(smtp_discard_ehlo_keywords): тот влияет на диалог с целевым сервером. -
relayhostиtransport_mapsзадают один и тот же smarthost. Карта транспорта имеет приоритет;relayhostостаётся запасным маршрутом.
Важно
Не указывайте inet_interfaces = all на сервере с публичным IP-адресом и не расширяйте mynetworks до 0.0.0.0/0. Иначе Postfix станет открытым релеем.
Если целевой сервер требует STARTTLS (часто порт 587), дополнительно задайте:
sudo postconf -e "smtp_tls_security_level = encrypt"
sudo postconf -e "smtp_tls_CAfile = /etc/ssl/certs/ca-certificates.crt"
Для SMTPS на порту 465:
sudo postconf -e "smtp_tls_security_level = encrypt"
sudo postconf -e "smtp_tls_wrappermode = yes"
Для Microsoft Exchange с NTLM Postfix использует этот механизм через libsasl2-modules, если сервер предлагает его в EHLO. Имя пользователя часто указывают в виде DOMAIN\user или user@mail.example.local — уточните формат у администраторов почты.
Запуск Postfix
После изменения inet_interfaces нужен полный перезапуск, а не reload. К этому моменту Docker-мост с адресом <RELAY_LISTEN_IP> уже должен существовать, иначе Postfix не сможет занять сокет.
sudo systemctl restart postfix
sudo systemctl enable postfix
Проверьте, что служба слушает нужный адрес:
ss -lntp | grep ':25'
В выводе должен быть <RELAY_LISTEN_IP>:25 (для типовой сети — 172.16.0.1:25).
Настройка Webim Server
Webim Server должен отправлять почту на релей, а не на целевой SMTP напрямую.
В main.ini для hosted-режима:
hostedmode_smtp_server = 172.16.0.1
hostedmode_smtp_port = 25
hostedmode_smtp_encryption = ""
hostedmode_smtp_auth_mode = ""
hostedmode_smtp_username = ""
hostedmode_smtp_password = ""
hostedmode_smtp_from_addr = noreply@mail.example.local
В этой схеме контейнеры входят в mynetworks, поэтому Postfix не требует AUTH от Webim. Логин и пароль целевого SMTP живут только в /etc/postfix/sasl_passwd. Адрес в hostedmode_smtp_from_addr должен быть разрешён политикой целевого сервера, иначе он отвергнет письмо после приёма релеем.
После изменения main.ini перезапустите сервисы Webim.
Для канала электронной почты через IMAP/SMTP в форме канала укажите тот же хост и порт релея (например, 172.16.0.1 и 25), без шифрования. Поля логина и пароля SMTP в канале оставьте пустыми, если релей принимает почту по mynetworks.
N.B.
Если Webim Server отказывается подключаться к релею без AUTH, включите на Postfix SASL для входящих соединений (smtpd_sasl_auth_enable) с механизмами LOGIN/PLAIN и укажите эти учётные данные в hostedmode_smtp_*. Это отдельная настройка smtpd, её не следует путать с smtp_sasl_* для исходящей авторизации на целевом SMTP.
Проверка
-
С хоста релея отправьте тестовое письмо:
printf "Subject: Webim SMTP relay test\n\nRelay test\n" | sudo sendmail -v -f noreply@mail.example.local recipient@example.local -
Смотрите журнал:
sudo tail -f /var/log/mail.logУспешная цепочка выглядит так: письмо принято от
127.0.0.1или из<RELAY_NETWORK>, затем ушло на[<SMTP_HOST>]:<SMTP_PORT>со статусомsent. -
Повторите проверку из сценария Webim (уведомление оператору, ответ в почтовом канале).
Если что-то пошло не так
| Симптом | Что проверить |
|---|---|
Relay access denied / 454 4.7.1 |
IP контейнера Webim не входит в mynetworks. Сверьте docker_sub_net и <RELAY_NETWORK>. |
Connection refused из Webim |
Postfix не слушает <RELAY_LISTEN_IP> или Docker-мост ещё не создан. Смотрите ss -lntp и inet_interfaces. |
SASL authentication failed в сторону целевого SMTP |
Неверные <SMTP_USER>/<SMTP_PASSWORD>, несовпадение порта в sasl_passwd и relayhost, либо целевой сервер не принимает выбранный механизм. После правки файла снова выполните postmap и перезапустите Postfix. |
SMTP AUTH extension not supported при подключении Webim к релею |
Webim пытается выполнить AUTH, а smtpd Postfix его не предлагает. Либо оставьте hostedmode_smtp_auth_mode пустым, либо включите SASL на smtpd. |
| Письмо принято релеем, но отвергнуто Exchange | Адрес отправителя, TLS или права Receive Connector. Смотрите ответ целевого сервера в /var/log/mail.log. |
Не публикуйте содержимое /etc/postfix/sasl_passwd в тикетах и переписке: после postmap достаточно журнала Postfix и параметров postconf -n.