vm:b24:02-email_settings [FAQ база знаний]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
файл .msmtprc находится тут \\
/home/bitrix

команда теста\\
<code>
php -r "mail('jblbild@mail.ru', 'Test message', 'This is a test.');"
</code>



====== Настройка системной почты в Bitrix Virtual Appliance ======

===== Описание =====

Инструкция по настройке SMTP для отправки системных писем в Bitrix Virtual Appliance 9.x.

===== Требования =====

  * Bitrix Virtual Appliance 9.x
  * Данные SMTP-сервера (хост, порт, логин, пароль)
  * Root-доступ к серверу

===== Настройка через меню VA =====

==== Шаг 1: Создание пула (если не создан) ====

Запустите меню управления:

<code bash>
/root/menu.sh
</code>

Если пул не создан, выберите:

  - **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) ====

<code bash>
nano /home/bitrix/.msmtprc
</code>

<code>
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
</code>

Установите права:

<code bash>
chmod 600 /home/bitrix/.msmtprc
chown bitrix:bitrix /home/bitrix/.msmtprc
</code>

==== Пример конфигурации для порта 587 (STARTTLS) ====

<code>
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
</code>

===== Важные параметры TLS =====

| **Порт** | **Тип шифрования** | **Параметр tls_starttls** |
| 465 | SSL (сразу) | ''off'' |
| 587 | STARTTLS | ''on'' |
| 25 | Без шифрования / STARTTLS | ''on'' или отключить tls |

===== Тестирование отправки =====

==== Тест через msmtp ====

<code bash>
echo -e "Subject: Test\n\nTest body" | msmtp -v recipient@example.com
</code>

Флаг ''-v'' выводит подробный лог подключения.

==== Тест через PHP ====

<code bash>
php -r "mail('recipient@example.com', 'Test', 'Test body');"
</code>

==== Проверка лога ====

<code bash>
tail -20 /home/bitrix/msmtp_default.log
</code>

===== Настройка имени отправителя =====

Имя отправителя настраивается не в msmtp, а в Битриксе:

  - Перейдите в **Настройки → Настройки продукта → Настройки модулей → Главный модуль**
  - Заполните поля **E-Mail** и **Имя отправителя**

Либо добавьте заголовок From при отправке:

<code bash>
echo -e "From: Bitrix24 <noreply@example.com>\nSubject: Test\n\nBody" | msmtp recipient@example.com
</code>

===== Типичные ошибки =====

==== 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''

===== См. также =====

  * [[bitrix:va:install|Установка Bitrix VA]]
  * [[bitrix:va:menu|Меню управления VA]]