Warum ein eigenes PDF-Toolkit hosten statt eines weiteren kostenlosen Onlinekonverters

Nur im Browser arbeitende PDF-Konverter sind auf Hochladen, Klicken, Herunterladen optimiert. Werbung finanziert oft die Seite, und über das Formular hinaus gibt es meist keine stabile Oberfläche für Entwickler. Diese Produktform passt zu einer einmaligen Aufgabe, die ein Mensch erledigt. Sie ist die falsche Form, wenn du Automatisierung, eine Aufbewahrungsrichtlinie oder Dateien brauchst, die in deinem Netz bleiben müssen.

Worauf Browserkonverter optimieren

Ein öffentlicher Konverter verkauft Bequemlichkeit: Tab öffnen, Datei ablegen, Ergebnis erhalten, die Seite verlassen. Die Oberfläche ist das Produkt. Skripte scrapen entweder HTML oder sprechen undokumentierte Endpunkte an, die sich ohne Ankündigung ändern. Für die Aufbewahrung ist zuständig, wer den Zwischenspeicher betreibt. Für ein einzelnes Zusammenführen zweier privater PDFs ist dieser Tausch in Ordnung.

Sobald dieselbe Aufgabe aus CI, von einem Agenten oder aus einem abgeschotteten Netz kommen soll, fehlen die Bausteine auf einmal: Authentifizierung, OpenAPI, idempotente Wiederholungsversuche und ein Katalog, der nicht still von dem Formular abweicht, das du letzte Woche benutzt hast.

Was der eigene Betrieb dieses Katalogs bringt

Die gehostete Website und eine selbst gehostete Instanz teilen dieselben Operationen. Komprimieren und Zusammenführen sind dieselben Operationen, egal ob die Anfrage aus dem Portal oder über POST /api/v1/… kommt. Selbst hosten ergänzt Kontrolle um diesen gemeinsamen Katalog:

• REST und OpenAPI unter /v1/openapi.json: Jedes Katalogwerkzeug ist ein stabiler Endpunkt und nicht nur ein Formular.
• MCP unter /mcp: Agenten entdecken und rufen dieselben Operationen auf, ohne eigene Scraper zu bauen.
• CLI (pdfx): ein Kommandozeilenclient für dieselbe API, gerichtet auf deine Basis-URL mit optionalem Schlüssel.
• Kein Desktop-Client: Für den Offline-Betrieb steht Docker Compose; Plugins und Windows-Installer liegen bewusst außerhalb des Umfangs.
• Keine Werbung in der eigenen Installation: AdSense auf der öffentlichen Website gehört nicht zu einer selbst gehosteten Bereitstellung. Uploads verlassen die Rechner, die du betreibst, nie.

Compose startet den Rust-Server pdfx-server und das Next.js-Portal gemeinsam, damit Menschen und Skripte einen Katalog teilen. Die native Entwicklung (task pdfx:dev plus Portal) nutzt denselben Operationspfad. Details stehen unter Selbst hosten.

OCR liefert in beiden Varianten weiterhin Markdown (text/markdown) von /api/v1/misc/ocr-pdf und kein neu geschichtetes durchsuchbares PDF. Ein anderer Standort des Servers ändert, wo die Bytes landen, erfindet aber keinen anderen Vertrag für die Operationen.

Was wir bewusst nicht nachbauen

Online-Leinwände zum „PDF bearbeiten“, visueller Vergleich, ein leeres Create PDF und Anmeldeoberflächen für Endnutzer erfordern andere Produktarbeit. Wir behalten die formularbasierte Werkzeugmatrix und die API. Selbst hosten schaltet keinen zweiten Baum von Oberflächen frei, sondern stellt denselben Baum hinter deine Firewall.

Diese Endnutzer-Oberflächen bewusst auszulassen ist Absicht. Ein Leinwand-Editor wäre eine zweite Codebasis mit eigenem Rückstand bei Funktionen gegenüber OpenAPI. Die Einschränkung, die für private Nutzung zählt, lautet „die Bytes bleiben hier“ und nicht „es gibt eine .exe“. Warum es keinen Desktop-Ableger gibt, steht in Warum wir die Desktop-App ausgelassen haben.

Wann die gehostete Variante reicht und wann nicht

Nutze die öffentliche Website, wenn du keine Einrichtung und eine anonyme einmalige Aufgabe willst. Katalogwerkzeuge und anonyme Aufrufe unter /api/v1/ brauchen kein Konto; Antworten der gehosteten Variante enthalten Header zur Ratenbegrenzung, und Obergrenzen existieren, damit die kostenlose Oberfläche nicht zur Stapelverarbeitung für andere wird (anonyme Ratenbegrenzung).

Hoste selbst, wenn Aufbewahrungsregeln, private Netze oder private Automatisierung es verlangen. Dann gehören dir Verfügbarkeit, Aktualisierung der Images, Speicherplatz für temporäre Dateien, TLS und der Wechsel von Schlüsseln (SECURITY_CUSTOMGLOBALAPIKEY für eine feste Sperre auf deinem Rechner). Die Operationen bleiben gleich; geändert wird, wo die Bytes landen.

Ausprobieren

Beginne bei Selbst hosten und Entwickler. Zur API-Oberfläche für Agenten auf beiden Basis-URLs lies Für KI-Agenten gebaut, nicht nur für Browser. Eine ausführlichere Abwägung von Kosten und Nutzen bietet Was Selbst-Hosting wirklich bringt.