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

Импорт PST / OST / EML / MSG

Перед началом

Импорт файлов позволяет загружать письма из файлов .pst (Outlook), .ost, .eml, .msg. Подходит для разового импорта архивов почты, снятых с отсутствующих ящиков.

Импорт PST / OST через утилиту

Для разового импорта файлов Microsoft Outlook (.pst, .ost) применяется утилита klvd-pff-import. Она читает файл напрямую и передаёт письма в архив через приёмник SMTP Клавдия. Не требует установленного Outlook или Windows — работает на Linux.

  1. Поместите исполняемый файл klvd-pff-import на машину с доступом к PST/OST-файлам и узлу Клавдия.

  2. Проверьте {{ССЫЛКА:install.smtp-service|SMTP-службу}}, сетевой доступ к её порту и {{ССЫЛКА:install.source-smtp|источник SMTP}}SMTP с правилом хранения. Без правила письмо может быть принято, но не сохранено в архиве.

  3. Запустите утилиту:

    klvd-pff-import archive.pst \
      --smtp-host <адрес-узла> --smtp-port <порт> \
      --smtp-rcpt <ящик-архива> --jsonl report.jsonl
    
  4. Письма передаются через SMTP. Отправители из From: получают письма в папку «Отправленные»; адреса из To: и Cc: также используются для распределения по ящикам. --smtp-rcpt задаёт получателя SMTP-конверта и не заменяет все адреса внутри письма.

  5. Прогресс и аудит пишутся в файл report.jsonl (обязательный параметр). Каждое письмо получает заголовок происхождения, позволяющий отличить файловый импорт от обычного потока SMTP.

{{СКРИНШОТ}}

Параметры утилиты

Параметр Назначение По умолчанию
--smtp-host адрес узла Клавдия localhost
--smtp-port порт приёмника SMTP 25
--smtp-from адрес отправителя в конверте из письма
--smtp-rcpt адрес получателя (ящик-архив); можно указать несколько — (обязательный)
--jsonl файл отчёта и прогресса — (обязательный)
--resume прочитать прошлый отчёт и пропустить уже отправленные письма —
--folder-filter отправить только письма из папок, содержащих подстроку —
--date-from отправить только письма начиная с даты (ГГГГ-ММ-ДД) —
--date-to отправить только письма до даты (ГГГГ-ММ-ДД) —
--extract дополнительно выгрузить вложения в каталог —

Возобновление импорта

При сбое или прерывании импорт можно перезапустить — уже отправленные письма будут пропущены:

klvd-pff-import archive.pst \
  --smtp-host <адрес-узла> --smtp-port <порт> \
  --smtp-rcpt <ящик-архива> \
  --jsonl report.jsonl --resume report.jsonl

Дубликаты также отбрасываются самим архивом по идентификатору сообщения, поэтому повторная отправка не приводит к задвоению.

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

Ограничения

  • Внутренняя почта Exchange. Если в письме нет SMTP-адреса отправителя (внутренняя почта без интернет-заголовков), для него создаётся технический ящик. Реальный адрес извлекается из заголовков письма, если они присутствуют.
  • Защищённое соединение. Утилита не поддерживает TLS напрямую. Для передачи по защищённому каналу используйте почтовый релей (например, Postfix) перед Клавдием.
  • Крупные вложения. Вложения загружаются в память целиком перед отправкой; при очень больших вложениях обеспечьте достаточный объём памяти.

Проверьте результат

Проверьте отчёт утилиты, затем откройте несколько импортированных писем в архиве и проверьте тело и вложения. Успешная отправка по SMTP сама по себе не подтверждает применение правила хранения. Если письмо есть в архиве, но не находится полнотекстовым поиском, проверьте {{ССЫЛКА:maintenance.search-health|очередь индексирования}}.

Импорт через HTTP-API

Для программной загрузки EML, полученных в том числе после конвертации PST/OST/MSG, используется действующий HTTP-API /api/archive/ingest. Это отдельный способ загрузки, а не обязательный этап работы SMTP-утилиты.

Перед началом настройте {{ССЫЛКА:install.api-access|доступ к API}}API и проверьте формат файлов и манифеста в Swagger установленной версии. Загрузка выполняется сессиями:

  1. begin — открыть сессию импорта;
  2. upload — загрузить файлы (можно несколько);
  3. commit — завершить сессию, создаётся задача импорта.

Состояние импорта отслеживается в очереди задач (задача «Импорт файлов») по идентификатору, полученному при commit. См. {{ССЫЛКА:maintenance.tasks|Обслуживание → Задачи}}.

Импорт файлов доступен администратору. Письма импортируются по тем же правилам хранения, что и собранные из потока.

Сопутствующие форматы

  • EML — отправляется в архив напрямую любым SMTP-клиентом (см. {{ССЫЛКА:install.source-smtp|Приём потока через SMTP}}SMTP) или через HTTP-API.
  • MSG — конвертируется в EML конвертационными скриптами (поставляются отдельно), далее через SMTP или HTTP-API.
  • Восстановление из баз Exchange (EDB/RDB) — для извлечения писем из повреждённых баз Microsoft Exchange применяется отдельная утилита (поставляется отдельно). Обратитесь к поставщику.

Что дальше

Навигация по книге