Распространенные проблемы
Ниже приведен список распространенных проблем и возможных решений:
Почта зацикливается на самого себя¶
Пожалуйста, проверьте в интерфейсе animails, не настроен ли домен как backup MX:
Я могу получать, но не могу отправлять письма¶
Существует множество причин, которые могут препятствовать отправке почты:
- Проверьте, не находится ли ваш IP-адрес в черных списках. Вы можете использовать dnsbl.info или любой другой аналогичный сервис для проверки вашего IP-адреса.
- Некоторые домашние роутеры интернет-провайдеров блокируют почтовые порты для доменов, не входящих в белый список. Пожалуйста, проверьте, доступен ли ваш сервер по портам
465или587:
# telnet 74.125.133.27 465
Trying 74.125.133.27...
Connected to 74.125.133.27.
Escape character is '^]'.
Мои письма помечаются как спам¶
Пожалуйста, ознакомьтесь с нашим руководством по настройке DNS.
docker compose выдает странные ошибки¶
... такие как:
ERROR: Invalid interpolation format ...AttributeError: 'NoneType' object has no attribute 'keys'.ERROR: In file './docker-compose.yml' service 'version' doesn't have any configuration options.
Если вы столкнулись с одним из этих или подобными сообщениями при попытке запуска animails, пожалуйста, убедитесь, что у вас установлены последние версии Docker и docker compose.
Контейнер XY имеет статус unhealthy¶
Эта ошибка сообщает о том, что одно из условий (проверки состояния) для определенного контейнера не выполнено. Из-за этого он не может быть запущен. Это может происходить по нескольким причинам, наиболее распространенная из которых — обновленный git-репозиторий при старом образе docker или наоборот.
Неправильно настроенный брандмауэр также может вызвать такой сбой. Контейнеры должны иметь возможность взаимодействовать друг с другом через сеть 172.22.1.1/24.
Причиной также может быть неверно привязанный файл (например, SSL-сертификат), который препятствует запуску критически важного контейнера (nginx), поэтому всегда проверяйте логи, чтобы понять источник проблемы.
Адрес уже используется (Address already in use)¶
Если вы получаете сообщение об ошибке вида:
ERROR: for postfix-animails Cannot start service postfix-animails: driver failed programming external connectivity on endpoint animailsdockerized_postfix-animails_1: Error starting userland proxy: listen tcp 0.0.0.0:25: bind: address already in use
XYZ не может подключиться к ...¶
Пожалуйста, проверьте ваш локальный брандмауэр! Docker и брандмауэры на базе iptables иногда создают конфликтующие правила, поэтому отключите брандмауэр на хосте, чтобы определить, вызваны ли проблемы с подключением такими конфликтами. Если это так, вам необходимо вручную создать соответствующие правила в брандмауэре хоста, чтобы разрешить необходимые соединения.
Если вы испытываете проблемы с подключением из дома, пожалуйста, проверьте также брандмауэр роутера вашего провайдера, некоторые из них блокируют почтовый трафик на портах SMTP (587) или SMTPS (465). Также возможно, что ваш провайдер блокирует порты для SUBMISSION (25).
В то время как пользователи Linux могут выбирать из множества инструментов1 для проверки открытости порта, пользователям Windows по умолчанию доступна только команда PowerShell Test-NetConnection -ComputerName host -Port port.
Чтобы включить telnet в Windows версий после Vista, воспользуйтесь этим руководством или введите следующую команду в терминале с правами администратора:
dism /online /Enable-Feature /FeatureName:TelnetClient
Превышен лимит экземпляров Inotify для пользователя 5000 (UID vmail) (см. #453)¶
Контейнеры Docker используют лимиты inotify хоста Docker. Настройка их на хосте Docker применит их и к контейнеру.
Dovecot постоянно перезапускается (см. #2672)¶
Проверьте наличие как минимум следующих файлов в data/assets/ssl:
cert.pem
dhparams.pem
key.pem
Если файл dhparams.pem отсутствует, вы можете создать его с помощью команды:
openssl dhparam -out data/assets/ssl/dhparams.pem 4096
Rspamd сообщает: cannot open hyperscan cache file /var/lib/rspamd/{...}.hs: compiled for a different platform¶
При миграции animails на другую систему (обычно с другим процессором) Rspamd может сообщать, что не может загрузить некоторые (или все) файлы .hs, так как они были скомпилированы для другой платформы (процессора).
Это связано с Hyperscan2, технологией Intel для предварительной компиляции регулярных выражений, которую использует Rspamd.
Эта функция обеспечивает значительный прирост производительности и поэтому глубоко интегрирована в Rspamd.
Чтобы исправить эту ошибку, необходимо удалить все файлы .hs и .hsmp из директории rspamd:
cd MAILCOW_ROOT # Обычно /opt/animails
docker compose exec rspamd-animails bash
rm -rf /var/lib/rspamd/*.hs
rm -rf /var/lib/rspamd/*.hsmp
cd MAILCOW_ROOT # Обычно /opt/animails
docker-compose exec rspamd-animails bash
rm -rf /var/lib/rspamd/*.hs
rm -rf /var/lib/rspamd/*.hsmp
После этого перезапустите Rspamd:
docker compose restart rspamd-animails
docker-compose restart rspamd-animails
Теперь Rspamd заново скомпилирует указанные карты регулярных выражений с помощью Hyperscan.