Waarom een PDF-toolkit self-hosten in plaats van weer een gratis webconverter

Browserconverters die alleen op het web draaien, zijn geoptimaliseerd voor uploaden, klikken, downloaden. Advertenties financieren de pagina vaak, en buiten het formulier is er meestal geen stabiel oppervlak voor ontwikkelaars. Die productvorm klopt voor een eenmalige menselijke taak. Het is de verkeerde vorm wanneer u automatisering nodig hebt, een bewaarbeleid of bestanden die op uw netwerk moeten blijven.

Waar browserconverters op optimaliseren

Een openbare converter verkoopt gemak: open een tab, laat een bestand vallen, krijg een resultaat, vertrek. De UI is het product. Scripts scrapen HTML of gebruiken ongedocumenteerde endpoints die zonder waarschuwing veranderen. Het bewaarbeleid is het beleid van wie de tijdelijke opslag beheert. Voor één merge van twee persoonlijke PDF's is die ruil prima.

Zodra u dezelfde taak vanuit CI, een agent of een geïsoleerd netwerk nodig hebt, komen de ontbrekende stukken tegelijk naar boven: authenticatie, OpenAPI, idempotente nieuwe pogingen en een catalogus die niet stil afwijkt van het formulier dat u vorige week aanklikte.

Wat u krijgt als u deze catalogus zelf draait

De gehoste site en een self-hosted exemplaar delen dezelfde bewerkingen. Compress en Merge zijn dezelfde bewerkingen, of het verzoek nu van de portal komt of van POST /api/v1/…. Self-hosting voegt controle toe rond die gedeelde catalogus:

• REST + OpenAPI op /v1/openapi.json: elke catalogustool is een stabiel endpoint, niet alleen een formulier.
• MCP op /mcp: agents ontdekken en roepen dezelfde bewerkingen aan zonder zelf scrapers te bouwen.
• CLI (pdfx): lokale pdf-core, of --cloud tegen een API-sleutel op uw basis-URL.
• Geen desktopclient: Docker Compose is het verhaal voor offline gebruik; plug-ins en Windows-installatieprogramma's vallen expres buiten bereik.
• Geen advertenties in uw stack: AdSense op de openbare site hoort niet bij een self-hosted uitrol. Geüploade bestanden verlaten de machines die u draait nooit.

Compose start de Rust-server pdfx-server en de Next.js-portal samen, zodat mensen en scripts één catalogus delen. Native ontwikkeling (task pdfx:dev plus de portal) gebruikt hetzelfde bewerkingspad. Details staan op Self-host.

OCR levert op beide uitrollen nog steeds Markdown (text/markdown) uit /api/v1/misc/ocr-pdf, geen doorzoekbare PDF met een nieuwe tekstlaag. De server verplaatsen verandert waar de bytes terechtkomen, maar verzint geen ander contract voor de bewerking.

Wat we expres niet kopiëren

Online canvassen voor “Edit PDF”, visueel vergelijken, een leeg Create PDF en Sign-UI's voor consumenten vragen ander productwerk. Wij kiezen voor de formuliergebaseerde toolmatrix plus de API. Self-hosting ontsluit geen tweede UI-boom; het verplaatst dezelfde boom achter uw firewall.

Die consumentenoppervlakken overslaan is een bewuste keuze. Een canvaseditor zou een tweede codebasis zijn met een eigen achterstand in functies ten opzichte van OpenAPI. De beperking die voor privégebruik telt, is “de bytes blijven hier”, niet “er is een .exe”. Waarom er geen desktopvariant is, leest u in Why We Skipped the Desktop App.

Wanneer gehost voldoende is, en wanneer niet

Gebruik de openbare site als u niets wilt installeren en een anonieme eenmalige taak hebt. Catalogustools en anonieme aanroepen naar /api/v1/ hebben geen account nodig; gehoste antwoorden vermelden rate-limit-headers, en er bestaan limieten zodat het gratis oppervlak niet de batchverwerking van iemand anders wordt (anonieme rate limiting).

Self-host wanneer bewaarregels, privénetwerken of privéautomatisering dat vereisen. U bent dan zelf verantwoordelijk voor uptime, image-updates, schijfruimte voor tijdelijke bestanden, TLS en het roteren van sleutels (SECURITY_CUSTOMGLOBALAPIKEY voor een vaste drempel op uw machine). De bewerkingen blijven hetzelfde; wat verandert, is waar de bytes terechtkomen.

Probeer het

Begin bij Self-host en Developers. Voor het API-oppervlak voor agents op beide basis-URL's, lees Built for AI agents, not just browsers. Voor een uitgebreidere afweging van kosten en baten, zie What self-hosting actually buys you.