Stirling-PDF
Stirling-PDF - веб-набор из 50+ операций над PDF (объединить, сжать, конвертировать, OCR, подписать, отредактировать текст) на своем сервере. Файлы обрабатываются локально и не уходят в чужое облако. Подняли релиз v2.14.3 в одном Docker-контейнере за Caddy, сняли реальные цифры по памяти, диску и первому входу.
Вердикт
- кому нужен приватный набор PDF-операций без загрузки файлов в чужое облако
- командам с потоком PDF: объединить, сжать, OCR, подписать
- кому раз в месяц сжать один файл - проще онлайн-сервис
- кому нужен бесплатный многопользовательский режим с ролями
Проверено на версии v2.14.3, сентябрь 2026. На новых версиях результаты могут отличаться.
Что такое Stirling-PDF и какую задачу решает
Stirling-PDF - это веб-приложение с открытым кодом, которое собирает под одной крышей операции над PDF, ради которых обычно идут на разрозненные онлайн-сервисы: объединение и разбивку, сжатие, конвертацию в другие форматы и обратно, распознавание текста (OCR), наложение водяных знаков и штампов, электронную подпись, редактирование метаданных и текста. Всего в интерфейсе больше 50 инструментов, разложенных по категориям.
Ключевая причина ставить его у себя - приватность. Файлы обрабатываются на вашем сервере, а не отправляются в облако стороннего сервиса. Это закрывает типовой сценарий, когда договоры, сканы паспортов или внутренние документы нельзя загружать на публичный сайт. Вторая версия продукта переписана: новый интерфейс, встроенный вход с ролями и флагманский инструмент редактирования текста прямо в PDF (пока в статусе ALPHA).
Чем отличается от 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 |
Почему не гонимся за 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.
-
Создать VM
Cloud Server, тариф CPU2-RAM4-DISK50, ОС Ubuntu 24.04 LTS, приложение Docker из маркетплейса. Docker ставится через cloud-init при первом запуске.
-
Поднять контейнер
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) кладем в именованный том, чтобы они пережили обновление образа.
-
Поставить Caddy перед приложением
Caddy сам получит сертификат Let's Encrypt для вашего домена и проксирует запросы на локальный 8080.
# /etc/caddy/Caddyfile ваш-домен { reverse_proxy 127.0.0.1:8080 } -
Проверить
curl -s https://ваш-домен/api/v1/info/status # ожидаем {"version":"2.14.3","status":"UP"}Первый заход в интерфейс потребует входа: дефолтные
admin/stirling, и Stirling сразу заставит сменить пароль (см. раздел про подводные камни).
Что измерили после запуска
Цифры с тестового 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 |
Главное по ресурсам. В простое стек скромный: чуть больше гигабайта памяти и почти нулевой 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 полегче.
Причина. В 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 слабым выбором под массовое распознавание сотен документов в час. Для такого нужен горизонтально масштабируемый специализированный конвейер.
Частые вопросы
Файлы уходят в облако?
Нет. Все операции идут на вашем сервере, документы не отправляются наружу - это и есть смысл 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-операций с постоянным потоком документов - рабочий выбор.
Этот стек у нас запущен на тарифе CPU2-RAM4-DISK40. Если найдете баг в гайде - напишите, поправим в течение дня.