Главная / Документация / Настройки продуктаSMTP: отправка писем системыКак подключить volrix.pm к почтовому серверу: поля SMTP, примеры для Exchange и корпоративного сервера, тестовое письмо и разбор ошибок отправки.Обновлено 23.10.2026Через SMTP volrix.pm отправляет свои письма: приглашения новым сотрудникам, восстановление пароля, письма по согласованиям и уведомления о событиях. Настройка одна на всю установку. Пока она не заполнена, письма не уходят.«Администрирование» → «Настройки продукта» → «Почта» → вкладка «Отправка (SMTP)».Раздел открывают права smtp.read (просмотр), smtp.update (изменение) и smtp.test (тестовое письмо). По умолчанию они есть только у администратора системы, другим ролям их выдают в разделе Роли и права.Что стоит после установкиУстановщик записывает в файл .env заглушку: сервер smtp.example.com, порт 587, отправитель noreply@example.com, условный пароль и выключенную проверку сертификата. Страница показывает эти значения, пока вы не сохраните свои, а значок «Пароль установлен» в шапке горит зеленым из-за пароля-заглушки. Письма при этом не уходят: ошибка видна только при тестовой отправке или в журнале backend.Значения, сохраненные на странице, хранятся в базе и важнее значений из .env. Перезапуск не нужен: следующее письмо уйдет уже с новыми настройками. Пароль хранится зашифрованным и обратно не показывается. Параметры SMTP и URL фронтенда. Поле пароля скрыто.

Поля

Поле

Что указать

«Хост»

Имя SMTP-сервера, например mail.company.ru. Если включена проверка сертификата, имя должно совпадать с именем в сертификате сервера.

«Порт»

587 - стандартный порт отправки с STARTTLS, 465 - SSL/TLS с первого байта, 25 - релей организации без шифрования. Порт должен соответствовать выбранному «Шифрованию».

«Пользователь (email отправителя)»

Учетная запись для входа на сервер. Этот же адрес стоит в поле «От» всех писем, поэтому указывайте почтовый адрес целиком (noreply@company.ru), а не имя вида DOMAIN\login. Релей организации без авторизации тоже требует адрес отправителя, но пароль для него не нужен.

«Пароль»

Пароль учетной записи или пароль приложения. Пустое поле при сохранении означает «не менять»: в поле подсказка «Введите новый пароль чтобы изменить». Для релея без авторизации сохраненный пароль удаляет флажок «Удалить сохраненный пароль (релей без авторизации)». Вход на сервер выполняется, только если заданы и пользователь, и пароль.

«Имя отправителя»

Что получатель видит рядом с адресом. Если очистить поле, подставится «Volrix». Для писем по шаблонам важнее «Имя отправителя» на вкладке «Уведомления», если оно заполнено.

«Шифрование»

«STARTTLS (обычно порт 587)»: после подключения соединение переводится в шифрование. «SSL/TLS (обычно порт 465)»: шифрование с первого байта. «Без шифрования (порт 25)»: только для релея во внутренней сети - иначе логин и пароль идут открытым текстом. Прежние настройки перенесены сами: включенный STARTTLS стал «STARTTLS», выключенный - «Без шифрования».

«Проверять TLS-сертификат»

Включено: сертификат сервера проверяется по доверенным корневым центрам контейнера backend. Выключают для самоподписанного сертификата или сертификата внутреннего центра, которого контейнер не знает. Отдельного поля для загрузки своего корневого сертификата в продукте нет.

«URL фронтенда»

Адрес, по которому сотрудники открывают систему, с протоколом и без косой черты в конце: https://pm.company.ru. Из него строится ссылка в письме «Забыли пароль».

Как система подключается к серверуvolrix.pm открывает соединение с указанным хостом и портом в выбранном режиме «Шифрования» (STARTTLS - обычное соединение, затем перевод в шифрование; SSL/TLS - шифрование с первого байта; без шифрования), входит с логином и паролем, если оба заданы, и передает письмо. Из этого следует:

**Вход выполняется, только если заданы пользователь и пароль.** Релей без авторизации (сервер пропускает письма по IP-адресу отправителя) подходит: оставьте пароль пустым и при необходимости отметьте «Удалить сохраненный пароль (релей без авторизации)».

**Порт 465 поддерживается:** выберите «Шифрование» → «SSL/TLS». «Без шифрования» (порт 25) - только для внутренней сети. Письма модуля «Почта», которые идут через системный SMTP, и приглашения на встречи с файлом календаря следуют тому же режиму. Личные ящики сотрудников настраиваются отдельно - см. Почта.

Примеры настроек

Сервер

Хост и порт

Шифрование

Проверять сертификат

Пользователь

Exchange Server в своей сети, клиентская отправка

mail.company.ru, 587

STARTTLS

включено, если сертификат выдан доверенным центром; для сертификата внутреннего центра - выключено

почтовый адрес ящика, от имени которого уходят письма, например noreply@company.ru

Корпоративный почтовый сервер с авторизацией (Postfix и подобные)

relay.company.local, 587 или 465

STARTTLS на 587, SSL/TLS на 465

по сертификату сервера

учетная запись, заведенная для volrix.pm

Gmail (личный аккаунт с двухфакторной проверкой)

smtp.gmail.com, 587

STARTTLS

включено

адрес Gmail, пароль - пароль приложения

Релей организации по IP, без логина

relay.company.local, 25

Без шифрования (или STARTTLS, если сервер его предлагает)

по сертификату сервера

адрес отправителя; пароль пустой

Сервер принимает только 465

mail.company.ru, 465

SSL/TLS

по сертификату сервера

учетная запись с правом отправки

Microsoft 365 (Exchange Online), Google Workspace

не подойдут: там вход по паролю отключен, а системная отправка умеет только пароль

Проверка отправки

Сохраните настройки Нажмите «Сохранить». Появится уведомление «Настройки SMTP обновлены». Тест работает только с сохраненными значениями, изменения в форме без сохранения он не видит.

Отправьте тестовое письмо В блоке «Тест отправки» введите адрес в поле «Email для теста» и нажмите «Отправить тест». При успехе появится уведомление «Письмо отправлено» с текстом «Тестовое письмо отправлено на ...». При ошибке над формой появится красная плашка «Не удалось отправить письмо: <тип ошибки>: <ответ сервера>» - разбор ниже.

Проверьте ящик получателя Тема письма - «<название портала>: тест SMTP». Загляните и в «Спам». «Письмо отправлено» значит, что сервер принял письмо; дальнейшую доставку решает уже он.

Проверьте ссылку На странице входа запросите «Забыли пароль» для тестовой учетной записи и убедитесь, что ссылка в письме ведет на ваш адрес.

Проверьте рабочее письмо Например, отправьте тестовую заявку на согласование: письмо «Назначено согласование» уходит участнику без настроек с его стороны. Уведомления о задачах, поручениях и других событиях получают только те, кто включил «Присылать на почту» в «Профиль» → «Уведомления».

Ссылки в письмах: поле и FRONTEND_URLПоле «URL фронтенда» на этой странице задает ссылку только в письме восстановления пароля по кнопке «Забыли пароль». Ссылки в приглашении нового сотрудника и в письме о сбросе пароля администратором строятся из переменной FRONTEND_URL в файле .env - установщик записывает туда http://<IP-адрес сервера>:3000. От FRONTEND_URL также зависят признак Secure у cookie при https и адрес возврата единого входа OIDC.Поэтому при смене адреса системы поменяйте оба значения: поле на странице и FRONTEND_URL в .env. Контейнер перечитывает .env только при пересоздании, простого перезапуска мало:cd <каталог установки> docker compose -f docker-compose.release.yml up -d backend schedulerЕсли не получается

Что видно

Причина и что сделать

«Не удалось отправить письмо: SMTPAuthenticationError: (535, ...)»

Сервер не принял логин или пароль. Проверьте «Пользователь» и введите пароль заново: пустое поле пароль не меняет. Для Gmail нужен пароль приложения, а не пароль аккаунта.

«SMTPNotSupportedError: SMTP AUTH extension not supported by server»

Сервер не предлагает вход, а пользователь и пароль заданы. Для релея без авторизации оставьте пароль пустым (отметьте «Удалить сохраненный пароль»). Если вход нужен, но предлагается только после STARTTLS, выберите «Шифрование» → «STARTTLS».

«SMTPNotSupportedError: STARTTLS extension not supported by server»

На этом порту сервер не умеет STARTTLS. Уточните порт у почтового администратора (обычно 587), выберите «SSL/TLS» для порта 465 или «Без шифрования» для сервера во внутренней сети.

«SSLCertVerificationError ... certificate verify failed»

Сертификат не прошел проверку: хост не совпадает с именем в сертификате, сертификат просрочен или выдан внутренним центром. Укажите «Хост» точно как в сертификате; для внутреннего центра выключите «Проверять TLS-сертификат».

Кнопка крутится около минуты, затем TimeoutError или SMTPServerDisconnected

Порт закрыт сетевым экраном или режим «Шифрования» не соответствует порту: на 465 нужно «SSL/TLS», на 587 - «STARTTLS». Проверьте, что сервер volrix.pm может подключиться к почтовому серверу.

«gaierror ... Name or service not known» или «ConnectionRefusedError»

Имя хоста не находится в DNS (опечатка) или на этом порту никто не слушает. Проверьте «Хост» и «Порт».

Значок «Пароль установлен», хотя пароль никто не вводил

Это пароль-заглушка из .env. Введите настоящий пароль и сохраните.

Тест дошел, а уведомления о задачах не приходят

Такие письма уходят только сотрудникам, включившим «Присылать на почту» в «Профиль» → «Уведомления» (по умолчанию выключено). Письма о согласованиях и доступе от этой настройки не зависят.

В письме ссылка на localhost или на IP:3000

Исправьте «URL фронтенда» и FRONTEND_URL в .env, как описано выше. Уже отправленные письма не изменятся - проверяйте на новом.

Письма попадают в «Спам»

Адрес «От» должен принадлежать домену, от имени которого почтовый сервер имеет право отправлять. Записи SPF и DKIM настраивает почтовый администратор.

На этой же вкладке ниже - блок «Telegram» с токеном бота. К отправке почты он не относится.

Почтовые уведомления

Общий ящик (IMAP)

Профиль и уведомления

Оформление писем, шаблоны и какие письма можно отключить.Прием писем организации в раздел «Почта».Где сотрудник включает письма о событиях.

Администрирование: обзор области