docker-mailserverv17.0.0
Почта для команды на своем домене: ящики, переписка, вложения и вход из почтовых клиентов - замена почтовой части Google Workspace и Яндекс 360.
Команда со своим доменом и администратором получает почту без лицензионной платы DMS за каждый ящик; сервер и сопровождение оплачиваются отдельно. Письма хранятся обычными файлами Maildir, поэтому переписку можно копировать и переносить без привязки к формату чужой базы. Сотрудники работают в привычном почтовом клиенте или отдельном Roundcube с русским интерфейсом. Ящиками и правилами доставки администратор управляет через консоль сервера.
После создания VM установка заведет два ящика, подключит веб-почту и получит сертификат для адреса сервера. В чистом прогоне настройка cloud-init завершилась примерно за 3,5 минуты после старта VM; срок зависит от загрузки пакетов и образов. Дождитесь сообщения о готовности: можно войти и проверить переписку с вложением внутри сервера. Для внешнего приема и отправки администратор настраивает свой домен, DNS/PTR и проверяет доставку.
Что внутри
- docker-mailserver 17.0.0
- почтовый сервер с учетными записями в файлах и хранением писем в Maildir; рецепт собирает образ
fatmetal-dms:17.0.0-rspamd4.2.3поверх официального DMS с закрепленным digest. - Postfix
3.10.13-0+deb13u1и Dovecot1:2.4.1+dfsg1-6+deb13u7 - отправка, прием и доступ к ящикам по SMTP/IMAP; входят в почтовый контейнер.
- Rspamd
4.2.3-1~50bde75~trixieи Valkey8.1.1+dfsg1-3+deb13u3 - фильтрация спама, DKIM-подписи и хранение состояния фильтров; Valkey заменяет Redis из DMS16.
- Roundcube 1.7.5 с PHP 8.4.27 и SQLite
- отдельный веб-клиент с русским интерфейсом для чтения писем и работы с вложениями; исправленная сборка закреплена digest.
- Caddy
2.6.2-6ubuntu0.24.04.3 - HTTPS веб-почты, получение и продление сертификата Let's Encrypt.
- nginx
1.24.0-2ubuntu7.19 - передача почтовых TCP-соединений контейнеру с сохранением адреса клиента.
- Unbound
1.19.2-1ubuntu3.12и Fail2ban1.0.2-3ubuntu0.1 - DNS-проверки антиспама и защита серверных входов от перебора паролей.
Два контейнера на Ubuntu 24.04 LTS: почтовый сервер и веб-клиент. Caddy, nginx, Unbound и Fail2ban установлены на хосте. Для Rspamd рецепт загружает официальный пакет и проверяет его SHA256 перед сборкой образа.
Безопасность
- Ящики создает администраторпубличной регистрации нет; установщик заводит postmaster с паролем сервера, для team генерирует отдельный пароль.
- Шифрование соединенийвеб-почта работает через HTTPS, IMAP через TLS на порту
993, SMTP через STARTTLS на587или TLS на465; авторизация SMTP до TLS не предлагается. - Сертификат обновляется автоматическиCaddy получает и продлевает его, системный таймер переносит обновленную пару в почтовый сервер и перезапускает его при изменении.
- Пересылка без авторизации закрытапосторонний не сможет использовать сервер для отправки писем на чужие внешние адреса без входа в ящик; проверено отказом
554 Relay access denied. - Защита входов от перебораFail2ban банит адрес после пяти неудачных попыток за десять минут на час для SSH и прямых почтовых входов; веб-клиент допускает не более трех неудачных попыток входа в минуту.
- Внутренние панели закрытыконтейнерные порты привязаны к
127.0.0.1, контроллер антиспама не опубликован, прием локальных файлов через его API отключен, установщик Roundcube выключен. - Секреты доступны только rootфайлы реквизитов, сохраненных паролей и приватного TLS-ключа имеют права
600; DKIM-ключ создается отдельно для домена. - Rspamd заменен в производном образевместо штатного Rspamd4.1.5 установлен 4.2.3 с критическими исправлениями безопасности из 4.2.1; его версия и конфигурация проверяются до готовности. Наличие этих исправлений в штатном Rspamd4.1.5 не подтверждено: одной замены тега DMS недостаточно.
- PHP 8.4.27 без уязвимостей PHP2Shellзакрыта CVE-2026-109618: посторонний мог выполнить код без входа в веб-почту. Рецепт проверяет исправленную версию PHP до уведомления о готовности; остальные исправления описаны в разборе.
Как войти
Возьмите IP сервера из панели заказа, замените точки на дефисы и добавьте
.fatmetal.net: например, для45.15.159.62адрес веб-почты будетhttps://45-15-159-62.fatmetal.net.Первый ящик уже создан: логин
postmaster@<адрес сервера без https://>, напримерpostmaster@45-15-159-62.fatmetal.net. Пароль - пароль сервера из личного кабинета, тот же, что для SSH. Если задалиMAIL_DOMAIN, логинpostmaster@<MAIL_DOMAIN>.Нажмите «Написать», укажите адрес своего ящика, добавьте тему, текст и вложение, нажмите «Отправить». Откройте письмо во «Входящих», скачайте вложение и нажмите «Ответить», затем отправьте ответ. Это проверка локального обмена без настройки внешней почты.
Для проверки между двумя ящиками используйте также
team@<домен ящиков>; его отдельный пароль доступен администратору по SSH:sudo cat /root/docker-mailserver-credentials.txt.Для Thunderbird или другого почтового клиента укажите имя сервера без
https://: IMAP993, SSL/TLS; SMTP587, STARTTLS, либо465, SSL/TLS. Логин - полный адрес ящика, пароль - пароль этого ящика.
Важно
Для сопровождения нужен администратор с доступом по SSH. Roundcube читает почту, но не создает ящики и не управляет сервером. По SSH команда sudo docker exec -it mailserver setup email add имя@домен создает новый ящик и запрашивает пароль; sudo docker exec -it mailserver setup email update postmaster@домен меняет пароль первого ящика. Подставьте свой домен ящиков; смена почтового пароля не меняет пароль сервера, повтор установщика не сбрасывает пароль существующего ящика.
Для внешнего обмена опубликуйте MX, SPF, публичный DKIM и DMARC, задайте PTR у провайдера IP. Значения для вашей установки: sudo cat /root/docker-mailserver-dns.txt. Приватный DKIM-ключ в DNS не переносите, существующий SPF дополните вместо создания второй записи. После публикации DKIM задайте DKIM_DNS_CHECK=true командой sudo nano /etc/docker-mailserver-mp/params.env и повторите sudo bash /root/docker-mailserver-install.sh. Отправьте письмо в свой внешний ящик, ответьте обратно и проверьте заголовки SPF/DKIM/DMARC и PTR. Рабочие локальные ящики и сертификат не означают готовую доставку в чужие почтовые сервисы; полный внешний обмен на стенде не подтвержден.
ClamAV в этой поставке выключен: проверка вложений антивирусом не включена. Rspamd выполняет фильтрацию спама. Для календарей, документов и видеозвонков понадобятся отдельные приложения.
Настройте копирование вне этой VM: письма и состояние лежат в /opt/docker-mailserver/data, настройки и DKIM-ключи - в /opt/docker-mailserver/config, файлы запуска - в /opt/docker-mailserver, веб-клиент - в /opt/dms-webmail. Сохраняйте также /etc/docker-mailserver-mp, конфигурации /etc/caddy, /etc/nginx, /etc/unbound, /etc/fail2ban и хранилище сертификатов /var/lib/caddy/.local/share/caddy. Установка сама не создает расписание резервных копий; проверяйте восстановление своих копий.
Лицензия
docker-mailserver распространяется под MIT. Лицензионной платы за ящики у проекта нет; сервер, домен, копии и работу администратора оплачиваете отдельно. У почтовых компонентов и Roundcube собственные лицензии.
Свой домен
- Создайте
A-запись имени почтового сервера, напримерmail.example.org, на публичный IP вашей VM. Дождитесь, покаping mail.example.orgпокажет этот IP. - Подключитесь к серверу по SSH учетной записью из панели. Выполните
sudo nano /etc/docker-mailserver-mp/params.env, задайтеDOMAIN=mail.example.orgиMAIL_DOMAIN=example.orgдля ящиков видаpostmaster@example.org. СохранитеTZ=Europe/MoscowиDKIM_DNS_CHECK=false, пока публичный DKIM TXT не опубликован. Для смены только адреса сервера оставьте прежнее значениеMAIL_DOMAIN- адреса ящиков тогда не изменятся. - Выполните
sudo bash /root/docker-mailserver-install.shи дождитесь строкиREADY. Установщик получит сертификат нового имени и перенастроит веб-почту, SMTP и IMAP; старые ящики и письма сохранятся. ЕслиA-запись пока неверна, доступ останется по исходному адресу сервера: исправьте DNS и повторите команду. - Откройте
https://mail.example.org. ПриMAIL_DOMAIN=example.orgлогинpostmaster@example.org, пароль - первоначальный пароль сервера из панели. Если меняли толькоDOMAIN, входите прежним полным адресом ящика. Если меняли пароль самого ящика, используйте уже этот пароль. - Для внешней переписки прочитайте
sudo cat /root/docker-mailserver-dns.txt, добавьте доменныеMX/SPF/публичныйDKIM/DMARC,PTRзадайте у провайдера IP. После публикации DKIM выполнитеsudo nano /etc/docker-mailserver-mp/params.env, установитеDKIM_DNS_CHECK=trueи повторитеsudo bash /root/docker-mailserver-install.sh. Проверьте письмо во внешний ящик и ответ, а также заголовки аутентификации: смена адреса сервера не выполняет эту проверку за вас.
Требования
Тариф CPU2-RAM4-DISK50 - 2 ядра, 4 ГБ RAM, 50 ГБ диска, 500 руб./мес в разобранной конфигурации. В профиле DMS17 с Rspamd4.2.3 без ClamAV два контейнера занимали около 183 МиБ анонимной памяти в простое, весь узел - около 824 МиБ. При 25 последовательных письмах с вложениями по 1 МиБ наблюдаемый пик контейнеров составил 205 МиБ, всего узла - 876 МиБ, без OOM. Два образа суммарно занимают около 2,11 ГБ. Это проверка одного последовательного пользователя; число одновременных сотрудников из нее не следует. Для роста нагрузки на CPU/RAM выбирайте CPU4-RAM8-DISK100 после замера на своих ящиках.
Планируйте диск по объему переписки: 25 писем с вложением по 1 МиБ заняли еще 33,93 МиБ в Maildir. Расчет для 10 ящиков по 100 таких писем в день дает около 40 ГиБ за месяц без копий «Отправленных» и резервных копий. При планируемом Maildir свыше 30 ГиБ закажите дополнительный блочный диск на 100 ГБ под /opt/docker-mailserver/data/mail.
Переход на 17
В DMS17 изменились хранилище антиспама и имена DKIM-файлов. Для прежнего профиля с ящиками в файлах нужен перенос конфигурации, а не одна замена тега. Команды ниже относятся к FILE-профилю карточки без LDAP и полнотекстового поиска; индивидуальные настройки требуют отдельного плана. Перед любым изменением подключитесь по SSH, выполните sudo -i и сделайте закрытую копию остановленного приложения:
cd /opt/docker-mailserver
docker compose stop
umask 077
tar --acls --xattrs -cpf /root/dms-before-v17.tar -C / opt/docker-mailserver opt/dms-webmail etc/docker-mailserver-mp
docker compose up -d --wait
Перенесите архив с секретами в защищенное хранилище вне VM. Это копия приложения и параметров; конфигурации служб хоста и сертификаты сохраните отдельно, как в разделе «Важно». До переключения сохраните в /opt/docker-mailserver/Dockerfile блок Dockerfile из раздела «Файлы конфигурации» разбора: он закрепляет официальный DMS17 и пакет Rspamd4.2.3. В своем compose.yaml у службы mailserver добавьте build: . и замените только image на fatmetal-dms:17.0.0-rspamd4.2.3; сохраните прежние тома, TLS-пути, домены и секреты. Для старой карточки оставьте Caddy и синхронизацию сертификата: Compose из ручной установки статьи использует другой путь сертификатов. В mailserver.env замените ENABLE_RSPAMD_REDIS на ENABLE_RSPAMD_VALKEY. Старый каталог data/state/lib-redis сохраните: Valkey создаст собственный lib-valkey, обучение Bayes начнется заново.
Существующий приватный DKIM-ключ не генерируйте повторно: укажите свой домен ящиков вместо example.org и перенесите прежний ключ без замены его содержимого. Выполняйте в root-оболочке после остановки контейнеров:
cd /opt/docker-mailserver
docker compose stop
MAIL_DOMAIN=example.org
set -e
test ! -e "config/rspamd/dkim/${MAIL_DOMAIN}-mail.private"
mv "config/rspamd/dkim/rsa-2048-mail-${MAIL_DOMAIN}.private.txt" "config/rspamd/dkim/${MAIL_DOMAIN}-mail.private"
sed -i "s/rsa-2048-mail-${MAIL_DOMAIN}.private.txt/${MAIL_DOMAIN}-mail.private/g" config/rspamd/override.d/dkim_signing.conf
printf '*\n!Dockerfile\n' > .dockerignore
docker compose build --pull
docker compose pull webmail
docker compose up -d --force-recreate --wait
docker exec mailserver rspamd --version
docker exec dms-webmail php -v
Если новый файл ключа уже существует, проверка остановит команды: сравните его с прежним, не затирайте другой ключ. Перенос ключа и замену пути повторите для каждого прежнего домена ящиков. Ожидайте Rspamd4.2.3 и PHP8.4.27. Публичная DKIM-запись остается прежней, если ключ и селектор сохранены; проверьте подпись нового письма. Затем войдите, откройте прежнее письмо с вложением и проверьте новый обмен и ответ. Для индивидуального LDAP или полнотекстового поиска нужен отдельный план: в17 удален Xapian, нужен Flatcurve и переиндексация, у Postfix LDAP изменились фильтры POSTFIX_*_QUERY_FILTER и файлы /etc/postfix/ldap/*.cf. Автоматический рецепт не переводит такой профиль и останавливается до изменения приложения.
Обновление веб-почты
Для существующего сервера проверьте PHP внутри веб-клиента, а не только номер docker-mailserver. Если там PHP 8.4.26, обновите образ Roundcube: PHP 8.4.27 закрывает CVE-2026-109618 и CVE-2026-109619 (PHP2Shell): обе допускают выполнение кода без входа. Обновление пакетов Ubuntu не заменяет PHP внутри этого контейнера.
Подключитесь по SSH, выполните sudo -i, затем команды ниже. Веб-почта на время остановится; архив сохранит ее настройки, базу и прежний Compose. Он содержит секреты: перенесите копию в защищенное хранилище вне VM.
cd /opt/docker-mailserver
docker compose stop webmail
umask 077
tar -czf /root/dms-webmail-before-php2shell.tgz -C / opt/dms-webmail opt/docker-mailserver/compose.yaml
sed -Ei 's|roundcube/roundcubemail:1\.7\.[45]-apache(@sha256:[a-f0-9]{64})?|roundcube/roundcubemail:1.7.5-apache@sha256:dfe7e05eccab55cf3d0d508fade5046ca4c7cd1530070c803d670ec2b2933607|g' compose.yaml
docker compose pull webmail && docker compose up -d --no-deps --force-recreate webmail
docker compose exec -T webmail php -v
Ожидаемая версия - PHP 8.4.27. Закреплен не только тег 1.7.5-apache, но и digest исправленной сборки: до пересборки этот тег содержал PHP 8.4.26. После запуска дождитесь страницы входа по своему прежнему адресу, войдите полным адресом ящика и отправьте письмо с вложением; проверьте ответ.
Для восстановления данных клиента из этой копии оставьте исправленный compose.yaml и верните только /opt/dms-webmail:
cd /opt/docker-mailserver
docker compose stop webmail
tar -xzf /root/dms-webmail-before-php2shell.tgz -C / opt/dms-webmail
docker compose up -d --no-deps --force-recreate webmail
Дождитесь страницы входа, проверьте прежнее письмо и вложение. Эта копия относится к веб-клиенту; письма в Maildir и настройки почтового сервера копируйте отдельно, как указано в разделе «Важно».