Настройка почтового сервера (Mailu): различия между версиями

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску
Оформление: строка навигации; в старых статьях — нумерация шагов, размер картинок, лишние пустые строки, повтор заголовка
Добавлен блок со ссылками на Telegram
 
Строка 312: Строка 312:
* '''[https://ark-hoster.ru/vpsgame/ VPS/VDS серверы]''' — для небольших и средних проектов
* '''[https://ark-hoster.ru/vpsgame/ VPS/VDS серверы]''' — для небольших и средних проектов
* '''[https://ark-hoster.ru/dedicated/ Выделенные серверы]''' — для высоконагруженных проектов
* '''[https://ark-hoster.ru/dedicated/ Выделенные серверы]''' — для высоконагруженных проектов
{{Телеграм}}

Текущая версия от 11:38, 16 ноября 2026

Mailu — готовый почтовый сервер, который устанавливается на VDS одной командой. В него входят приём и отправка почты, веб-почта, панель администратора, защита от спама и автоматическое получение сертификата Let's Encrypt. Всё работает в контейнерах Docker и настраивается через веб-панель — править файлы Postfix и Dovecot вручную не нужно.

Все команды проверены 16 ноября 2026 года на Ubuntu 24.04.4 с Mailu 2024.06. Снимки экрана сняты с настоящего сервера с тестовым доменом wikitest.ark-hoster.ru. В тексте домен называется example.com, а почтовый сервер — mail.example.com; подставляйте свои имена.

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

  • VDS с 2 ГБ памяти или больше. Сам Mailu занимает около 800 МБ. Если включить проверку писем антивирусом, нужно не меньше 4 ГБ. Подходящий сервер — на странице тарифов VPS/VDS.
  • Свой домен и доступ к его записям DNS у регистратора.
  • Сервер только под почту. Mailu сам занимает порты 80 и 443, поэтому на том же сервере не должно быть другого веб-сервера и другой почтовой программы. Проверьте — команда не должна ничего показать:
sudo ss -tlnp | grep -E ":(25|80|443|465|993) "
  • Обратная запись (PTR) для адреса сервера, указывающая на mail.example.com. Её настраивает хостинг — напишите в поддержку. Без неё крупные почтовые службы отклоняют письма или кладут их в спам.

1. Записи DNS

До установки создайте у регистратора домена две записи:

Тип Имя Значение
A mail.example.com Адрес вашего сервера
MX example.com mail.example.com, приоритет 10

Запись A нужна сразу: без неё Mailu не получит сертификат. Ещё три записи — SPF, DKIM и DMARC — добавляются после установки, их точные значения покажет панель администратора (шаг 7).

Проверьте, что запись разошлась:

dig +short mail.example.com

2. Установите Docker

sudo apt update
sudo apt install -y docker.io docker-compose-v2
docker --version
docker compose version

3. Получите файлы настроек

Файлы настроек для Mailu создаёт мастер на сайте разработчиков. Откройте в браузере https://setup.mailu.io:

Заполните поля, остальные оставьте как есть:

Поле Что указать
Mailu storage path /mailu
Main mail domain and server display name Ваш домен: example.com
Postmaster local part admin — получится главный ящик admin@example.com
Choose how you wish to handle security TLS certificates letsencrypt
Enable the admin UI Включено
Enable Web email client roundcube
Enable the antivirus service Выключено, если на сервере меньше 4 ГБ памяти
IPv4 listen address Внешний адрес вашего сервера
Enable an internal DNS resolver (unbound) Включено
Public hostnames mail.example.com

Нажмите «Setup Mailu». Мастер покажет команды с адресами двух ваших файлов. Выполните их на сервере:

sudo mkdir /mailu
cd /mailu
sudo wget АДРЕС_ИЗ_МАСТЕРА/docker-compose.yml
sudo wget АДРЕС_ИЗ_МАСТЕРА/mailu.env

Откройте файл mailu.env и поправьте часовой пояс — строку TZ=Etc/UTC замените на TZ=Europe/Moscow. Затем проверьте главное:

grep -E "^(DOMAIN|HOSTNAMES|POSTMASTER|TLS_FLAVOR|WEBMAIL|ANTIVIRUS|TZ)=" mailu.env
grep -A 4 "ports:" docker-compose.yml

На снимке тестовый домен указан и как домен почты, и как имя сервера; у вас в строке HOSTNAMES будет mail.example.com.

4. Укажите DNS-серверы

Внутри Mailu работает собственная служба, которая переводит имена доменов в адреса. По умолчанию она обращается к корневым серверам интернета напрямую. На VDS ARK-HOSTER её нужно направить на DNS-серверы хостинга — без этого шага Mailu не запустится.

Узнайте адреса DNS-серверов своего сервера:

resolvectl status | grep "DNS Servers"

Сохраните настройки службы в отдельный файл и допишите в него эти адреса — подставьте свои вместо 109.248.4.6 и 95.182.102.6:

sudo mkdir -p /mailu/overrides
docker run --rm --entrypoint cat ghcr.io/mailu/unbound:2024.06 /unbound.conf | sudo tee /mailu/overrides/unbound.conf > /dev/null
printf 'forward-zone:\n  name: "."\n  forward-addr: 109.248.4.6\n  forward-addr: 95.182.102.6\n' | sudo tee -a /mailu/overrides/unbound.conf

Теперь подключите этот файл. Откройте docker-compose.yml, найдите раздел resolver: и после строки restart: always добавьте две строки — с теми же отступами, что на снимке:

sudo nano /mailu/docker-compose.yml
    volumes:
      - "/mailu/overrides/unbound.conf:/unbound.conf:ro"

На снимке: конец файла с адресами, нужное место в docker-compose.yml и перезапуск службы после правки.

5. Запустите Mailu

cd /mailu
docker compose -p mailu up -d

При первом запуске скачивается около 1 ГБ — это занимает несколько минут.

Подождите две-три минуты и проверьте состояние:

docker compose -p mailu ps --format "table {{.Service}}\t{{.Status}}"

У всех служб должно быть healthy. Если у какой-то дольше пяти минут держится unhealthy — см. раздел «Если что-то пошло не так».

Сертификат Mailu получает сам. Проверьте его:

echo | openssl s_client -connect mail.example.com:443 -servername mail.example.com 2>/dev/null | openssl x509 -noout -issuer -subject -dates

В строке issuer должно быть «Let's Encrypt». Продлевает сертификат Mailu тоже сам.

6. Создайте администратора

Задайте пароль главного ящика admin@example.com — подставьте свой домен и свой пароль:

docker compose -p mailu exec admin flask mailu admin admin example.com 'ПАРОЛЬ'

Откройте в браузере https://mail.example.com/admin, введите адрес ящика и пароль и нажмите «Войти Admin»:

Язык панели переключается значком в правом верхнем углу.

7. Добавьте записи SPF, DKIM и DMARC

Эти три записи подтверждают другим почтовым службам, что письма с вашего домена отправляет именно ваш сервер. Без них письма попадают в спам.

В панели откройте «Почтовые домены», нажмите значок подробностей рядом с доменом и кнопку «Перегенерировать ключи». Панель покажет готовые записи:

Создайте у регистратора домена записи типа TXT из строк «DNS SPF запись», «DNS DKIM запись» и «DNS DMARC запись». Имя записи — первое слово строки, значение — текст в кавычках. Значок с восклицательным знаком рядом со строкой означает, что такой записи в DNS пока нет: на снимке у тестового домена не создана запись MX.

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

dig +short MX example.com
dig +short TXT example.com
dig +short TXT dkim._domainkey.example.com
dig +short TXT _dmarc.example.com

8. Создайте почтовые ящики

В панели: «Почтовые домены» → значок пользователей рядом с доменом → «Добавить пользователя».

Список ящиков домена:

То же самое из терминала:

docker compose -p mailu exec admin flask mailu user ivan example.com 'ПАРОЛЬ'
docker compose -p mailu exec admin flask mailu config-export user.email

Пользователь, созданный из терминала, при первом входе должен сменить пароль на собственный.

9. Проверьте почту

Веб-почта открывается по адресу https://mail.example.com/webmail: введите адрес ящика, пароль и нажмите «Войти Webmail». Отправьте письмо с одного ящика на другой:

Доставку видно и в журнале сервера:

docker compose -p mailu logs smtp 2>&1 | grep "status=sent" | tail -n 1

Запись «status=sent … Saved» означает, что письмо доставлено в ящик.

Письма на другие почтовые службы и обратно

Когда записи из шагов 1 и 7 созданы, проверьте связь с внешним миром:

1. Убедитесь, что обратная запись адреса сервера указывает на имя почтового сервера. Подставьте адрес своего сервера:

dig +short -x 203.0.113.10

В ответе должно быть mail.example.com. Если ответ пустой или в нём другое имя — попросите поддержку хостинга настроить обратную запись.

2. Отправьте из веб-почты письмо на свой ящик в любой другой почтовой службе.

3. Откройте полученное письмо и посмотрите его служебные заголовки — в почтовых службах это пункт «Показать оригинал» или «Свойства письма». В строке Authentication-Results должно быть:

  • spf=pass — запись SPF найдена, и письмо пришло с разрешённого сервера;
  • dkim=pass — подпись письма совпала с ключом из записи DKIM;
  • dmarc=pass — домен отправителя подтверждён.

4. Ответьте на это письмо — ответ должен появиться в веб-почте вашего сервера. Если он не пришёл, проверьте запись MX: dig +short MX example.com.

Если письмо попало в спам или в заголовках вместо pass стоит fail или none, причина почти всегда в записях DNS: сверьте их со значениями из панели (шаг 7) и подождите, пока изменения разойдутся, — до нескольких часов. Новому серверу почтовые службы доверяют не сразу: первые дни часть писем может попадать в спам даже при верных записях.

10. Настройте почтовую программу

Параметры для почтовых программ и телефонов показаны в панели, в разделе «Настройка клиента»:

Сервер Порт Шифрование
Входящая почта (IMAP) mail.example.com 993 TLS
Исходящая почта (SMTP) mail.example.com 465 TLS

Имя пользователя — адрес ящика целиком. Порты 143 и 587 из старых инструкций Mailu по умолчанию не обслуживает: подключения на них отклоняются.

Обслуживание

Все команды выполняются в каталоге /mailu.

Команда Что делает
docker compose -p mailu ps Состояние служб
docker compose -p mailu logs --tail 50 smtp Журнал отправки и приёма писем
docker compose -p mailu logs --tail 50 front Журнал подключений и получения сертификата
docker compose -p mailu restart Перезапустить все службы
docker compose -p mailu pull && docker compose -p mailu up -d Обновить Mailu в пределах своей версии
docker compose -p mailu exec admin flask mailu password admin example.com 'ПАРОЛЬ' Задать новый пароль ящику

После перезагрузки сервера Mailu запускается сам.

Сколько занимает

free -h
docker stats --no-stream --format "table {{.Name}}\t{{.MemUsage}}"
sudo du -sh /mailu

Больше всего памяти у панели администратора и защиты от спама. Каталог /mailu растёт вместе с почтой — следите за местом на диске: Управление дисками и файловыми системами.

Резервная копия

Все данные — письма, ящики, ключи, сертификаты и настройки — лежат в каталоге /mailu. Остановите Mailu, упакуйте каталог и запустите снова:

cd /mailu
docker compose -p mailu stop
sudo tar --warning=no-file-ignored -czf /root/mailu-backup-$(date +%F).tar.gz -C / mailu
docker compose -p mailu start

Пока Mailu остановлен, письма не теряются: серверы отправителей повторяют доставку позже. Архив храните не на том же сервере — см. Настройка автоматических резервных копий.

Если что-то пошло не так

На снимке — самая частая причина, по которой Mailu не запускается: служба имён не может получить ответ.

Что видите Причина и решение
У службы admin состояние unhealthy, в её журнале «Your DNS resolver at … is not working» Не выполнен шаг 4. Выполните его и запустите docker compose -p mailu up -d
После исправления DNS служба front осталась unhealthy, порты 465 и 993 не отвечают Она запустилась раньше, чем был получен сертификат. Перезапустите её: docker compose -p mailu restart front
Сертификат не получен, браузер предупреждает о небезопасном соединении Нет записи A для mail.example.com или она указывает на другой адрес. Причину покажет docker compose -p mailu logs front
При запуске ошибка о занятом порте На сервере уже работает веб-сервер или почтовая программа. Найдите её командой из раздела «Что понадобится» и удалите
Почтовая программа не подключается Указаны порты 143 или 587. Нужны 993 и 465 с шифрованием TLS
Письма на другие почтовые службы не доходят или попадают в спам Нет обратной записи (PTR) либо записей SPF, DKIM и DMARC — шаги 1 и 7
В журнале «Sender address rejected: Domain … does not accept mail» Сервер отклонил входящее письмо: у домена отправителя нет почты. Так отсеиваются поддельные адреса, настраивать ничего не нужно

Для размещения ваших проектов рекомендуем услуги ARK-HOSTER.RU: