Обновлено 23 октября 2026 г.
Работа с документами

Stirling-PDF

Stirling-PDF - веб-набор из 50+ операций над PDF (объединить, сжать, конвертировать, OCR, подписать, отредактировать текст) на своем сервере. Файлы обрабатываются локально и не уходят в чужое облако. Развернули v3.2.1 на Fatmetal Cloud Server и проверили установку на чистой машине; замеры памяти и образа - с прошлого стенда v2.14.3.

Октябрь 2026 ~9 минут чтения Fatmetal Team
PDF-инструменты · Self-hosted Лицензия: MIT (open-core) Статус: v3.2.1, установка проверена

Вердикт

Подходит
  • кому нужен приватный набор PDF-операций без загрузки файлов в чужое облако
  • командам до 5 человек: этого хватает на бесплатном тарифе
  • тем, кто регулярно делает OCR, сжатие и конвертацию пачек документов
Не подходит
  • кому раз в месяц сжать один файл - проще онлайн-сервис
  • командам больше 5 человек без бюджета на Team
  • тем, кто не готов обслуживать сервер и делать бэкапы
Мин. тариф: CPU2-RAM4-DISK50 Рекомендуем: CPU2-RAM4-DISK50 Сложность: easy Образ: 1,17 ГБ скачивание Главный риск: Free только до 5 пользователей, автоматизация сверх лимита платная Прод-готовность: с оговорками (TLS, бэкап /configs, лимит Free)

Версия статьи - 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 выключен по умолчанию; если его включить, понадобится ключ провайдера моделей.

https://ваш-домен/processor
Stirling-PDF v3.2.1 - панель PDF Processor с источниками, политиками и результатами
PDF Processor в v3.2.1: источники (папка, S3, API, email), политики обработки и результаты. На скриншоте - пустой конвейер после установки.

Лицензия. Бесплатный тариф допускает 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 пользователей.

Java 25Spring BootTypeScriptH2 (встроенная БД)DockerCaddy
Сравнение

Чем отличается от 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
i

Почему не гонимся за 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. Инструкция проверена на чистой машине.

  1. Создать VM

    Cloud Server, тариф CPU2-RAM4-DISK50, ОС Ubuntu 24.04 LTS. Откройте порты 80 и 443 для Caddy. Docker поставим отдельным шагом, чтобы все команды были на виду.

  2. Поставить Docker

    Официальный скрипт Docker ставит движок и включает службу. Если Docker уже есть, шаг можно пропустить.

    sudo curl -fsSL https://get.docker.com | sudo sh
    sudo systemctl enable --now docker
  3. Поднять контейнер

    Образ закреплен по версии. Пароль администратора задается до первого старта, поэтому 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. Эти два тома и нужно бэкапить.

  4. Поставить 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
  5. Проверить

    Дождитесь, пока 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 и заставит сменить пароль при первом входе.

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

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

Цифры с тестового 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
i

Главное по ресурсам. В простое стек скромный: чуть больше гигабайта памяти и почти нулевой 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, но в нем нет входа и админки, на публичный адрес его ставить нельзя.

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

Причина. Вход включен по умолчанию, и без авторизации приложение отдает 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-85714critical<= 2.11.02.13.2RCE через импорт SQL-дампа в H2.
CVE-2026-57485high<= 2.8.02.9.0Утечка API-ключа внутреннего сервиса через pipeline.
GHSA-pp9g-47g3-f789medium< 3.0.03.0.0CSV-инъекция при экспорте 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 слабым выбором под массовое распознавание сотен документов в час. Для такого нужен горизонтально масштабируемый специализированный конвейер.

FAQ

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

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

Нет. Все операции идут на вашем сервере, документы не отправляются наружу - это и есть смысл 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 ₽/мес.

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

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