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

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

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

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

    Импорт
  1. ПPST / OST через утилиту
  2. Для разодвого импортовьтеа файлы:ов 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}} с правилом хранения. Без правила письмо может быть принято, но не сохранено в архиве.

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

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

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

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

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

    ПараметрНазначениеПо умолчанию
    --smtp-hostадрес узла Клавдияlocalhost
    --smtp-portпорт приёмника SMTP25
    --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 установленной версии. Загрузка выполняется напрямую.

  3. Импорт идёт сессиями:

    через API:
      1. begin — открыть сессию импорта;
      2. upload — загрузить файлы (можно несколько);
      3. commit — завершить сессию, создаётся задача импорта.
  • Состояние импорта отслеживается в очереди задач (задача «Импорт файлов») по идентификатору, полученному при commit. См. {{ССЫЛКА:maintenance.tasks|Обслуживание → Задачи}}.

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

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

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

    Что дальше

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