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 в микросервисной архитектуре, системах электронного документооборота, платформах для выставления счетов и архивирования.

Отзывы
Отзывов пока нет.