Установка Stirling PDF на свой сервер: термины и чек-лист

Подробности, цифры, термины и чек-лист по теме «Установка Stirling PDF на свой сервер». Страница справочника целиком: Stirling PDF установка.

Коротко о теме

Stirling PDF установка в Docker: образ stirlingtools/stirling-pdf, теги latest и ultra-lite, от 2 ГБ памяти, смена пароля admin, HTTPS и OCR на русском.

Подробности по разделам

Что такое Stirling PDF и зачем свой сервер для работы с PDF

Для договоров, паспортов клиентов и счетов это лишний риск, а на своём сервере документ не уходит дальше машины, которой вы управляете. Если нужно только изредка склеить два файла, достаточно обычной программы на компьютере.

Какой образ Stirling PDF выбрать: latest, latest-fat или ultra-lite

В продакшене вместо latest укажите номер версии из документации, чтобы обновление не происходило само. Выберите образ и нагрузку, калькулятор подскажет конфигурацию

Пароль admin, вход и HTTPS в Stirling PDF

Вход можно выключить: переменная SECURITY_ENABLELOGIN=false или параметр security.enableLogin: false в settings.yml. Образ ultra-lite работает без входа и настроек администратора, поэтому его закрывают на уровне прокси. Короткий путь: Caddy с блоком basic_auth перед портом 8080, он же выпустит сертификат.

Распознавание русского текста в Stirling PDF: языки и tessdata

Если распознавание нужно массово, учтите память: OCR на длинных сканах занимает много процессорного времени. Добавьте ядра по калькулятору и ограничьте число одновременных задач в настройках администратора.

Документы с персональными данными в Stirling PDF и обновления

Обновление такое: поменять номер версии в образе, затем docker compose pull и docker compose up -d. Копируйте каталог stirling-data/configs: в нём настройки и учётные записи. Сами документы на сервере не хранят дольше, чем нужно, а схему копий описывает страница про бэкапы.

Ключевые цифры

Термины на странице

152-ФЗ
152-ФЗ это закон о персональных данных. Вместе с требованием локализации он обязывает хранить базы с данными россиян на серверах в России.
SSH
SSH это защищённое подключение к серверу через командную строку. Вход по ключу безопаснее, чем по паролю.
Self-hosted
Self-hosted значит, что программа работает на вашем сервере, а данные остаются у вас.
Docker
Docker запускает программы в контейнерах: всё нужное для работы упаковано в образ.
HTTPS
HTTPS это защищённая версия HTTP: данные между браузером и сайтом шифруются.
VDS
VDS это то же самое, что VPS: виртуальный выделенный сервер. Разницу в названии провайдеры трактуют по-разному.

Что проверить

  1. Выберите конфигурацию по памяти и диску под задачу, процессор обычно вторичен.
  2. Проверьте тип виртуализации: KVM даёт свою систему и гарантированные ресурсы.
  3. Уточните, входит ли IPv4 и сколько стоит трафик сверх пакета.
  4. Храните данные контейнеров в томах.
  5. Закрепляйте версии образов, а не latest.
  6. Ограничьте ресурсы контейнеров, чтобы один не съел весь сервер.

Связанные страницы