Per què autoallotjar una caixa d'eines PDF en lloc d'un altre convertidor web gratuït

Els convertidors de PDF que només funcionen al navegador optimitzen la càrrega, el clic i la descàrrega. Sovint els anuncis financen la pàgina i normalment no hi ha cap superfície estable per a desenvolupadors més enllà del formulari. Aquesta forma de producte és correcta per a una tasca humana puntual. És la forma equivocada quan necessiteu automatització, una política de retenció o fitxers que han de quedar-se a la vostra xarxa.

Què optimitzen els convertidors de navegador

Un convertidor públic ven comoditat: obriu una pestanya, deixeu-hi un fitxer, obteniu un resultat i marxeu. La interfície és el producte. Els scripts o bé rastregen l'HTML o bé ataquen punts de destinació no documentats que canvien sense avís. La retenció depèn de qui opera el magatzem temporal. Per a una sola unió de dos PDF personals, aquest intercanvi està bé.

Tan bon punt necessiteu la mateixa tasca des d'un CI, un agent o una xarxa aïllada, les peces que falten apareixen totes alhora: autenticació, OpenAPI, reintents idempotents i un catàleg que no divergeixi en silenci del formulari que vau clicar la setmana passada.

Què obteniu si executeu vosaltres mateixos aquest catàleg

El lloc allotjat i una instància autoallotjada comparteixen les mateixes operacions. Comprimeix i Uneix són les mateixes operacions tant si la petició ve del portal com de POST /api/v1/…. L'autoallotjament hi afegeix control:

• REST + OpenAPI a /v1/openapi.json: cada eina del catàleg és un punt de destinació estable, no només un formulari.
• MCP a /mcp: els agents descobreixen i criden les mateixes operacions sense inventar-se rastrejadors.
• CLI (pdfx): el pdf-core local, o --cloud contra una clau d'API a la vostra URL base.
• Sense client d'escriptori: Docker Compose és la història offline; els connectors i els instal·ladors de Windows queden fora d'abast a propòsit.
• Els anuncis no entren a la vostra pila: AdSense al lloc públic no forma part d'un desplegament autoallotjat. Les càrregues no surten mai de les màquines que executeu.

Compose engega alhora el pdfx-server de Rust i el portal de Next.js perquè les persones i els scripts comparteixin un sol catàleg. El desenvolupament natiu (task pdfx:dev més el portal) fa servir el mateix camí d'operacions. Els detalls són a Autoallotjament.

L'OCR, en qualsevol dels dos desplegaments, continua retornant Markdown (text/markdown) des de /api/v1/misc/ocr-pdf, no un PDF cercable amb una capa nova. Canviar de lloc el servidor canvia on van a parar els bytes; no inventa un contracte d'operacions diferent.

Què no copiem a propòsit

Els llenços en línia per «editar PDF», la comparació visual, la creació d'un PDF en blanc i les interfícies de signatura per a consumidors requereixen una feina de producte diferent. Ens quedem amb la matriu d'eines basada en formularis i amb l'API. L'autoallotjament no desbloqueja un segon arbre d'interfície; trasllada el mateix arbre darrere del vostre tallafoc.

Ometre aquestes superfícies de consum és deliberat. Un editor de llenç seria una segona base de codi amb el seu propi retard de funcions respecte de l'OpenAPI. La restricció que importa per a l'ús privat és «els bytes es queden aquí», no «hi ha un .exe». Sobre per què no hi ha una versió d'escriptori, vegeu Per què vam descartar l'aplicació d'escriptori.

Quan l'allotjament ja és suficient i quan no

Feu servir el lloc públic quan vulgueu configuració zero i una tasca anònima puntual. Les eines del catàleg i les crides anònimes a /api/v1/ no demanen compte; les respostes allotjades anuncien capçaleres de limitació de taxa, i els límits existeixen perquè la superfície gratuïta no es converteixi en la granja de lots d'algú altre (limitació de taxa anònima).

Autoallotgeu quan ho exigeixin les regles de retenció, les xarxes privades o l'automatització privada. Llavors passeu a ser responsables de la disponibilitat, les actualitzacions d'imatge, el disc per als fitxers temporals, el TLS i la rotació de claus (SECURITY_CUSTOMGLOBALAPIKEY per a una porta fixa a la vostra màquina). Les operacions continuen sent les mateixes; el que canvia és on van a parar els bytes.

Proveu-ho

Comenceu per Autoallotjament i Desenvolupadors. Per a la superfície d'API orientada a agents sobre qualsevol URL base, llegiu Fet per a agents d'IA, no només navegadors. Per a una anàlisi cost/benefici més detallada, vegeu Què us aporta realment l'autoallotjament.