Product3 мин чтения

Зачем самостоятельно хостить PDF-набор, а не брать ещё один бесплатный веб-конвертер

Браузерные конвертеры подходят для разовых анонимных задач. Свой хостинг того же каталога даёт REST, MCP, CLI, отсутствие рекламы и файлы, не покидающие вашу сеть.

By the PDF123 team · Updated 2026-10-09
Зачем самостоятельно хостить PDF-набор, а не брать ещё один бесплатный веб-конвертер

Браузерные PDF-конвертеры оптимизированы под сценарий «загрузить, нажать, скачать». Реклама часто оплачивает страницу, а стабильной поверхности для разработчика, кроме формы, обычно нет. Такая форма продукта правильна для разовой задачи, которую делает человек. Она неправильна, когда нужны автоматизация, политика хранения или файлы, которые обязаны остаться в вашей сети.

Под что оптимизированы браузерные конвертеры

Публичный конвертер продаёт удобство: открыть вкладку, перетащить файл, получить результат, уйти. Интерфейс и есть продукт. Скриптам остаётся либо парсить HTML, либо обращаться к недокументированным эндпоинтам, которые меняются без предупреждения. За хранение отвечает тот, кто держит временное хранилище. Для одного слияния двух личных PDF такой обмен выгоден.

Как только та же задача нужна из CI, агенту или сети без выхода в интернет, недостающие части проявляются сразу: аутентификация, OpenAPI, идемпотентные повторные попытки и каталог, который не расходится незаметно с формой, по которой вы кликали неделю назад.

Что вы получаете, запуская этот каталог у себя

Хостинговый сайт и развёрнутый самостоятельно экземпляр разделяют одни операции. Сжатие и слияние — те же операции, пришёл запрос из портала или из POST /api/v1/…. Самостоятельный хостинг добавляет контроль вокруг этого общего каталога:

  • REST + OpenAPI на /v1/openapi.json: каждый инструмент каталога — стабильный эндпоинт, а не только форма.
  • MCP на /mcp: агенты находят и вызывают те же операции, не изобретая парсеры.
  • CLI (pdfx): клиент командной строки для того же API, нацеленный на ваш базовый URL с необязательным ключом.
  • Без настольного клиента: офлайн-сценарий — это Docker Compose; плагины и установщики для Windows намеренно вне области.
  • Реклама не на вашей стороне: AdSense на публичном сайте не входит в самостоятельное развёртывание. Загрузки не покидают машины, которые вы запускаете.

Compose поднимает вместе Rust-сервер pdfx-server и портал на Next.js, чтобы люди и скрипты работали с одним каталогом. Нативная разработка (task pdfx:dev плюс портал) идёт по тому же пути операций. Подробности на Self-host.

OCR в любом развёртывании по умолчанию возвращает Markdown (text/markdown) из /api/v1/misc/ocr-pdf, а с outputFormat=pdf — PDF с возможностью поиска. Для пути PDF на хосте нужны бинарный файл tesseract и его языковые пакеты; в опубликованный Docker-образ они входят. Перенос сервера меняет место, куда попадают байты; он не создаёт другой контракт операций.

Что мы намеренно не копируем

Онлайн-редакторы «Edit PDF», визуальное сравнение, пустое создание PDF и потребительские интерфейсы подписи требуют другой продуктовой работы. Вместо них мы держим матрицу инструментов на основе форм и API. Самостоятельный хостинг не открывает второе дерево интерфейса; он переносит то же дерево за ваш брандмауэр.

Пропускать эти потребительские поверхности — осознанно. Редактор-холст стал бы второй кодовой базой со своим отставанием в возможностях относительно OpenAPI. Ограничение, важное для приватного использования, — «байты остаются здесь», а не «есть .exe». О том, почему нет настольной версии, см. Почему мы отказались от настольного приложения.

Когда хостинга достаточно, а когда нет

Пользуйтесь публичным сайтом, когда нужно без настройки и разово, анонимно. Инструменты каталога и анонимные вызовы /api/v1/ не требуют аккаунта; ответы хостинга сообщают заголовки ограничения частоты, а лимиты существуют, чтобы бесплатная поверхность не превратилась в чужую пакетную ферму (анонимное ограничение частоты).

Разворачивайте у себя, когда этого требуют правила хранения, закрытые сети или приватная автоматизация. Тогда вы отвечаете за доступность, обновления образов, диск для временных файлов, TLS и ротацию ключей (SECURITY_CUSTOMGLOBALAPIKEY для фиксированного гейта на вашей машине). Операции остаются теми же; меняется то, где оказываются байты.

Попробуйте

Начните с Self-host и Разработчикам. О поверхности API для агентов на любом базовом URL читайте в статье Создан для AI-агентов, а не только для браузеров. О более подробном разделении затрат и выгод см. Что на самом деле даёт самостоятельный хостинг.

Open tool
Process in the browser — no watermark, files removed after the job.
Open tool
Read next
Что такое PDF123: бесплатный PDF-инструментарий, который можно развернуть у себя
PDF123 — бесплатный PDF-инструментарий в браузере: все 56 инструментов, от объединения и сжатия до OCR и шифрования, работают без аккаунта. Те же операции доступны через REST, MCP и командную строку pdfx, а весь стек можно развернуть у себя и держать файлы в своей сети.
Когда большой PDF не загружается: лимит тела запроса 100 MiB и ошибка, уводящая не туда
Тело одного запроса может занимать 100 MiB, то есть 104,857,600 байт вместе с multipart-обрамлением; сверх лимита эндпоинты операций отвечают 400 с кодом bad_request и упоминанием сбойного multipart-поля, а не 413, поэтому проблема размера выглядит как проблема параметра; с Idempotency-Key действует второй лимит 100 MiB на буфер ответа, и при его превышении приходит 500, а в кэш ничего не пишется.
Создан для AI-агентов, а не только для браузеров: как работает API
Каждый инструмент каталога — это REST-эндпоинт в /api/v1/, плюс MCP на /mcp. Анонимные вызовы не требуют аккаунта и ключа. Ошибки приходят в RFC 7807 problem+json.