Импорт PST / OST / EML / MSG
Перед началом
Импорт файлов позволяет загружать письма из файлов .pst (Outlook), .ost, .eml, .msg через HTTP-API.. Подходит для разового импорта архивов почты, снятых с отсутствующих ящиков.
П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:также используются для распределения по ящикам.msg--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 настроено правило хранения — без него письма принимаются, но не помещаются в
архив.emlОграничения
- Внутренняя почта Exchange. Если в письме нет SMTP-адреса отправителя (внутренняя почта без интернет-заголовков), для него создаётся технический ящик. Реальный адрес извлекается из заголовков письма, если они присутствуют.
- Защищённое соединение. Утилита не поддерживает TLS напрямую. Для передачи по защищённому каналу используйте почтовый релей (например, Postfix) перед Клавдием.
- Крупные вложения. Вложения загружаются в память целиком перед отправкой; при очень больших вложениях обеспечьте достаточный объём памяти.
Проверьте результат
Проверьте отчёт утилиты, затем откройте несколько импортированных писем в архиве и проверьте тело и вложения. Успешная отправка по SMTP сама по себе не подтверждает применение правила хранения. Если письмо есть в архиве, но не находится полнотекстовым поиском, проверьте {{ССЫЛКА:maintenance.search-health|очередь индексирования}}.
Импорт через HTTP-API
Для программной загрузки EML, полученных в том числе после конвертаци
онными PST/OST/MSG, искриптами (поставляюьзуется действующий HTTP-API/api/archive/ingest. Это отдельный спо);соб загру.emlжзки, а не обязательный этап работы SMTP-утилиты.Перед началом настройте {{ССЫЛКА:install.api-access|доступ к API}} и проверьте формат файлов и манифеста в Swagger установленной версии. Загрузка выполняется
напрямую.-
Импорт идётсессиями:через API:-
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|Запуск, остановка и расписание сбора
}}