Gotenberg

Gotenberg — это Docker-образ с API для конвертации веб-страниц и офисных документов в PDF, а также для постобработки, подписания и доставки готовых файлов. Он объединяет Chromium и LibreOffice, поддерживает 29 операций над PDF и умеет валидировать документы по стандартам PDF/A, PDF/UA и Factur-X. Продукт распространяется под лицензией MIT, но встроенный PDF-процессор litho использует AGPL-3.0, что важно учитывать при модификации кода.

Gotenberg — это Docker-образ с API для конвертации веб-страниц и офисных документов в PDF, а также для постобработки, подписания и доставки готовых файлов. Он объединяет Chromium и LibreOffice, поддерживает 29 операций над PDF и умеет валидировать документы по стандартам PDF/A, PDF/UA и Factur-X. Продукт распространяется под лицензией MIT, но встроенный PDF-процессор litho использует AGPL-3.0, что важно учитывать при модификации кода.

Gotenberg — это контейнеризированный API для работы с PDF, который запускается одной командой Docker. Он принимает файлы или URL через HTTP, преобразует их в PDF с помощью Chromium или LibreOffice, а затем может выполнить цепочку операций: объединение, разделение, наложение штампов, подписание, шифрование, валидацию и многое другое. Все этапы выполняются в рамках одного запроса.

Как это работает

Вы запускаете контейнер, отправляете POST-запрос с исходными данными и получаете готовый PDF. API поддерживает загрузку файлов, указание URL и передачу параметров обработки в виде массива stages.

Конвертация в PDF

  • Chromium преобразует веб-страницы (по URL), HTML и Markdown.
  • LibreOffice конвертирует документы Word, Excel, PowerPoint и более ста других форматов.

Обработка PDF

После конвертации или для существующего PDF можно применить до 29 стадий: merge, split, stamp, sign, encrypt, redact, optimize, set-metadata и другие. Стадии выполняются последовательно, что позволяет собирать сложные сценарии.

Валидация и исправление

Gotenberg проверяет PDF на соответствие стандартам PDF/A (все части и уровни), PDF/UA-1, UA-2, WTPDF 1.0, Factur-X и ZUGFeRD. Отчёт содержит пункт спецификации, номер теста, описание нарушения и его серьёзность. Функция remediate пытается автоматически исправить найденные проблемы.

Электронные счета

Поддерживается создание гибридных счетов Factur-X, ZUGFeRD и XRechnung: XML-вложения встраиваются в PDF/A-3, а метаданные корректно прописываются.

Доставка результатов

Результат можно вернуть в ответе или загрузить напрямую в облачное хранилище (например, S3) через вебхуки. Gotenberg может сам забрать исходный файл по предподписанному URL и уведомить вашу систему о завершении через events-URL.

Варианты образов

Доступно девять образов под разные архитектуры и сценарии: полный (Chromium + LibreOffice), облегчённые (только один из движков), а также специализированные для AWS Lambda и Cloud Run.

Ограничения

  • Для работы необходим Docker. Образ полной версии имеет значительный размер.
  • Встроенный PDF-процессор litho распространяется под лицензией AGPL-3.0, что может потребовать раскрытия исходного кода при модификации и распространении, несмотря на MIT-лицензию самого Gotenberg.
  • Высоконагруженные сценарии требуют настройки ресурсов и мониторинга.

Для кого

Gotenberg полезен разработчикам, которым нужна автоматическая генерация, обработка и доставка PDF в микросервисной архитектуре, системах электронного документооборота, платформах для выставления счетов и архивирования.