Импорт PST / OST / EML / MSG
Перед началом
- {{ССЫЛКА:install.source-choose|Как выбрать способ сбора почты}}
Импорт файлов позволяет загружать письма из файлов .pst (Outlook), .ost, .eml, .msg. Подходит для разового импорта архивов почты, снятых с отсутствующих ящиков.
Импорт PST / OST через утилиту
Для разового импорта файлов Microsoft Outlook (.pst, .ost) применяется утилита klvd-pff-import. Она читает файл напрямую и передаёт письма в архив через приёмник SMTP Клавдия. Не требует установленного Outlook или Windows — работает на Linux.
-
Поместите исполняемый файл
klvd-pff-importна машину с доступом к PST/OST-файлам и узлу Клавдия. -
Проверьте {{ССЫЛКА:install.smtp-service|SMTP-службу}}, сетевой доступ к её порту и {{ССЫЛКА:install.source-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 сама по себе не подтверждает применение правила хранения. Если письмо есть в архиве, но не находится полнотекстовым поиском, проверьте {{ССЫЛКА:maintenance.search-health|очередь индексирования}}.
Импорт через HTTP-API
Для программной загрузки EML, полученных в том числе после конвертации PST/OST/MSG, используется действующий HTTP-API /api/archive/ingest. Это отдельный способ загрузки, а не обязательный этап работы SMTP-утилиты.
Перед началом настройте {{ССЫЛКА:install.api-access|доступ к API}} и проверьте формат файлов и манифеста в Swagger установленной версии. Загрузка выполняется сессиями:
-
begin— открыть сессию импорта; -
upload— загрузить файлы (можно несколько); -
commit— завершить сессию, создаётся задача импорта.
Состояние импорта отслеживается в очереди задач (задача «Импорт файлов») по идентификатору, полученному при commit. См. {{ССЫЛКА:maintenance.tasks|Обслуживание → Задачи}}.
Импорт файлов доступен администратору. Письма импортируются по тем же правилам хранения, что и собранные из потока.
Сопутствующие форматы
- EML — отправляется в архив напрямую любым SMTP-клиентом (см. {{ССЫЛКА:install.source-smtp|Приём потока через SMTP}}) или через HTTP-API.
- MSG — конвертируется в EML конвертационными скриптами (поставляются отдельно), далее через SMTP или HTTP-API.
- Восстановление из баз Exchange (EDB/RDB) — для извлечения писем из повреждённых баз Microsoft Exchange применяется отдельная утилита (поставляется отдельно). Обратитесь к поставщику.
Что дальше
- {{ССЫЛКА:install.source-schedule|Запуск, остановка и расписание сбора}}
Навигация по книге
- Следующая статья: {{ССЫЛКА:install.source-schedule|Запуск, остановка и расписание сбора}}