Stirling-PDF
Stirling-PDF - веб-набор из 50+ операций над PDF (объединить, сжать, конвертировать, OCR, подписать, отредактировать текст) на своем сервере. Файлы обрабатываются локально и не уходят в чужое облако. Развернули v3.2.1 на Fatmetal Cloud Server и проверили установку на чистой машине; замеры памяти и образа - с прошлого стенда v2.14.3.
Вердикт
- кому нужен приватный набор PDF-операций без загрузки файлов в чужое облако
- командам до 5 человек: этого хватает на бесплатном тарифе
- тем, кто регулярно делает OCR, сжатие и конвертацию пачек документов
- кому раз в месяц сжать один файл - проще онлайн-сервис
- командам больше 5 человек без бюджета на Team
- тем, кто не готов обслуживать сервер и делать бэкапы
Версия статьи - v3.2.1, октябрь 2026. Установка проверена на чистой Ubuntu 24.04; замеры RAM и образа сняты на v2.14.3 и помечены отдельно.
Что нового в v3 по сравнению с прошлым разбором
Прошлый разбор был на v2.14.3. С тех пор вышла мажорная v3.0.0 и пять релизов после нее. Для читателя важны три вещи: другой интерфейс, новый блок автоматизации и изменившиеся условия бесплатного тарифа.
Интерфейс. В v3 новая левая панель с PDF Library, отдельная панель PDF Processor, новая страница Settings и обновленный просмотрщик. Инструменты остались те же, но разложены иначе. Скриншоты ниже - с проверочной установки v3.2.1.
PDF Processor. Новый блок автоматизации: он берет файлы из папки, FTP или S3, прогоняет через выбранные инструменты и складывает результат обратно. Это не замена ручному редактору, а отдельный сценарий для пачек документов. AI внутри Processor выключен по умолчанию; если его включить, понадобится ключ провайдера моделей.
Лицензия. Бесплатный тариф допускает 5 пользователей - в прошлой статье было написано «один», это была ошибка. Дальше - Team за $99 в месяц на 100 пользователей или Enterprise по договору. Автоматизация, API и AI считаются по кредитам: 1 000 в месяц на Free, дальше $0,01 за кредит. Обычная работа в редакторе остается бесплатной и без лимита.
Установка. Путь прежний: один контейнер на порту 8080 за Caddy. Добавились тома /storage, /pipeline и /customFiles, вырос номер образа. Вход по-прежнему включен, но пароль администратора теперь можно задать до первого старта - без принудительной смены.
Что такое Stirling-PDF и какую задачу решает
Stirling-PDF - это веб-приложение с открытым кодом, которое собирает под одной крышей операции над PDF, ради которых обычно идут на разрозненные онлайн-сервисы: объединение и разбивку, сжатие, конвертацию в другие форматы и обратно, распознавание текста (OCR), наложение водяных знаков и штампов, электронную подпись, редактирование метаданных и текста. Всего в интерфейсе больше 50 инструментов, разложенных по категориям.
Ключевая причина ставить его у себя - приватность. Файлы обрабатываются на вашем сервере, а не отправляются в облако стороннего сервиса. Это закрывает типовой сценарий, когда договоры, сканы паспортов или внутренние документы нельзя загружать на публичный сайт. В v3 к редактору добавился PDF Processor для пакетной обработки, а вход и роли стали частью бесплатного тарифа до 5 пользователей.
Чем отличается от Adobe Acrobat и онлайн-сервисов
Сравниваем по тому, что влияет на выбор приватного PDF-тулкита: где обрабатываются файлы, цена и контроль. У платных сервисов шире готовая экосистема и мобильные приложения - это отмечаем в разделе про ограничения.
| Параметр | Stirling-PDF (self-hosted) | Acrobat / iLovePDF / Smallpdf |
|---|---|---|
| Модель цены | Бесплатно до 5 пользователей; Team $99/мес за 100; платите еще за инфраструктуру VM | Подписка в месяц, лимиты на объем и число файлов |
| Где обрабатываются файлы | На вашем сервере, наружу не уходят | Загружаются на сервер вендора |
| Набор операций | 50+ инструментов в одном интерфейсе | Широкий, часть за старший тариф |
| Доступ к исходному коду | Да, ядро под MIT (open-core) | Нет |
| Пользователи | До 5 бесплатно, дальше Team | Есть на командных тарифах |
| Обслуживание | На вас: обновления, бэкапы, TLS | На вендоре |
Тех-стек и архитектура
Stirling-PDF написан на Java и Spring Boot, интерфейс - отдельное приложение на TypeScript, но в Docker все это едет одним контейнером. Внешняя база данных не нужна: настройки и пользователи хранятся во встроенной H2 в каталоге /configs. Приложение слушает порт 8080 внутри контейнера. Для JAR-установки нужна Java 25, в Docker-образе она уже внутри.
Официальный реестр вендора - docker.stirlingpdf.com/stirlingtools/stirling-pdf. Те же образы публикуются на Docker Hub под именем stirlingtools/stirling-pdf и в ghcr.io. Есть три ветки тегов: latest - полный набор, latest-ultra-lite - урезанный без OCR и офисных конвертаций, latest-fat - со встроенным AI-движком. Для повторяемости закрепляйте тег версии, а не плавающий latest.
В v3 у контейнера шесть томов: /configs с настройками и базой, /logs, /customFiles для брендинга, /pipeline для папок Processor, /storage для файлов пользователей и /usr/share/tessdata для языков OCR. Без /storage библиотека файлов работать не будет, поэтому этот том обязателен.
AI в Processor и AI-ассистент - опция, по умолчанию выключена. Если включать, нужен ключ провайдера моделей: OpenAI, Anthropic, Gemini или локальной модели. На VPS Fatmetal есть прокси к внешним API, он входит в сервер; провайдера клиент выбирает сам.
Минимальная конфигурация
Один Java-контейнер в простое держит около гигабайта памяти. Тяжелые операции (OCR, сжатие, офисные конвертации) добавляют нагрузку на CPU, поэтому запас по процессору важнее, чем по памяти.
| RAM в простое (Stirling, v2.14.3) | ~1022 MiB |
| RAM в простое (Caddy) | ~13 MiB |
| Образ на диске (v2.14.3) | 3.38 GB |
| Образ v3.2.1 (скачивание) | 1,17 ГБ |
| Рекомендуем тариф | CPU2-RAM4-DISK50 |
| Тестовый тариф | CPU2-RAM4-DISK40 |
Почему не гонимся за RAM. Сам сервис в простое умещается в гигабайт, и CPU2-RAM4-DISK50 берет его с запасом. Узкое место - не память, а процессор на тяжелых задачах: OCR и сжатие грузят CPU, и на 2 vCPU большой скан обрабатывается ощутимо дольше. Документация вендора для 1-10 пользователей называет те же 2-4 ядра, 4 ГБ RAM и 10 ГБ диска.
Замеры памяти и образа сделаны на v2.14.3 в сентябре 2026. Для v3.2.1 мы проверили установку и запуск, но не перемеряли RAM: контейнер и требования те же.
В маркетплейсе Fatmetal
Не хотите ставить руками?
Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий домен, валидный TLS и файл с доступами.
Рекомендуемая конфигурация:
2 vCPU · 4 ГБ RAM · 50 ГБ NVMe от 585 ₽/мес
Развертывание на Fatmetal через Docker
Базовый путь - Cloud Server с Ubuntu 24.04 LTS, Docker и Caddy с валидным TLS. Приложение слушает 8080 внутри контейнера, наружу торчит только Caddy. Инструкция проверена на чистой машине.
-
Создать VM
Cloud Server, тариф CPU2-RAM4-DISK50, ОС Ubuntu 24.04 LTS. Откройте порты 80 и 443 для Caddy. Docker поставим отдельным шагом, чтобы все команды были на виду.
-
Поставить Docker
Официальный скрипт Docker ставит движок и включает службу. Если Docker уже есть, шаг можно пропустить.
sudo curl -fsSL https://get.docker.com | sudo sh sudo systemctl enable --now docker -
Поднять контейнер
Образ закреплен по версии. Пароль администратора задается до первого старта, поэтому Stirling не попросит его менять. Замените
ChangeMe-Stirling1на свой пароль.sudo docker volume create stirling-configs sudo docker volume create stirling-logs sudo docker volume create stirling-custom sudo docker volume create stirling-pipeline sudo docker volume create stirling-storage sudo docker volume create stirling-tessdata sudo docker run -d --name stirling \ --restart unless-stopped \ -p 127.0.0.1:8080:8080 \ -v stirling-configs:/configs \ -v stirling-logs:/logs \ -v stirling-custom:/customFiles \ -v stirling-pipeline:/pipeline \ -v stirling-storage:/storage \ -v stirling-tessdata:/usr/share/tessdata \ -e SECURITY_ENABLELOGIN=true \ -e SECURITY_INITIALLOGIN_USERNAME=admin \ -e SECURITY_INITIALLOGIN_PASSWORD='ChangeMe-Stirling1' \ -e SYSTEM_DEFAULTLOCALE=ru-RU \ --memory 4g \ stirlingtools/stirling-pdf:3.2.1Настройки и встроенная H2 лежат в томе
stirling-configs, файлы пользователей - вstirling-storage. Эти два тома и нужно бэкапить. -
Поставить Caddy перед приложением
Caddy сам получит сертификат Let's Encrypt для вашего домена и проксирует запросы на локальный 8080. Замените
ваш-доменна свой адрес.sudo mkdir -p /opt/caddy sudo tee /opt/caddy/Caddyfile >/dev/null <<'EOF' ваш-домен { reverse_proxy 127.0.0.1:8080 } EOF sudo docker run -d --name caddy --restart unless-stopped --network host \ -v /opt/caddy/Caddyfile:/etc/caddy/Caddyfile \ -v caddy_data:/data \ caddy:2 -
Проверить
Дождитесь, пока Caddy выпустит сертификат, и проверьте статус. Ожидаем version 3.2.1 и status UP.
for i in $(seq 1 60); do code="$(curl -s -o /dev/null -w '%{http_code}' https://ваш-домен/api/v1/info/status || true)" [ "$code" = "200" ] && break sleep 5 done curl -s https://ваш-домен/api/v1/info/status # ожидаем {"version":"3.2.1","status":"UP"}Откройте
https://ваш-домен/в браузере и войдите: логинadmin, пароль - тот, что вы задали в команде выше. Если пропуститьSECURITY_INITIALLOGIN_PASSWORD, Stirling создастadmin/stirlingи заставит сменить пароль при первом входе.
Что измерили после запуска
Цифры с тестового CPU2-RAM4-DISK40, Ubuntu 24.04, доступ через Caddy с TLS. Состояние - свежая установка, без нагрузки. Замеры сделаны на v2.14.3.
| RAM в простое - Stirling | ~1022 MiB |
| RAM в простое - Caddy | ~13 MiB |
| CPU в простое | ~0.3% |
| Образ на диске | 3.38 GB |
| Проверка статуса (v3.2.1) | /api/v1/info/status - version 3.2.1, status UP |
Главное по ресурсам. В простое стек скромный: чуть больше гигабайта памяти и почти нулевой CPU. Реальную нагрузку создают сами операции - OCR, сжатие и офисные конвертации, а не фон. Планируйте по процессору под пиковые задачи, а не по памяти в покое.
Где может сломаться
Особенности v3, на которые мы наткнулись при разборе и проверке установки.
Пароль администратора задается до первого старта. Если не передать SECURITY_INITIALLOGIN_PASSWORD, Stirling создаст admin / stirling и при первом входе потребует сменить пароль. Настройка работает только на пустой базе: на уже заведенном сервере она игнорируется.
Free - это 5 пользователей, а не один. В прошлой статье было написано иначе; для v3.2.1 это неверно. Пяти учетных записей хватает небольшой команде, но если нужно больше, придется брать Team за $99 в месяц на 100 пользователей или Enterprise по договору.
Автоматизация сверх лимита платная. PDF Processor, API и AI расходуют кредиты: 1 000 в месяц на Free, дальше $0,01 за кредит. Ручная работа в редакторе под лимит не попадает.
OCR и конвертации грузят процессор. На 2 vCPU распознавание большого скана или конвертация офисного файла идут небыстро. Для потока таких задач берите больше ядер, а не памяти.
Образ крупный, первый pull долгий. v3.2.1 скачивается на 1,17 ГБ, на диске занимает больше. Полный образ с OCR и офисными конвертациями - это несколько гигабайт; для экономии диска есть latest-ultra-lite, но в нем нет входа и админки, на публичный адрес его ставить нельзя.
Причина. Вход включен по умолчанию, и без авторизации приложение отдает 401. Это не ошибка прокси: в Caddy нет basic-auth.
Решение. Откройте интерфейс в браузере и войдите под admin и своим паролем. Если пароль не задавали до первого старта, используйте stirling и сразу смените его. Отключать вход целиком (SECURITY_ENABLELOGIN=false) на публичном адресе не стоит.
Безопасность и обновления
Файлы обрабатываются на вашем сервере и не уходят в чужое облако. На публичном адресе оставляйте вход включенным (SECURITY_ENABLELOGIN=true) и задавайте пароль до первого старта. Наружу выставляйте только Caddy с TLS, а контейнер держите на локальном порту.
Обновление - смена тега образа и пересоздание контейнера с теми же томами. Пароль администратора при обновлении уже не задается: база не пустая, настройка игнорируется.
sudo docker pull stirlingtools/stirling-pdf:3.2.1
sudo docker rm -f stirling
sudo docker run -d --name stirling --restart unless-stopped \
-p 127.0.0.1:8080:8080 \
-v stirling-configs:/configs -v stirling-logs:/logs \
-v stirling-custom:/customFiles -v stirling-pipeline:/pipeline \
-v stirling-storage:/storage -v stirling-tessdata:/usr/share/tessdata \
-e SECURITY_ENABLELOGIN=true \
stirlingtools/stirling-pdf:3.2.1
Бэкап - это два тома: настройки с базой и файлы пользователей. Их можно выгрузить одним архивом:
sudo docker run --rm \
-v stirling-configs:/configs -v stirling-storage:/storage \
-v "$(pwd)":/backup alpine \
tar czf /backup/stirling-backup.tar.gz -C / configs storage
Уязвимости прошлых версий
Статья и карточка ставят v3.2.1, в ней перечисленные ниже проблемы закрыты. Если вы остались на версии из таблицы, обновитесь: смена тега и пересоздание контейнера с теми же томами.
| Идентификатор | Серьезность | Затронуты | Исправлено | Что это значит |
|---|---|---|---|---|
| CVE-2026-85714 | critical | <= 2.11.0 | 2.13.2 | RCE через импорт SQL-дампа в H2. |
| CVE-2026-57485 | high | <= 2.8.0 | 2.9.0 | Утечка API-ключа внутреннего сервиса через pipeline. |
| GHSA-pp9g-47g3-f789 | medium | < 3.0.0 | 3.0.0 | CSV-инъекция при экспорте PDF в CSV: формула в ячейке исполнялась в таблице. |
Список сверен с GitHub Security Advisories 23.10.2026. В v2.14.3 критическая и высокая уязвимости уже были закрыты; CSV-инъекция закрыта только в 3.0.0.
Связь с другими стеками
Что обычно ставят рядом со Stirling-PDF в рабочем контуре.
- Обратный прокси с TLS - Caddy или Nginx Proxy Manager, чтобы наружу торчал только защищенный домен, а контейнер слушал локальный порт.
- Бэкапы - архив томов
stirling-configsиstirling-storageпо cron с выгрузкой в S3-совместимое хранилище. - Мониторинг - Uptime Kuma по эндпоинту
/api/v1/info/status, чтобы ловить падения сервиса. - Хранилище документов - Nextcloud или Paperless рядом, когда PDF нужно не только обрабатывать, но и хранить с поиском.
Когда это НЕ ваш выбор
Разовая правка одного файла
Если PDF нужно обработать раз в месяц, поднимать и обслуживать отдельный сервер избыточно - быстрее открыть онлайн-сервис. Stirling-PDF окупается там, где поток документов постоянный и приватность обязательна.
Команда больше 5 человек без бюджета на Team
На Free помещается 5 пользователей. Если нужно больше учетных записей с ролями и вы не готовы платить $99 в месяц за Team, это ограничение продукта, а не настройки.
Высоконагруженный конвейер OCR
Один Java-контейнер и упор в CPU на тяжелых операциях делают Stirling-PDF слабым выбором под массовое распознавание сотен документов в час. Для такого нужен горизонтально масштабируемый специализированный конвейер.
Частые вопросы
Файлы уходят в облако?
Нет. Все операции идут на вашем сервере, документы не отправляются наружу - это и есть смысл self-hosted варианта. AI-функции выключены по умолчанию.
Хватит ли 4 GB RAM?
Да, в простое сервис держит около 1 GB. Узкое место - не память, а CPU на OCR и сжатии.
Нужна ли отдельная база данных?
Нет. Настройки и пользователи хранятся во встроенной H2 в томе /configs. Внешний PostgreSQL нужен только для Team или Enterprise.
Почему корень отдает 401?
Вход включен по умолчанию. Войдите под admin и своим паролем; если пароль не задавали до первого старта - под admin / stirling и сразу смените его.
Сколько пользователей бесплатно?
До 5. Дальше Team за $99 в месяц на 100 пользователей или Enterprise по договору.
Как обновлять?
Сменить тег образа на 3.2.1 и пересоздать контейнер с теми же томами. База и настройки останутся на месте.
Какие ограничения лицензии?
Ядро под MIT, отдельные каталоги - open-core. Бесплатный self-host ограничен 5 пользователями; Team и Enterprise - платные лицензии.
Итог
Stirling-PDF v3.2.1 поднимается на Fatmetal Cloud Server одним Docker-контейнером за Caddy: в простое это ~1 GB RAM и почти нулевой CPU, образ v3.2.1 скачивается на 1,17 ГБ (на диске больше; у v2.14.3 было 3,38 ГБ). Внешняя БД не нужна, приватность встроена в модель - файлы не уходят с сервера. Берем CPU2-RAM4-DISK50 с запасом по процессору под OCR и сжатие. Главное, о чем предупредить клиента: Free допускает 5 пользователей, автоматизация сверх 1 000 кредитов платная, а пароль администратора лучше задать до первого старта. Для приватного набора PDF-операций с постоянным потоком документов - рабочий выбор.
Рекомендуемая конфигурация для установки:
2 vCPU · 4 ГБ RAM · 50 ГБ NVMe
Не хотите устанавливать вручную?
Запустите Stirling-PDF на этой конфигурации автоматически - от 585 ₽/мес.
Этот стек у нас запущен на тарифе CPU2-RAM4-DISK40. Если найдете баг в гайде - напишите, поправим в течение дня.