Архивная версия статьи — версия продукта v2.14.3, проверена 10 сентября 2026 г.. Инструкции могли устареть.Актуальная статья →
Работа с документами

Stirling-PDF

Stirling-PDF - веб-набор из 50+ операций над PDF (объединить, сжать, конвертировать, OCR, подписать, отредактировать текст) на своем сервере. Файлы обрабатываются локально и не уходят в чужое облако. Подняли релиз v2.14.3 в одном Docker-контейнере за Caddy, сняли реальные цифры по памяти, диску и первому входу.

Сентябрь 2026 ~8 минут чтения Fatmetal Team
PDF-инструменты · Self-hosted Лицензия: MIT Статус: запущен у нас, v2.14.3

Вердикт

Подходит
  • кому нужен приватный набор PDF-операций без загрузки файлов в чужое облако
  • командам с потоком PDF: объединить, сжать, OCR, подписать
Не подходит
  • кому раз в месяц сжать один файл - проще онлайн-сервис
  • кому нужен бесплатный многопользовательский режим с ролями
Мин. тариф: CPU2-RAM4-DISK50 Рекомендуем: CPU2-RAM4-DISK50 Сложность: easy Образ: 3.38 GB Главный риск: принудительная смена пароля на первом входе, многопользовательский режим платный Прод-готовность: с оговорками (прокси + TLS + смена дефолтного пароля)

Проверено на версии v2.14.3, сентябрь 2026. На новых версиях результаты могут отличаться.

Что это

Что такое Stirling-PDF и какую задачу решает

Stirling-PDF - это веб-приложение с открытым кодом, которое собирает под одной крышей операции над PDF, ради которых обычно идут на разрозненные онлайн-сервисы: объединение и разбивку, сжатие, конвертацию в другие форматы и обратно, распознавание текста (OCR), наложение водяных знаков и штампов, электронную подпись, редактирование метаданных и текста. Всего в интерфейсе больше 50 инструментов, разложенных по категориям.

Ключевая причина ставить его у себя - приватность. Файлы обрабатываются на вашем сервере, а не отправляются в облако стороннего сервиса. Это закрывает типовой сценарий, когда договоры, сканы паспортов или внутренние документы нельзя загружать на публичный сайт. Вторая версия продукта переписана: новый интерфейс, встроенный вход с ролями и флагманский инструмент редактирования текста прямо в PDF (пока в статусе ALPHA).

JavaSpring BootSpring SecurityH2 (встроенная БД)DockerCaddy
Сравнение

Чем отличается от Adobe Acrobat и онлайн-сервисов

Сравниваем по тому, что влияет на выбор приватного PDF-тулкита: где обрабатываются файлы, цена и контроль. У платных сервисов шире готовая экосистема и мобильные приложения - это отмечаем в разделе про ограничения.

ПараметрStirling-PDF (self-hosted)Acrobat / iLovePDF / Smallpdf
Модель ценыБесплатно (single-user), платите только за инфраструктуру VMПодписка в месяц, лимиты на объем и число файлов
Где обрабатываются файлыНа вашем сервере, наружу не уходятЗагружаются на сервер вендора
Набор операций50+ инструментов в одном интерфейсеШирокий, часть за старший тариф
Доступ к исходному кодуДа, MITНет
Многопользовательский режимПлатный (free = один пользователь)Есть на командных тарифах
ОбслуживаниеНа вас: обновления, бэкапы, TLSНа вендоре
Под капотом

Тех-стек и архитектура

Stirling-PDF написан на Java и Spring Boot и раскладывается в один Docker-контейнер - это его главное отличие от многоконтейнерных стеков вроде CRM или BaaS. Внешняя база данных не нужна: настройки и пользователи хранятся во встроенной H2, поэтому для запуска достаточно поднять единственный образ. Приложение слушает порт 8080 внутри контейнера.

Образ публикуется на Docker Hub под именем stirlingtools/stirling-pdf (раньше был frooodle/s-pdf). Есть три ветки тегов: latest - полный набор, latest-ultra-lite - урезанный без тяжелых зависимостей, и latest-fat - со всеми опциональными пакетами. Для повторяемости мы закрепляли пиновый тег версии, а не плавающий latest.

Конфигурация

Минимальная конфигурация

Один Java-контейнер в простое держит около гигабайта памяти. Тяжелые операции (OCR, сжатие) добавляют нагрузку на CPU, поэтому запас по процессору важнее, чем по памяти.

RAM в простое (Stirling)~1022 MiB
RAM в простое (Caddy)~13 MiB
Образ на диске3.38 GB
Рекомендуем тарифCPU2-RAM4-DISK50
Тестовый тарифCPU2-RAM4-DISK40
i

Почему не гонимся за RAM. Сам сервис в простое умещается в гигабайт, и CPU2-RAM4-DISK50 берет его с запасом. Узкое место - не память, а процессор на тяжелых задачах: OCR и сжатие грузят CPU, и на 2 vCPU большой скан обрабатывается ощутимо дольше. Крупный образ (3.38 GB) требует диска и терпения на первый pull.

В маркетплейсе Fatmetal

Не хотите ставить руками?

Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий домен, валидный TLS и файл с доступами.

Рекомендуемая конфигурация: CPU2-RAM4-DISK50

В маркетплейс →
Развертывание

Развертывание на Fatmetal через Docker

Базовый путь - Cloud Server с Ubuntu 24.04 и приложением Docker из маркетплейса, доступ наружу через Caddy с валидным TLS. Приложение слушает 8080 внутри контейнера, наружу торчит только Caddy.

  1. Создать VM

    Cloud Server, тариф CPU2-RAM4-DISK50, ОС Ubuntu 24.04 LTS, приложение Docker из маркетплейса. Docker ставится через cloud-init при первом запуске.

  2. Поднять контейнер

    docker run -d --name stirling \
      -p 127.0.0.1:8080:8080 \
      -v stirling-data:/configs \
      -e SECURITY_ENABLELOGIN=true \
      stirlingtools/stirling-pdf:2.14.3

    Данные (настройки, пользователи встроенной H2) кладем в именованный том, чтобы они пережили обновление образа.

  3. Поставить Caddy перед приложением

    Caddy сам получит сертификат Let's Encrypt для вашего домена и проксирует запросы на локальный 8080.

    # /etc/caddy/Caddyfile
    ваш-домен {
        reverse_proxy 127.0.0.1:8080
    }
  4. Проверить

    curl -s https://ваш-домен/api/v1/info/status
    # ожидаем {"version":"2.14.3","status":"UP"}

    Первый заход в интерфейс потребует входа: дефолтные admin / stirling, и Stirling сразу заставит сменить пароль (см. раздел про подводные камни).

https://ваш-домен/
Stirling-PDF - главный экран с категориями инструментов на развернутом инстансе
Реальный экземпляр Stirling-PDF v2.14.3 на Fatmetal Cloud Server: дашборд с категориями инструментов.
https://ваш-домен/merge-pdfs
Stirling-PDF - инструмент объединения PDF-файлов
Инструмент Merge на том же инстансе: перетаскивание нескольких PDF и сборка в один файл.
Замеры

Что измерили после запуска

Цифры с тестового CPU2-RAM4-DISK40, Ubuntu 24.04, доступ через Caddy с TLS. Состояние - свежая установка, без нагрузки.

RAM в простое - Stirling~1022 MiB
RAM в простое - Caddy~13 MiB
CPU в простое~0.3%
Образ на диске3.38 GB
Проверка статуса/api/v1/info/status - version 2.14.3, status UP
i

Главное по ресурсам. В простое стек скромный: чуть больше гигабайта памяти и почти нулевой CPU. Реальную нагрузку создают сами операции - OCR и сжатие крупных файлов, а не фон. Планируйте по процессору под пиковые задачи, а не по памяти в покое.

Проверено на версии v2.14.3, сентябрь 2026. На новых версиях результаты могут отличаться.

Подводные камни

Где может сломаться

Реальные особенности второй версии, на которые наткнулись при первом запуске.

!

Принудительная смена пароля на первом входе. В v2 включен встроенный вход (Spring Security), дефолт - admin / stirling. При первом заходе Stirling не пустит дальше, пока не смените пароль (минимум 8 символов). Плюс подряд идут три модалки онбординга: opt-in аналитика, обязательная смена пароля и приветственный экран V2. Клиент это увидит - предупредите заранее.

!

Многопользовательский режим - платный. Бесплатно доступен режим одного пользователя. Командный доступ с несколькими учетными записями - платная функция (для ранее заведенных аккаунтов действует grandfathering до 5 пользователей). Если нужна раздача доступа по ролям без оплаты - это ограничение.

!

OCR и сжатие грузят процессор. Тяжелые операции упираются в CPU. На 2 vCPU распознавание текста в большом документе или сильное сжатие идут небыстро. Для потока таких задач берите больше ядер, а не памяти.

!

Крупный образ и долгий первый pull. Полный образ весит 3.38 GB, первое скачивание занимает заметное время и место на диске. Если тяжелые форматы не нужны, есть тег latest-ultra-lite полегче.

HTTP 401 при заходе на корень домена

Причина. В v2 встроенный вход включен по умолчанию, и без авторизации приложение отдает 401 - это не ошибка прокси, в Caddy никакой basic-auth нет.

Решение. Откройте интерфейс в браузере и войдите под admin / stirling, затем сразу смените пароль. Отключать вход целиком (SECURITY_ENABLELOGIN=false) на публичном адресе не стоит.

Безопасность

Безопасность и обновления

Главный плюс по безопасности встроен в саму модель: файлы обрабатываются на вашем сервере и не уходят в чужое облако. На публичном адресе оставляйте включенным встроенный вход (SECURITY_ENABLELOGIN=true) и обязательно смените дефолтный пароль admin / stirling при первом заходе. Наружу выставляйте только Caddy с TLS, а сам контейнер держите на локальном порту.

Релизы и исправления отслеживайте в репозитории (watch на releases). Обновление - смена тега образа и пересоздание контейнера с тем же томом данных:

docker pull stirlingtools/stirling-pdf:НОВАЯ_ВЕРСИЯ
docker rm -f stirling
docker run -d --name stirling -p 127.0.0.1:8080:8080 \
  -v stirling-data:/configs \
  -e SECURITY_ENABLELOGIN=true \
  stirlingtools/stirling-pdf:НОВАЯ_ВЕРСИЯ

Бэкап сводится к сохранению тома с настройками и встроенной базой:

docker run --rm -v stirling-data:/data -v $(pwd):/backup \
  alpine tar czf /backup/stirling-backup.tar.gz -C /data .
Рядом

Связь с другими стеками

Что обычно ставят рядом со Stirling-PDF в рабочем контуре.

  • Обратный прокси с TLS - Caddy или Nginx Proxy Manager, чтобы наружу торчал только защищенный домен, а контейнер слушал локальный порт.
  • Бэкапы - архив тома с настройками и встроенной H2 по cron с выгрузкой в S3-совместимое хранилище.
  • Мониторинг - Uptime Kuma по эндпоинту /api/v1/info/status, чтобы ловить падения сервиса.
  • Хранилище документов - Nextcloud или Paperless рядом, когда PDF нужно не только обрабатывать, но и хранить с поиском.
Ограничения

Когда это НЕ ваш выбор

Разовая правка одного файла

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

Нужен бесплатный командный доступ с ролями

Многопользовательский режим - платная функция. Если критично раздать доступ нескольким сотрудникам с ролями и не платить, это ограничение продукта, а не настройки.

Высоконагруженный конвейер OCR

Один Java-контейнер и упор в CPU на тяжелых операциях делают Stirling-PDF слабым выбором под массовое распознавание сотен документов в час. Для такого нужен горизонтально масштабируемый специализированный конвейер.

FAQ

Частые вопросы

Файлы уходят в облако?

Нет. Все операции идут на вашем сервере, документы не отправляются наружу - это и есть смысл self-hosted варианта.

Хватит ли 4 GB RAM?

Да, в простое сервис держит около 1 GB. Узкое место - не память, а CPU на OCR и сжатии.

Нужна ли отдельная база данных?

Нет. Настройки и пользователи хранятся во встроенной H2, внешний PostgreSQL не требуется.

Почему корень отдает 401?

В v2 включен встроенный вход. Войдите под admin / stirling и сразу смените пароль.

Многопользовательский режим бесплатный?

Нет. Бесплатен режим одного пользователя, командный доступ - платный (grandfathering до 5 учеток для ранее заведенных).

Как обновлять?

Сменить тег образа, пересоздать контейнер с тем же томом данных.

Какие ограничения лицензии?

Код под MIT. Платная только функция многопользовательского режима.

Итог

Stirling-PDF v2.14.3 поднимается на Fatmetal Cloud Server одним Docker-контейнером за Caddy: в простое это ~1 GB RAM и почти нулевой CPU, образ на диске - 3.38 GB. Внешняя БД не нужна, приватность встроена в модель - файлы не уходят с сервера. Берем CPU2-RAM4-DISK50 с запасом по процессору под OCR и сжатие. Главное, о чем предупредить клиента: в v2 первый вход принудительно требует сменить пароль, а многопользовательский режим платный. Для приватного набора PDF-операций с постоянным потоком документов - рабочий выбор.

Анонсы новых разборов в Telegram-канале Новые гайды и карточки в маркетплейсе первыми @fatmetal_channel →

Этот стек у нас запущен на тарифе CPU2-RAM4-DISK40. Если найдете баг в гайде - напишите, поправим в течение дня.