Pourquoi auto-héberger une boîte à outils PDF plutôt qu’un autre convertisseur web gratuit

Les convertisseurs PDF purement web optimisent le téléversement, le clic et le téléchargement. La publicité finance souvent la page, et il n’existe en général aucune surface développeur stable au-delà du formulaire. Cette forme de produit convient à une tâche humaine ponctuelle. Elle est inadaptée dès qu’il vous faut de l’automatisation, une politique de conservation ou des fichiers qui doivent rester sur votre réseau.

Ce que les convertisseurs web optimisent

Un convertisseur public vend de la commodité : ouvrir un onglet, déposer un fichier, obtenir un résultat, partir. L’interface est le produit. Les scripts extraient le HTML ou sollicitent des points de terminaison non documentés qui changent sans préavis. La conservation dépend de l’exploitant du stockage temporaire. Pour une fusion unique de deux PDF personnels, ce compromis est acceptable.

Dès qu’il vous faut la même tâche depuis une CI, un agent ou un réseau isolé, les pièces manquantes apparaissent d’un coup : authentification, OpenAPI, réessais idempotents et un catalogue qui ne diverge pas en silence du formulaire cliqué la semaine précédente.

Ce que l’auto-hébergement de ce catalogue vous apporte

Le site hébergé et une instance auto-hébergée partagent les mêmes opérations. Compresser et Fusionner restent les mêmes opérations, que la requête vienne du portail ou de POST /api/v1/…. L’auto-hébergement ajoute du contrôle autour de ce catalogue commun :

• REST + OpenAPI à /v1/openapi.json : chaque outil du catalogue est un point de terminaison stable, pas seulement un formulaire.
• MCP à /mcp : les agents découvrent et appellent les mêmes opérations sans inventer d’extracteurs.
• CLI (pdfx) : pdf-core en local, ou --cloud contre une clé API sur votre URL de base.
• Aucun client de bureau : Docker Compose constitue la réponse hors ligne ; les extensions et les installateurs Windows sont volontairement hors périmètre.
• Aucune publicité dans votre infrastructure : AdSense sur le site public ne fait pas partie d’un déploiement auto-hébergé. Les fichiers téléversés ne quittent pas les machines que vous exploitez.

Compose démarre le pdfx-server Rust et le portail Next.js ensemble, pour que les humains et les scripts partagent un même catalogue. Le développement natif (task pdfx:dev plus le portail) suit le même chemin d’opérations. Les détails figurent sur Auto-hébergement.

L’OCR, sur l’un ou l’autre déploiement, renvoie toujours du Markdown (text/markdown) depuis /api/v1/misc/ocr-pdf, et non un PDF interrogeable pourvu d’une nouvelle couche. Déplacer le serveur change l’endroit où arrivent les octets ; cela ne crée pas un contrat d’opération différent.

Ce que nous ne copions pas volontairement

Les éditeurs « Edit PDF » en ligne, la comparaison visuelle, la création de PDF vierge et les interfaces de signature grand public demandent un autre travail produit. Nous conservons la matrice d’outils à formulaire et l’API. L’auto-hébergement ne débloque pas une seconde arborescence d’interface : il déplace la même arborescence derrière votre pare-feu.

Omettre ces surfaces grand public est délibéré. Un éditeur à toile serait une seconde base de code, avec son propre retard de fonctionnalités par rapport à OpenAPI. La contrainte qui compte pour un usage privé est « les octets restent ici », pas « il existe un .exe ». Pour savoir pourquoi il n’y a pas de version de bureau, voir Pourquoi nous avons renoncé à l’application de bureau.

Quand l’offre hébergée suffit, et quand elle ne suffit pas

Utilisez le site public pour une installation nulle et un usage ponctuel anonyme. Les outils du catalogue et les appels anonymes à /api/v1/ n’exigent aucun compte ; les réponses hébergées exposent des en-têtes de limitation de débit, et des plafonds existent pour que la surface gratuite ne devienne pas la ferme de traitement par lots de quelqu’un d’autre (limitation de débit anonyme).

Auto-hébergez quand les règles de conservation, les réseaux privés ou une automatisation interne l’exigent. Vous assumez alors la disponibilité, les mises à niveau des images, le disque pour les fichiers temporaires, le TLS et la rotation des clés (SECURITY_CUSTOMGLOBALAPIKEY pour une entrée fixe sur votre machine). Les opérations restent les mêmes ; seul l’endroit où arrivent les octets change.

Essayer

Commencez par Auto-hébergement et Développeurs. Pour la surface API destinée aux agents sur l’une ou l’autre URL de base, lisez Conçu pour les agents IA, pas seulement pour les navigateurs. Pour un partage coûts/bénéfices plus détaillé, voir Ce que l’auto-hébergement vous apporte vraiment.