Co naprawdę daje self-hosting (i ile kosztuje)

Publiczny konwerter optymalizuje anonimowe zadania jednorazowe. Self-hosting PDF123 zmienia kontrakt: przesyłane pliki trafiają na maszyny, którymi zarządzasz, a każde narzędzie z katalogu jest dostępne przez HTTP, nie tylko jako formularz w przeglądarce.

Co zyskujesz

Pierwszym zakupem jest lokalizacja danych. Pliki trafiają na twój pdfx-server, a nie do magazynu tymczasowego, którego nie prowadzisz. Drugim jest interfejs dla programistów na tej samej maszynie: REST pod /api/v1/…, OpenAPI pod /v1/openapi.json, MCP pod /mcp oraz pdfx --cloud skierowany na twój adres bazowy.

Docker Compose uruchamia razem backend w Rust i portal Next.js, dzięki czemu ludzie i skrypty korzystają z jednego katalogu. Na tej ścieżce nie ma instalatora desktopowego; praca offline to Compose i CLI (Self-host). Lokalna praca natywna używa task pdfx:dev obok portalu, a Compose używa task docker:build / task docker:up (API na porcie :8080, portal na :3000).

Agent albo zadanie CI z twoim kluczem wywołuje te same operacje co publiczny serwis. Scal PDF, Compress, OCR, konwersja i reszta zachowują te same ścieżki i parametry. Ta identyczność jest produktem, nie hasłem.

Reklamy finansujące publiczny serwis nie wchodzą w skład wdrożenia self-hosted. Nie dotyczy cię też historia anonimowych limitów wersji hostowanej: planowanie pojemności spada na ciebie, łącznie ze skokami użycia procesora podczas OCR albo dużych scaleń. OCR nadal zwraca Markdown (text/markdown) na twojej maszynie; przeniesienie serwera nie zmienia kontraktu operacji.

Ile to kosztuje

Odpowiadasz za dostępność, aktualizacje obrazów, miejsce na pliki tymczasowe, TLS i rotację kluczy. Compose łatwo uruchomić, ale utrzymanie go w dobrej kondycji to praca ciągła. Ustaw SECURITY_CUSTOMGLOBALAPIKEY, jeśli chcesz stałą bramkę z kluczem API na swojej instancji. Funkcje opcjonalne (na przykład konwersja URL→PDF przez SYSTEM_ENABLEURLTOPDF=true) to flagi włączane świadomie, a nie ustawienia domyślne obecne tylko dlatego, że ma je publiczny serwis.

Self-hosting nie dodaje wizualnego edytora PDF na kanwie przez przełączenie flagi. Zestaw możliwości to nadal narzędzia formularzowe plus API. Jeśli potrzebujesz edycji na kanwie, wciąż potrzebujesz innego produktu; przeniesienie serwera tego interfejsu nie tworzy.

Limity tempa i sposób rozliczania zależą od konfiguracji twojej maszyny. Nie zakładaj, że ogłaszane nagłówki i limity publicznego serwisu przenoszą się bez zmian; czytaj nagłówki zwracane przez twoją instancję, gdy zależy ci na budżecie. Operacje z ciężkimi zależnościami (modele OCR, opcjonalne konwertery) kończą się strukturalnymi kodami problemu missing_dependency / unavailable, jeśli w obrazie nie ma potrzebnego pliku wykonywalnego albo pakietu modeli.

Jak to się ma do publicznego serwisu

Z hostowanego PDF123 korzystaj do prób bez konfiguracji. Narzędzia z katalogu i anonimowe wywołania /api/v1/ nie wymagają tam konta; odpowiedzi podają nagłówki X-RateLimit-*, a przy 429 zwracają Retry-After (anonimowe limity tempa).

Self-host wybierz, gdy wymagają tego reguły przechowywania, sieci odizolowane albo prywatna automatyzacja. /llms.txt pomaga agentom odkrywać narzędzia pod adresem bazowym, który prowadzisz; Google Search nie traktuje go jako sygnału pozycji. MCP i OpenAPI pozostają dostępne obok portalu pod tym samym adresem.

Kiedy jeszcze nie stawiać self-hostingu

Jeśli potrzebujesz jednego scalenia dziś po południu, formularz hostowany wystarczy. Jeśli prywatne pliki są potrzebne jutro i każdego kolejnego dnia, zacznij od Compose już teraz, zamiast doklejać instalator desktopowy do nawyku z SaaS. Wspierany przez nas scenariusz pracy offline opisuje strona Self-host, a nie karta w sklepie z aplikacjami.

Zacznij od Self-host. Klucze i OpenAPI są na stronie Dla programistów. Krótsze porównanie z konwerterami działającymi tylko w przeglądarce znajdziesz w Po co samodzielnie hostować zestaw narzędzi PDF. Dlaczego Compose, a nie plik .exe, wyjaśnia Dlaczego pominęliśmy aplikację desktopową.