Product3 мин четене

Защо да хоствате сами PDF инструментариум вместо още един безплатен уеб конвертор

Браузърните конвертори стават за еднократна употреба. Самостоятелното хостване на същия каталог дава REST, MCP, CLI, без реклами, а файловете не напускат мрежата ви.

By the PDF123 team · Updated 2026-10-09
Защо да хоствате сами PDF инструментариум вместо още един безплатен уеб конвертор

Конверторите само в браузър оптимизират качване, клик, изтегляне. Рекламите често финансират страницата и обикновено няма стабилна повърхност за разработчици извън формуляра. Тази форма на продукта е правилна за еднократна човешка задача. Тя е грешна, когато ви трябва автоматизация, политика за съхранение или файлове, които трябва да останат във вашата мрежа.

Към какво са оптимизирани браузърните конвертори

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

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

Какво получавате, като пуснете този каталог сами

Хостваният сайт и самостоятелно хостваната инстанция споделят едни и същи операции. Compress и Merge са същите операции, независимо дали заявката е дошла от портала, или от POST /api/v1/…. Самостоятелното хостване добавя контрол около този споделен каталог:

  • REST + OpenAPI на /v1/openapi.json: всеки инструмент от каталога е стабилна крайна точка, а не само формуляр.
  • MCP на /mcp: агентите откриват и извикват същите операции, без да си измислят скрейпъри.
  • CLI (pdfx): клиент от командния ред за същото API, насочен към вашия базов адрес с незадължителен ключ.
  • Без настолен клиент: 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“, визуалното сравняване, празният Create PDF и потребителските интерфейси за подпис изискват друга продуктова работа. Ние запазваме матрицата от формуляри и API. Самостоятелното хостване не отключва второ дърво от интерфейси; то премества същото дърво зад вашата защитна стена.

Пропускането на тези потребителски повърхности е умишлено. Редактор с платно би бил втора кодова база със собствено изоставане спрямо OpenAPI. Ограничението, което има значение за лична употреба, е „байтовете остават тук“, а не „има .exe“. Защо няма настолен вариант вижте в Защо пропуснахме настолното приложение.

Кога хостваното стига и кога не

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

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

Опитайте

Започнете от Self-host и Developers. За повърхността на API, насочена към агенти, при всеки от двата базови адреса прочетете Създаден за 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. Анонимните заявки не изискват акаунт или API ключ. Грешките връщат RFC 7807 problem+json.