Импорт PST / OST / EML / MSG
Перед началом
Импорт файлов позволяет загружать письма из файлов .pst (Outlook), .ost, .eml, .msg. Подходит для разового импорта архивов почты, снятых с отсутствующих ящиков.
Импорт PST / OST через утилиту
Для разового импорта файлов Microsoft Outlook (.pst, .ost) применяется утилита klvd-pff-import. Она читает файл напрямую и передаёт письма в архив через приёмник SMTP Клавдия. Не требует установленного Outlook или Windows — работает на Linux.
-
Поместите исполняемый файл
klvd-pff-importна машину с доступом к PST/OST-файлам и узлу Клавдия. -
Проверьте SMTP-службу, сетевой доступ к её порту и источник SMTP с правилом хранения. Без правила письмо может быть принято, но не сохранено в архиве.
-
Запустите утилиту:
klvd-pff-import archive.pst \ --smtp-host <адрес-узла> --smtp-port <порт> \ --smtp-rcpt <ящик-архива> --jsonl report.jsonl -
Письма передаются через SMTP. Отправители из
From:получают письма в папку «Отправленные»; адреса изTo:иCc:также используются для распределения по ящикам.--smtp-rcptзадаёт получателя SMTP-конверта и не заменяет все адреса внутри письма. -
Прогресс и аудит пишутся в файл
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 сама по себе не подтверждает применение правила хранения. Если письмо есть в архиве, но не находится полнотекстовым поиском, проверьте очередь индексирования.
Импорт через HTTP-API
Для программной загрузки EML, полученных в том числе после конвертации PST/OST/MSG, используется действующий HTTP-API /api/archive/ingest. Это отдельный способ загрузки, а не обязательный этап работы SMTP-утилиты.
Перед началом настройте доступ к API и проверьте формат файлов и манифеста в Swagger установленной версии. Загрузка выполняется сессиями:
-
begin— открыть сессию импорта; -
upload— загрузить файлы (можно несколько); -
commit— завершить сессию, создаётся задача импорта.
Состояние импорта отслеживается в очереди задач (задача «Импорт файлов») по идентификатору, полученному при commit. См. Обслуживание → Задачи.
Импорт файлов доступен администратору. Письма импортируются по тем же правилам хранения, что и собранные из потока.
Сопутствующие форматы
- EML — отправляется в архив напрямую любым SMTP-клиентом (см. Приём потока через SMTP) или через HTTP-API.
- MSG — конвертируется в EML конвертационными скриптами (поставляются отдельно), далее через SMTP или HTTP-API.
- База восстановления Exchange (RDB) — письма из базы, подключённой на сервере Exchange 2013/2016/2019 из резервной копии, выгружаются утилитой (поставляется отдельно) в EML и загружаются через SMTP, см. Импорт писем из базы восстановления Microsoft Exchange (RDB).
Что дальше
Навигация по книге
- Следующая статья: Запуск, остановка и расписание сбора