Настройка почтового сервера (Mailu): различия между версиями
Новая статья: почтовый сервер Mailu на VDS, проверено на Ubuntu 24.04, со снимками экрана |
Добавлен раздел о проверке писем на другие почтовые службы и обратно |
||
| Строка 200: | Строка 200: | ||
Запись «status=sent … Saved» означает, что письмо доставлено в ящик. | Запись «status=sent … Saved» означает, что письмо доставлено в ящик. | ||
=== Письма на другие почтовые службы и обратно === | |||
Когда записи из шагов 1 и 7 созданы, проверьте связь с внешним миром: | |||
'''1.''' Убедитесь, что обратная запись адреса сервера указывает на имя почтового сервера. Подставьте адрес своего сервера: | |||
<pre>dig +short -x 203.0.113.10</pre> | |||
В ответе должно быть <code>mail.example.com.</code> Если ответ пустой или в нём другое имя — попросите поддержку хостинга настроить обратную запись. | |||
'''2.''' Отправьте из веб-почты письмо на свой ящик в любой другой почтовой службе. | |||
'''3.''' Откройте полученное письмо и посмотрите его служебные заголовки — в почтовых службах это пункт «Показать оригинал» или «Свойства письма». В строке <code>Authentication-Results</code> должно быть: | |||
* <code>spf=pass</code> — запись SPF найдена, и письмо пришло с разрешённого сервера; | |||
* <code>dkim=pass</code> — подпись письма совпала с ключом из записи DKIM; | |||
* <code>dmarc=pass</code> — домен отправителя подтверждён. | |||
'''4.''' Ответьте на это письмо — ответ должен появиться в веб-почте вашего сервера. Если он не пришёл, проверьте запись MX: <code>dig +short MX example.com</code>. | |||
Если письмо попало в спам или в заголовках вместо <code>pass</code> стоит <code>fail</code> или <code>none</code>, причина почти всегда в записях DNS: сверьте их со значениями из панели (шаг 7) и подождите, пока изменения разойдутся, — до нескольких часов. Новому серверу почтовые службы доверяют не сразу: первые дни часть писем может попадать в спам даже при верных записях. | |||
== 10. Настройте почтовую программу == | == 10. Настройте почтовую программу == | ||
Версия от 08:18, 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:
- VPS/VDS серверы — для небольших и средних проектов
- Выделенные серверы — для высоконагруженных проектов