# Подключение к SMTP через релей

**Webim Server** умеет авторизоваться на SMTP-сервере только механизмами `login`, `plain` и `cram-md5`. Если у целевого сервера нет ни одного из этих механизмов (типичный пример — Microsoft Exchange Server с NTLM или GSSAPI), прямое подключение из **Webim** невозможно. Подробнее о поддерживаемых типах аутентификации см. в статье [Интеграция с почтовыми сервисами](https://webim.ru/kb/devops/smtp-integration.html).

В такой ситуации между **Webim Server** и целевым SMTP ставят **релей/relay** (шлюз):

```
Webim Server  →  SMTP-релей (Postfix)  →  целевой SMTP-сервер
```

  * **Webim Server** отправляет письма на релей по SMTP из доверенной сети (в типовой hosted-установке — из Docker-подсети). Релей принимает эту почту способом, совместимым с **Webim**.

  * Релей уже от своего имени доставляет письма на целевой сервер: с логином и паролем, которые тот принимает, либо как доверенный узел по IP — в зависимости от политики почтового сервера.

Релей **не входит** в поставку **Webim**. Ниже приведён рабочий пример на базе [Postfix](https://www.postfix.org/) для hosted-инсталляции на Debian, когда **Webim Server** запущен в Docker. Тот же принцип применим и к другому MTA: задача релея — принять почту способом, совместимым с **Webim**, и передать её на целевой SMTP.

!!! Note "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`](https://webim.ru/kb/devops/main-ini-configuration.html) по статье [Интеграция с почтовыми сервисами](https://webim.ru/kb/devops/smtp-integration.html).

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

В командах ниже замените плейсхолдеры на значения Вашей инфраструктуры.

| Плейсхолдер | Пример                     | Назначение |
| --- |----------------------------| --- |
| `<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>`. См. [главные файлы настроек](https://webim.ru/kb/devops/main-ini-configuration.html).

Квадратные скобки вокруг имени хоста в Postfix отключают MX-запрос: почта идёт именно на указанный хост, а не на MX-запись его домена.

## Установка Postfix

Команды рассчитаны на Debian 12.5 — ОС из [требований к программному обеспечению](https://webim.ru/kb/devops/sys-reqs-for-server/sys-reqs-server-sw.html). Пакет `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**).

  1. Создайте файл `/etc/postfix/sasl_passwd` с одной строкой:

    ```
    [<SMTP_HOST>]:<SMTP_PORT>    <SMTP_USER>:<SMTP_PASSWORD>
    ```

    Пример:

    ```
    [smtp.mail.example.local]:25    webim@mail.example.local:YOUR_SMTP_PASSWORD
    ```

  1. Защитите файл и постройте хеш-карту:

    ```
    sudo chmod 600 /etc/postfix/sasl_passwd
    sudo postmap hash:/etc/postfix/sasl_passwd
    ```

!!! Note "N.B."
    Если Exchange Server принимает письма с IP-адреса релея без аутентификации (отдельный Receive Connector), файл `sasl_passwd` и параметры `smtp_sasl_*` ниже не нужны. Пропустите этот шаг и не включайте `smtp_sasl_auth_enable`.

## Карта маршрутизации

Карта транспорта отправляет **всю** исходящую почту на целевой SMTP, а не пытается доставлять её напрямую по MX.

  1. Создайте файл `/etc/postfix/transport`:

    ```
    *    smtp:[<SMTP_HOST>]:<SMTP_PORT>
    ```

    Пример:

    ```
    *    smtp:[smtp.mail.example.local]:25
    ```

  1. Постройте хеш-карту:

    ```
    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` остаётся запасным маршрутом.

!!! Warning "Важно"
    Не указывайте `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`](https://webim.ru/kb/devops/main-ini-configuration.html) для 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](https://webim.ru/kb/channels/mail/email-imap.html) в форме канала укажите тот же хост и порт релея (например, `172.16.0.1` и `25`), без шифрования. Поля логина и пароля SMTP в канале оставьте пустыми, если релей принимает почту по `mynetworks`.

!!! Note "N.B."
    Если **Webim Server** отказывается подключаться к релею без AUTH, включите на Postfix SASL для **входящих** соединений (`smtpd_sasl_auth_enable`) с механизмами `LOGIN`/`PLAIN` и укажите эти учётные данные в `hostedmode_smtp_*`. Это отдельная настройка smtpd, её не следует путать с `smtp_sasl_*` для исходящей авторизации на целевом SMTP.

## Проверка

  1. С хоста релея отправьте тестовое письмо:

    ```
    printf "Subject: Webim SMTP relay test\n\nRelay test\n" | sudo sendmail -v -f noreply@mail.example.local recipient@example.local
    ```

  1. Смотрите журнал:

    ```
    sudo tail -f /var/log/mail.log
    ```

    Успешная цепочка выглядит так: письмо принято от `127.0.0.1` или из `<RELAY_NETWORK>`, затем ушло на `[<SMTP_HOST>]:<SMTP_PORT>` со статусом `sent`.

  1. Повторите проверку из сценария **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`.

---

Источник: https://webim.ru/kb/devops/smtp-relay.html
