Установка

Установщик ставит почтовый сервер, панель, сертификат и таймеры обслуживания за один запуск. Понадобится чистый сервер, доступ по SSH и права root.

Перед установкой

Убедитесь, что система поддерживается:

head -2 /etc/os-release

Подходят Debian, Ubuntu, AlmaLinux, Rocky Linux и CentOS Stream. Полный список версий — в разделе «Требования к серверу».

Проверьте, что провайдер не закрыл исходящий порт 25:

nc -vz gmail-smtp-in.l.google.com 25

Ответ succeeded означает, что порт открыт. Ответ timed out — порт закрыт; попросите поддержку провайдера открыть его.

Создайте у регистратора A-запись для имени сервера, например mail.example.ru, с IP-адресом сервера. Без неё не выпустится сертификат и не откроется панель.

Запуск

curl -fsSL https://0e5.ru/install.sh -o install.sh
sh install.sh

Установщик задаст вопросы. Значение по умолчанию указано в квадратных скобках; чтобы принять его, нажмите Enter.

Вопрос	Ответ
Имя почтового сервера	например, `mail.example.ru`. На это имя выпускается сертификат и открывается панель.
Почтовый домен для ящиков	например, `example.ru`. Можно оставить пустым и добавить домен позже в панели.
Защита от подбора паролей	по умолчанию да, ставится fail2ban.
Календари и контакты	по умолчанию нет. Ответьте `y`, если нужны CalDAV и CardDAV.
Веб-почта	по умолчанию да, ставится Roundcube.
Антивирус для писем	по умолчанию да, ставится ClamAV. Требует дополнительной памяти.
Первый ящик	например, `ivan@example.ru`. Вопрос задаётся, только если указан домен.

Если выбрана веб-почта, установщик дополнительно спросит её адрес, по умолчанию webmail.example.ru. Это имя тоже должно указывать на сервер.

Дальше установка идёт без вопросов и занимает несколько минут.

Итоговый отчёт

В конце установщик выводит:

адрес панели и пароль администратора;
адрес и пароль первого ящика, если он был создан;
записи DNS для домена: MX, A, SPF, DMARC и DKIM — их нужно добавить у регистратора;
напоминание про PTR: какой адрес на какое имя попросить у провайдера;
адреса веб-почты и календарей, если они включены.

Сохраните пароль панели в надёжном месте. Он также хранится на сервере в файле /opt/mailnode/panel.pass.

Проверка

mailnode doctor

Все службы должны быть в состоянии active:

✓ служба postfix (active)
✓ служба dovecot (active)
✓ служба opendkim (active)
✓ служба rspamd (active)

Строки о записях MX будут отмечены крестиком, пока записи DNS не опубликованы.

Откройте панель по адресу из отчёта, например https://mail.example.ru/panel, и войдите с паролем администратора. Если страница не открывается, проверьте A-запись имени сервера и состояние службы командой systemctl status mailpanel. Подробнее — в разделе «Если не работает».

Что делает установщик

ставит Postfix (приём и отправка), Dovecot (хранение и IMAP), OpenDKIM (подпись писем), rspamd (спам) и выбранные компоненты;
создаёт системного пользователя vmail, которому принадлежат письма;
создаёт базу настроек /opt/mailnode/state/mailnode.db и собирает из неё конфигурацию служб;
настраивает Caddy: сертификат Let's Encrypt, панель и веб-почту на порту 443;
запускает панель как службу mailpanel;
включает таймеры: резервная копия в 03:30, проверка сертификата раз в час, проверка состояния каждые 15 минут, разбор отчётов DMARC в 04:20, проверка обновлений по воскресеньям.

Установка без вопросов

Для автоматической установки ответы передаются флагами:

sh install.sh --domain mail.example.ru --mail-domain example.ru \
  --mailbox ivan@example.ru --with-calendar --with-webmail --no-antivirus

Флаг	Назначение
`--domain`	имя почтового сервера
`--mail-domain`	домен, который добавить сразу
`--mailbox`	первый ящик
`--with-calendar`, `--no-calendar`	календари и контакты
`--with-fail2ban`, `--no-fail2ban`	защита от подбора паролей
`--with-webmail`, `--no-webmail`	веб-почта
`--webmail-host`	адрес веб-почты
`--with-antivirus`, `--no-antivirus`	антивирус
`--no-caddy`	не ставить Caddy; панель будет доступна на порту 8780, сертификат настраивается вручную
`--check`	показать принятые ответы и выйти, ничего не устанавливая

Удаление

sh install.sh --uninstall

Команда выключает службы и таймеры Phoenix Mail. Файлы в /opt/mailnode и письма в /var/mail остаются.

--purge — удалить также /opt/mailnode и сертификаты; удаление писем установщик спросит отдельно;
--packages — удалить пакеты Postfix, Dovecot, rspamd, Roundcube, Caddy и вернуть Caddyfile к состоянию до установки. Работает только на системах с apt.

Сделайте копию перед удалением

С флагом --purge база настроек и ключи DKIM удаляются без возможности восстановления. Сначала выполните mailnode export, см. «Резервные копии».

Если на сервере другая ОС или не хочется ставить почту прямо в систему, есть установка в Docker.

Следующий шаг — первая настройка.