Stirling PDF

Stirling PDF - это локальный веб-интерфейс для работы с PDF. В этом проекте он используется как отдельный Docker-профиль для ручной проверки и сравнения PDF-файлов в браузере.

Запуск

TaskРучной

task stirling

docker compose --profile stirling up -d stirling_pdf

После запуска интерфейс доступен по адресу http://localhost:8080.

Настройка

Переменные задаются в .env:

Переменная	Назначение
`STIRLING_PORT`	Порт на хосте, по умолчанию `8080`
`STIRLING_ADMIN_PASSWORD`	Стартовый пароль администратора при первом запуске

Пример:

STIRLING_PORT="8080"
STIRLING_ADMIN_PASSWORD="stirling"

Пароль администратора применяется только при первом старте, до появления данных в pdf_diff/stirling/configs. Если контейнер уже запускался, новый пароль через .env сам по себе старую базу не перепишет.

В docker-compose.yaml для профиля stirling также включены:

SECURITY_ENABLELOGIN=true
DISABLE_ADDITIONAL_FEATURES=false
LANGS=en_GB

Сопутствующие команды

task stirling:logs
task stirling:down

Где хранатся данные

Для профиля смонтированы каталоги:

pdf_diff/stirling/configs
pdf_diff/stirling/logs
pdf_diff/stirling/pipeline

Эти каталоги нужны, чтобы настройки и журнал не терялись после пересоздания контейнера.

Когда использовать

Stirling PDF удобно использовать, когда нужно:

открыть готовый PDF в браузере без локального просмотра;
быстро проверить, как документ выглядит после пересборки;
вручную сопоставить две версии PDF в соседних вкладках или окнах браузера;
отдать PDF на просмотр без дополнительной установки инструментов.

Если нужен автоматический diff между двумя коммитами, в проекте для этого уже есть отдельный сценарий task diff.