Перейти к основному содержимому

Электронная почта

Получение списка почтовых доменов​

Команда

mogwai emails domains list

Пример вывода

ID      NAME            FALLBACK        DKIM    ENABLED OWNER_ID        OWNER           CREATE_AT
1       example.com                     true    true    1               example_com_usr 2024-01-04 15:46:02+03:00

Домены IDs используются в других командах.

Добавление почтового домена​

Команда

mogwai emails domains create

Параметры

  • --domain=DOMAIN : Имя почтового домена.
  • -o, --owner="fastuser" : Пользователь FASTPANEL, которому будет добавлен почтовый домен.

Пример создания почтового домена example1.com для пользователя fastuser

mogwai emails domains create --domain=example1.com -o fastuser

Получение списка почтовых ящиков​

Команда

mogwai emails boxes list

Параметры

  • --domain=DOMAIN : Имя почтового домена

Пример команды

mogwai emails boxes list --domain example.com

Пример вывода

ID      ADDRESS                 ALIASES REDIRECTS       SIZE    QUOTA   ENABLED OWNER_ID        OWNER           CREATE_AT
1       user@example.com                                0       0       true    4               example_com_usr 2024-02-08 11:13:01+03:00

ID из вывода команды используется в других командах.

Создание почтового ящика​

Команда

mogwai emails boxes create

Параметры

  • --domain=DOMAIN : Имя почтового домена.
  • -l, --login=LOGIN : Имя почтового ящика без домена.
  • -p, --password=PASSWORD : Пароль для почтового ящика.

Пример команды

mogwai emails boxes create  --domain=example.com --login=user --password=MySecretPassword123

Эта команда создаст почтовый ящик с именем user@example.com и паролем MySecretPassword123.

Удаление почтового ящика​

Команда

mogwai emails boxes delete

Параметры

  • -b, --box=BOX : ID почтового ящика..

Пример команды

mogwai emails boxes delete -b 1

Эта команда удалит почтовый ящик с ID 1.

Импорт почтовых ящиков и писем​

Команда

mogwai emails boxes import[sync] [<flags>]

Параметры

  • -i, --import_config=IMPORT_CONFIG : Путь к файлу со списком для импорта
  • --force : Только для режима import — очистить существующие почтовые ящики.

Чтобы импортировать почту, необходимо подготовить список почтовых ящиков на сервере в формате:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Параметры

  • IMAP_HOST : Адрес IMAP-сервера почты.
  • SOURCE_ADDR : Почтовый ящик на исходном сервере.
  • SOURCE_PASSWORD : Пароль для IMAP-подключения к почтовому ящику на исходном сервере. Некоторые сервисы, такие как Google, требуют создания пароля приложения для доступа по IMAP https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : Почтовый ящик на сервере FASTPANEL, в который переносятся сообщения.

Пример содержимого файла

imap.gmail.com;test@gmail.comu;password;test@example.com
imap.gmail.com;test1@gmail.com;password;test1@example.com

Доступны два режима:

Режим импорта

mogwai emails boxes import

В этом режиме все сообщения копируются полностью, почтовые ящики на сервере FASTPANEL не должны быть созданы или должны быть пустыми — при выполнении команды FASTPANEL создаёт необходимые почтовые ящики. Если почтовые ящики с содержимым уже существуют, будет показана ошибка. Вы можете использовать флаг --force — тогда почтовый ящик будет очищен.

Пример запуска команды со списком почтовых ящиков, сохранённым в файле /root/import.txt, и с использованием ключа --force

mogwai emails boxes import --import_config=/root/import.txt --force

Режим синхронизации

mogwai emails boxes sync

В этом режиме Панель управления загружает сообщения с исходного сервера, ничего не удаляя. Его следует использовать, если после первого импорта в исходном почтовом ящике появились новые сообщения, которые также необходимо перенести.

Пример команды

mogwai emails boxes sync --import_config=/root/import.txt