Schritt-für-Schritt-Anleitung zur Installation von Stirling PDF mit Docker

Die Installation von Stirling PDF mit Docker ermöglicht es Ihnen, die Anwendung in eine privater Server zur Verwaltung von PDF-DokumentenNach der Installation können Sie von jedem Computer, Mobiltelefon oder Tablet im Netzwerk über einen Webbrowser darauf zugreifen, ohne das Programm auf jedem Gerät installieren zu müssen.

Die Dateien werden an den von Ihnen konfigurierten Server gesendet, nicht an die Server von Stirling PDF. Dadurch haben Sie mehr Kontrolle über Ihre Dokumente, wobei die letztendliche Vertraulichkeit jedoch weiterhin von Ihnen abhängt. wo sich der Server befindet, wer darauf zugreifen kann und wie die Verbindung geschützt ist.

Wenn Sie das Tool nur auf einem einzigen PC verwenden, ist die native Anwendung möglicherweise einfacher. In diesem Fall erfahren Sie, wie. Stirling PDF unter Windows installieren ohne Docker zu konfigurieren oder einen Netzwerkdienst zu veröffentlichen.

Welches Stirling-PDF-Bild sollten Sie wählen?

Stirling PDF veröffentlicht drei Varianten seines Images. Die Wahl beeinflusst die verfügbaren Funktionen, den Speicherplatzbedarf und die benötigten Ressourcen.

Version	Etikett	Empfohlene Verwendung
Standard	latest	Die meisten Heimanwender und Server
Fett	latest-fat	Maximale Kompatibilität, zusätzliche Schriftarten und Werkzeuge
Ultraleicht	latest-ultra-lite	Raspberry Pi, kleine VPS und grundlegende Operationen

Das Bild latest Dies ist die empfohlene Option, wenn Sie keine besonderen Anforderungen haben. Sie umfasst die üblichen Verwaltungs-, Konvertierungs-, OCR- und Sicherheitsfunktionen bei gleichzeitig angemessener Größe.

Die Variante latest-fat Es enthält mehr Schriftarten und optionale Werkzeuge, was die Kompatibilität bei bestimmten Konvertierungen verbessern kann. Im Gegenzug benötigt es mehr Speicherplatz.

latest-ultra-lite Es reduziert Größe und Stromverbrauch bei Geräten mit begrenzter Leistung, bietet aber weniger Funktionen. Es eignet sich zum Zusammenführen, Teilen, Drehen oder Neuanordnen von Dokumenten auf einfachen Computern.

Sobald der Server installiert ist, werden Sie in der Lage sein, Mehrere PDFs mit Stirling PDF zusammenführenSeiten löschen, Dokumente neu anordnen oder Mehrere Bilder in eine einzelne PDF-Datei umwandeln.

Voraussetzungen für die Installation von Stirling PDF mit Docker

Für eine grundlegende Bereitstellung benötigen Sie:

• Docker Engine 20.10 oder höher.
• Docker Compose ist installiert.
• Mindestens 2 GB RAM erforderlich..
• Für einen Basistest werden mindestens 5 GB Speicherplatz benötigt.
• Ein Ordner, in dem dauerhafte Einstellungen gespeichert werden können.
• Zugriff auf ein Terminal oder eine Compose-kompatible Schnittstelle.

Für einen regelmäßig genutzten Server werden folgende Empfehlungen ausgesprochen: 2 CPU-Kerne, 4 GB RAM und 10 GB freier SpeicherplatzKonvertierungen, Rendering und OCR können ein Vielfaches der Dokumentgröße im Arbeitsspeicher benötigen.

Überprüfen Sie die Installation:

docker --version
docker compose version

In den aktuellen Systemen ist es vorzuziehen, docker composemit einem Leerzeichen. Einige ältere Benutzeroberflächen und Versionen zeigen dies weiterhin an. docker-composeAllerdings stehen die beiden Befehle nicht immer gleichzeitig zur Verfügung.

Schnelle Installation mit Docker Run

Um Stirling PDF auszuprobieren, ohne vorher eine Compose-Datei erstellt zu haben, führen Sie Folgendes aus:

docker run -d \
  --name stirling-pdf \
  -p 8080:8080 \
  -v ./stirling-data:/configs \
  docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest

Dann öffnen:

http://localhost:8080

Wenn Docker auf einem anderen Rechner läuft, ersetzen Sie localhost anhand ihrer IP-Adresse:

http://192.168.1.50:8080

Das Volumen ./stirling-data:/configs Die Einstellungen und die Datenbank bleiben erhalten, wenn der Container gelöscht oder aktualisiert wird.

Diese Methode eignet sich für einen schnellen Test. Für eine dauerhafte Installation ist Docker Compose komfortabler, da es Ports, Volumes, Variablen und Neustartrichtlinien dokumentiert.

Wie man persistente Ordner vorbereitet

Erstellen Sie einen Ordner für das Projekt und mehrere persistente Verzeichnisse:

mkdir -p ~/stirling-pdf/stirling-data/{configs,logs,pipeline,tessdata}
cd ~/stirling-pdf

Jedes Verzeichnis erfüllt eine andere Funktion:

• configs: Einstellungen und interne Datenbank.
• logs: Betriebs- und Fehlerprotokolle.
• pipeline: Konfigurationen für die automatisierte Verarbeitung.
• tessdata: linguistische Modelle, die von Tesseract verwendet werden.

Sie können auch ein Volumen erstellen für /customFiles Falls Sie Schriftarten, Designs, Signaturen oder andere benutzerdefinierte Dateien benötigen.

Es ist keine Konfiguration erforderlich. PUID y PGID in allen Installationen. Einige Community-Vorlagen für NAS oder Unraid verwenden diese Variablen, die offizielle Basiskonfiguration basiert jedoch auf den Berechtigungen der eingebundenen Ordner.

So installieren Sie Stirling PDF mit Docker Compose

Innerhalb ~/stirling-pdf, erstellt eine Datei namens docker-compose.yml mit diesem Inhalt:

services:
  stirling-pdf:
    image: docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest
    container_name: stirling-pdf
    ports:
      - "8080:8080"
    volumes:
      - ./stirling-data/configs:/configs
      - ./stirling-data/logs:/logs
      - ./stirling-data/pipeline:/pipeline
      - ./stirling-data/tessdata:/usr/share/tessdata
    environment:
      SECURITY_ENABLELOGIN: "true"
      SECURITY_INITIALLOGIN_USERNAME: "admin"
      SECURITY_INITIALLOGIN_PASSWORD: "${STIRLING_ADMIN_PASSWORD}"
      SYSTEM_DEFAULTLOCALE: "es-ES"
    restart: unless-stopped

Es erstellt außerdem eine Datei .env im selben Ordner:

STIRLING_ADMIN_PASSWORD=INTRODUCE_UNA_CONTRASEÑA_SEGURA

Schützen Sie die Datei so, dass nur Ihr Benutzer sie lesen kann:

chmod 600 .env

Dann startet der Dienst:

docker compose up -d

Überprüfen Sie den Status:

docker compose ps

Der Container sollte als gestartet angezeigt werden. Beim ersten Start kann es einige Sekunden dauern, bis die Datenbank und die internen Komponenten vorbereitet sind.

So konfigurieren Sie die Sprache und die Authentifizierung

Aktuelle Docker-Images haben die Anmeldung standardmäßig aktiviertWenn Sie keine anfänglichen Anmeldeinformationen festlegen, wird ein Konto mit folgenden Daten erstellt:

• Benutzer: admin
• Passwort: stirling

Sie müssen dieses Passwort umgehend ändern. Die bisherige Konfiguration verhindert dessen Verwendung, da Sie von der ersten Bereitstellung an ein eigenes Passwort festlegen müssen.

Die Variablen SECURITY_INITIALLOGIN_USERNAME y SECURITY_INITIALLOGIN_PASSWORD Diese Angaben werden bei der Erstellung des ersten Benutzerkontos verwendet. Sie können nicht dazu verwendet werden, das Passwort eines bestehenden Benutzers nachträglich zu ändern; diese Änderung muss über die Benutzeroberfläche vorgenommen werden.

Wenn der Server vollständig isoliert ist und Sie ihn ohne Authentifizierung nutzen möchten, können Sie Folgendes angeben:

SECURITY_ENABLELOGIN: "false"

Deaktivieren Sie die Authentifizierung nicht, wenn andere Benutzer den Port erreichen können, wenn Sie ein gemeinsam genutztes Netzwerk verwenden oder wenn Sie den Dienst im Internet veröffentlichen wollen.

Um Spanisch als Standardsprache festzulegen, lautet die aktuelle Variable:

SYSTEM_DEFAULTLOCALE: "es-ES"

Wenn keine Sprache festgelegt ist, versucht Stirling PDF, die Browsersprache zu erkennen. Um die verfügbaren Sprachen in der Sprachauswahl einzuschränken, können Sie Folgendes verwenden: UI_LANGUAGES, deren Codes Unterstriche verwenden:

UI_LANGUAGES: "es_ES,en_US"

Wie man OCR auf Spanisch hinzufügt

Stirling PDF verwendet Tesseract zur Texterkennung in gescannten Dokumenten. OCR extrahiert den Text, aber Es erstellt Tabellen, Formeln oder komplexe Strukturen nicht automatisch neu..

Um spanische Dokumente zu erkennen, laden Sie die Datei herunter. spa.traineddata Laden Sie es aus den offiziellen Tesseract-Repositories herunter und speichern Sie es unter:

~/stirling-pdf/stirling-data/tessdata

Der Ordner ist verbunden mit /usr/share/tessdata innerhalb des Containers mithilfe der Compose-Datei.

Nicht löschen eng.traineddataStirling PDF muss die englische Vorlage beibehalten, auch wenn Sie andere Sprachen hinzufügen.

Sie können zwischen folgenden Optionen wählen:

• tessdata_fast: Kleinere, schnellere Dateien, jedoch möglicherweise mit geringerer Genauigkeit.
• tessdata: schwerere Modelle, die bessere Ergebnisse liefern können.

Nach dem Hinzufügen der Datei muss der Container neu gestartet werden:

docker compose restart stirling-pdf

OCR ermöglicht es Ihnen, einen Scan in ein durchsuchbares PDF umzuwandeln. Falls Sie den Inhalt später bearbeiten müssen, können Sie dies tun. PDF mit Stirling PDF in Word konvertierenDabei ist zu beachten, dass die Wiedergabetreue vom ursprünglichen Design abhängt.

Wie kann man von anderen Geräten im Netzwerk darauf zugreifen?

Ermitteln Sie die IP-Adresse des Rechners, auf dem Docker ausgeführt wird, und öffnen Sie ihn von einem anderen Gerät aus:

http://DIRECCION_IP:8080

Zum Beispiel:

http://192.168.1.50:8080

Falls die Seite nicht geladen wird, überprüfen Sie, ob die Firewall TCP-Verbindungen zu Port 8080 aus dem lokalen Netzwerk zulässt.

Sie müssen den Port an Ihrem Router nicht freigeben, um ihn in Ihrem Heim- oder Büronetzwerk zu nutzen. Wenn Sie ihn auf Ihr lokales Netzwerk (LAN) beschränken, verringert sich die Angriffsfläche.

Über die Benutzeroberfläche können Sie beispielsweise folgende Vorgänge durchführen: Leere Seiten löschen und Dokumente bearbeiten, Anmerkungen hinzufügen oder Fügen Sie einem PDF ein Wasserzeichen hinzu.

Wie man sicher aus der Ferne zugreift

Port 8080 sollte nicht direkt über die Portweiterleitung des Routers ins Internet freigegeben werden. Die Verbindung würde über HTTP laufen und wäre somit für Tracker oder Angreifer zugänglich.

Die sichersten Alternativen sind:

• Zugriff über einen Privates VPN wie WireGuard oder Tailscale.
• Verwenden Sie einen Reverse-Proxy mit einer Domain und einem HTTPS-Zertifikat.
• Konfigurieren Sie einen authentifizierten Tunnel als Cloudflare-Tunnel.

Nginx, Caddy oder Traefik können als Reverse-Proxy fungieren und HTTPS-Anfragen an den Container senden. http://localhost:8080Das Zertifikat kann mit Let's Encrypt oder mit dem Domain-Anbieter verwaltet werden.

Die Stirling-PDF-Authentifizierung muss auch dann aktiviert bleiben, wenn die Verbindung bereits durch einen Proxy geschützt ist. Die HTTPS-Verschlüsselung sichert die Übertragung, während die Anmeldung steuert, wer die Anwendung nutzen darf.

So installieren Sie Stirling PDF auf einem Raspberry Pi oder einem NAS

Auf einem Raspberry Pi mit begrenzten Ressourcen können Sie das Image wie folgt ändern:

docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest-ultra-lite

Einfache Vorgänge sollten einwandfrei funktionieren, OCR, Office-Konvertierungen und die Verarbeitung großer Dokumente können jedoch langsam sein oder den verfügbaren Speicherplatz überschreiten.

Auf Synology, QNAP und anderen kompatiblen NAS-Geräten können Sie dieselbe Datei mit Docker Compose, Container Manager oder Portainer bereitstellen. Öffnen Sie dazu in Portainer die Datei. Stapel > Stapel hinzufügenFügen Sie die Konfiguration ein und passen Sie die Pfade so an, dass sie auf persistente freigegebene Ordner verweisen.

Überprüfen Sie die Schreibberechtigungen auf configs, logs, pipeline y tessdataVerwenden PUID y PGID nur dann, wenn die jeweilige NAS-Vorlage dies zulässt.

Wie man die Leistung anpasst

Eine kleine Geräteinstallation kann beginnen mit 2 Kerne, 4 GB RAM und 10 GB freier SpeicherplatzDokumente mit vielen Seiten, eingebetteten Schriftarten oder Vektorgrafiken können sich während der Verarbeitung erheblich vergrößern.

Die anspruchsvollsten Operationen sind in der Regel:

• OCR mit Tesseract oder OCRmyPDF.
• Dokumente mit LibreOffice konvertieren.
• PDFs in Bilder umwandeln.
• Komprimierung und Reparatur großer Dateien.

Erhöhen Sie die Grenzwerte für die gleichzeitige Verarbeitung nicht, ohne den Arbeitsspeicher zu überwachen. Auf Servern mit geringerer Leistung ist es ratsam, Dokumente in der Warteschlange zu verarbeiten, anstatt einen Fehler aufgrund von unzureichendem Arbeitsspeicher zu riskieren.

Wenn der Server von mehreren Benutzern bedient wird, überprüfen Sie die Auslastung mit folgendem Befehl:

docker stats stirling-pdf

Wie man Stirling PDF aktualisiert, ohne Daten zu verlieren

Vor dem Aktualisieren sollten Sie eine Kopie der persistenten Ordner, der Compose-Datei und der Datei erstellen. .env:

tar -czf stirling-backup.tar.gz \
  stirling-data docker-compose.yml .env

Speichern Sie die Kopie auf einem anderen Gerät oder Speichersystem. Die Datei .env Es enthält das anfängliche Passwort und muss geschützt bleiben.

Aktualisieren Sie anschließend das Bild:

docker compose down
docker compose pull
docker compose up -d

Die Daten verbleiben in den eingebundenen Ordnern. Auf einem kritischen Server empfiehlt es sich, diese zu ersetzen. latest durch eine bestimmte Version, um zu steuern, wann Änderungen angewendet werden.

Häufige Fehler bei der Installation von Stirling PDF mit Docker

Docker kann das frooodle/s-pdf-Image nicht finden.

Alte Anleitungen verwendet frooodle/s-pdfErsetzen Sie diese Referenz durch:

docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest

Wenn die Hauptregistrierung nicht reagiert, können Sie auch Folgendes verwenden:

ghcr.io/stirling-tools/stirling-pdf:latest

Hafen 8080 ist bereits belegt

Ändern Sie nur den Port auf dem Host-Computer:

ports:
  - "9000:8080"

Dann Zugriff über http://localhost:9000.

Der Container startet ständig neu.

Überprüfen Sie die Aufzeichnungen:

docker logs stirling-pdf

Prüfen Sie den verfügbaren Speicherplatz, den Arbeitsspeicher und die Schreibberechtigungen der Volumes. Testen Sie das Image auf Systemen mit begrenzten Ressourcen. latest-ultra-lite.

Die Einstellungen verschwinden nach dem Update.

Das Volumen /configs Es ist nicht korrekt eingebunden oder verweist auf einen anderen Ordner. Überprüfen Sie den Pfad innerhalb docker-compose.yml und dass der Containerbenutzer darin schreiben kann.

Die Benutzeroberfläche ist nicht auf Spanisch verfügbar.

Verwenden SYSTEM_DEFAULTLOCALE=es-ESDie alte Variable LANGS=es_ES Die Standardsprache wird in der aktuellen Konfiguration nicht festgelegt.

OCR zeigt kein Spanisch an

Überprüfen Sie das. spa.traineddata existiert innerhalb des eingebundenen Ordners und das Volume verweist auf /usr/share/tessdataEs bewahrt auch eng.traineddata.

Ich kann mich nicht einloggen

Bei einer Neuinstallation ohne benutzerdefinierte Anmeldeinformationen testen admin y stirling Ändern Sie umgehend das Passwort. Falls die Datenbank bereits existiert, werden die gespeicherten Anmeldeinformationen durch die anfänglichen Startvariablen nicht überschrieben.

Zugriff verweigert beim Verwenden eines Volumes

Erstellen Sie die Ordner vor dem Start des Containers und überprüfen Sie deren Eigentümer und Berechtigungen. Verwenden Sie globale Schreibberechtigungen nicht wahllos und konfigurieren Sie diese nicht falsch. 777 als dauerhafte Lösung.

Die Anwendung funktioniert lokal, aber nicht von einem anderen Computer aus.

Prüfen Sie, ob Sie die IP-Adresse des Servers verwenden, ob der Port geöffnet ist und ob die Firewall Verbindungen aus dem lokalen Netzwerk zulässt. localhost Es bezieht sich immer auf das Gerät, von dem aus Sie den Browser öffnen.

Bei großen Dateien geht dem Server der Speicherplatz aus.

Reduzieren Sie die Anzahl gleichzeitiger Operationen; verwenden Sie die Ultra-Lite-Variante, wenn Sie keine erweiterten Funktionen benötigen, oder erhöhen Sie Ihren Arbeitsspeicher. OCR und Rendering können ein Vielfaches der Größe der Originaldatei beanspruchen.

Durch die Installation von Stirling PDF mit Docker können Sie allen Geräten in einem Netzwerk eine zentrale Dokumentenmanagement-Plattform bereitstellen. Das Standard-Image eignet sich für die meisten Benutzer, während die Varianten Fat und Ultra-Lite es Ihnen ermöglichen, entweder die Kompatibilität oder den Ressourcenverbrauch zu priorisieren.

Entscheidend ist die korrekte Einbindung der Volumes, die Authentifizierung, die Konfiguration der OCR nur bei Bedarf und der Schutz des Fernzugriffs per VPN oder HTTPS. Sie sollten außerdem Ihre Daten sichern. /configs vor dem Aktualisieren, da es die Installationseinstellungen und die Datenbank enthält.