файл .msmtprc находится тут
/home/bitrix
команда теста
php -r "mail('jblbild@mail.ru', 'Test message', 'This is a test.');"
Настройка системной почты в Bitrix Virtual Appliance
Описание
Инструкция по настройке SMTP для отправки системных писем в Bitrix Virtual Appliance 9.x.
Требования
- Bitrix Virtual Appliance 9.x
- Данные SMTP-сервера (хост, порт, логин, пароль)
- Root-доступ к серверу
Настройка через меню VA
Шаг 1: Создание пула (если не создан)
Запустите меню управления:
/root/menu.sh
Если пул не создан, выберите:
- 1. Create management pool on the server
- Введите имя сервера (например:
bitrix-mainили нажмите Enter дляlocalhost)
Шаг 2: Переход к настройкам почты
В главном меню выберите:
- 8. Configure pool sites
- 4. Change a site's email settings
Шаг 3: Ввод параметров SMTP
Введите данные вашего SMTP-сервера:
| Параметр | Пример значения | Описание |
| From email address | noreply@example.com | Адрес отправителя |
| Server address | smtp.timeweb.ru | SMTP-сервер |
| Server port | 465 | Порт (465 для SSL, 587 для STARTTLS) |
| SMTP authentication | y | Использовать аутентификацию |
| Login | noreply@example.com | Логин SMTP |
| Password | ваш_пароль | Пароль SMTP |
| Authentication method | auto | Метод аутентификации |
| Enable TLS | y | Включить шифрование |
Конфигурационные файлы
Настройки сохраняются в следующих файлах:
| Файл | Назначение |
/home/bitrix/.msmtprc | Основной конфиг SMTP |
/home/bitrix/msmtp_default.log | Лог отправки писем |
/etc/msmtprc | Системный конфиг (может ссылаться на основной) |
Ручная настройка msmtp
Пример конфигурации для порта 465 (SSL)
nano /home/bitrix/.msmtprc
account default logfile /home/bitrix/msmtp_default.log host smtp.timeweb.ru port 465 from noreply@example.com aliases /etc/aliases keepbcc off auth on user noreply@example.com password ваш_пароль tls on tls_starttls off tls_certcheck off
Установите права:
chmod 600 /home/bitrix/.msmtprc chown bitrix:bitrix /home/bitrix/.msmtprc
Пример конфигурации для порта 587 (STARTTLS)
account default logfile /home/bitrix/msmtp_default.log host smtp.example.com port 587 from noreply@example.com aliases /etc/aliases keepbcc off auth on user noreply@example.com password ваш_пароль tls on tls_starttls on tls_certcheck off
Важные параметры TLS
| Порт | Тип шифрования | Параметр tls_starttls |
| 465 | SSL (сразу) | off |
| 587 | STARTTLS | on |
| 25 | Без шифрования / STARTTLS | on или отключить tls |
Тестирование отправки
Тест через msmtp
echo -e "Subject: Test\n\nTest body" | msmtp -v recipient@example.com
Флаг -v выводит подробный лог подключения.
Тест через PHP
php -r "mail('recipient@example.com', 'Test', 'Test body');"
Проверка лога
tail -20 /home/bitrix/msmtp_default.log
Настройка имени отправителя
Имя отправителя настраивается не в msmtp, а в Битриксе:
- Перейдите в Настройки → Настройки продукта → Настройки модулей → Главный модуль
- Заполните поля E-Mail и Имя отправителя
Либо добавьте заголовок From при отправке:
echo -e "From: Bitrix24 <noreply@example.com>\nSubject: Test\n\nBody" | msmtp recipient@example.com
Типичные ошибки
535 Incorrect authentication data
Причина: Неверный логин или пароль.
Решение:
- Проверьте логин и пароль в панели хостинга
- Убедитесь что почтовый ящик существует и активен
- Используйте пароль от почты, не от хостинга
Connection refused / timeout
Причина: Неверный порт или блокировка файрволом.
Решение:
- Проверьте порт (465 или 587)
- Проверьте доступность:
telnet smtp.example.com 465
TLS handshake failed
Причина: Неверные настройки TLS.
Решение:
- Для порта 465: установите
tls_starttls off - Для порта 587: установите
tls_starttls on