Чому варто розмістити PDF-набір на власному хостингу, а не брати ще один безкоштовний вебконвертер

Браузерні конвертери PDF оптимізовані під схему «завантажити, натиснути, звантажити». Сторінку часто утримує реклама, а стабільної поверхні для розробника поза формою зазвичай немає. Така форма продукту правильна для разової задачі людини. Вона неправильна, коли потрібні автоматизація, політика зберігання даних або файли, які мусять лишатися у вашій мережі.

На що оптимізовані браузерні конвертери

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

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

Що ви отримуєте, запустивши цей каталог самі

Хмарний сайт і власний екземпляр мають ті самі операції. Стиснення і Об’єднання — це ті самі операції, незалежно від того, прийшов запит із порталу чи з POST /api/v1/…. Власний хостинг додає контроль навколо цього спільного каталогу:

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

Compose піднімає Rust-сервер pdfx-server і портал на Next.js разом, тож люди й скрипти користуються одним каталогом. Локальна розробка (task pdfx:dev плюс портал) іде тим самим шляхом операцій. Подробиці — на сторінці Власний хостинг.

OCR за будь-якого розгортання й далі повертає Markdown (text/markdown) з /api/v1/misc/ocr-pdf, а не PDF із відновленим шаром пошуку. Перенесення сервера змінює те, куди потрапляють байти, але не вигадує іншого контракту операцій.

Чого ми навмисно не копіюємо

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

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

Коли хмарного сервісу досить, а коли ні

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

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

Спробуйте

Почніть із Власний хостинг і Розробникам. Про поверхню API, орієнтовану на агентів, за будь-якої базової адреси читайте в статті Зроблено для AI-агентів, а не лише для браузерів. Докладніше про співвідношення витрат і вигод — у статті Що насправді дає власний хостинг.