Различия

Показаны различия между двумя версиями страницы.

--- vm:b24:02-email_settings [2025/09/29 18:20] – admin
+++ vm:b24:02-email_settings [2025/12/10 07:34] (текущий) – admin
@@ Строка 8: / Строка 8: @@
+====== Настройка системной почты в 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]]