How to Use IronPdfEngine

Aktualisiert:Juni 1, 2025

Translated

View the article in English

IronPdfEngine ist ein gRPC-Server, der zur Überwachung einer Reihe von IronPDF-Aufgaben entwickelt wurde, die die Erstellung, Bearbeitung und das Lesen von PDF-Dokumenten umfassen.

Wie man IronPdfEngine in Node.js verwendet

Installieren Sie die Node.js-Bibliothek, um IronPdfEngine zu nutzen.
Binden Sie die Bibliothek ein, indem Sie sie mit npm installieren.
Holen Sie die Chrome-Binärdatei über die gleiche Installation.
Überprüfen Sie die benötigte Version, indem Sie auf die Eigenschaft `ironPdfEngineVersion` zugreifen.
Verwenden Sie die IronPdfEngine, um HTML in PDF mit einem identischen Renderer wie in Chrome zu rendern.

Erste Schritte mit IronPDF

IronPdf Node.js und IronPdfEngine

IronPDF for Node.js erfordert IronPdfEngine zur Ausführung. Der Node.js-Code ist lediglich eine API-Maske über die IronPdfEngine gRPC. Wenn Sie also eine beliebige Methode in IronPDF for Node.js aufrufen, geschieht die Magie in der IronPdfEngine!

Standardmäßig startet IronPDF for Node.js IronPdfEngine als Unterprozess und kommuniziert mit ihm, bis Ihre Anwendung beendet wird.

Hinweis: Für jede Version von IronPDF for Node.js ist eine bestimmte Version von IronPdfEngine erforderlich. Cross-versions werden nicht unterstützt.

IronPdf for Node.js mit lokaler IronPdfEngine

Option 1: IronPdfEngine zur Laufzeit herunterladen

Nach der Installation von IronPdf in Ihrem JavaScript-Projekt erkennt IronPdf bei der ersten Ausführung standardmäßig Ihre Plattform (z. B. Windows x64) und lädt die richtigen IronPdfEngine-Binärdateien aus dem Internet herunter.

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

SHELL

Vorteile:

Ihr Bewerbungspaket wird klein sein.
Kann auf vielen Plattformen eingesetzt werden.

Nachteile:

Für die ersten Durchläufe wird ein Internetzugang benötigt.
Langsame Startzeit.

Option 2 (empfohlen): IronPdfEngine als Abhängigkeit installieren

IronPDF for Node.js ermöglicht es Ihnen, IronPdfEngine als Abhängigkeit hinzuzufügen. Diese IronPdfEngine-Abhängigkeiten bündeln IronPdfEngine zu einer .zip-Datei und entpacken und verwenden sie automatisch.

Sie können wählen, ob Sie eine oder mehrere dieser IronPdfEngine-Abhängigkeiten installieren möchten.

Hinweis: Die Versionen der Abhängigkeiten ironpdf und ironpdf-engine-xxx-xxx müssen identisch sein. Die ironpdf-engine-xxx-xxx-Abhängigkeitsversion bezieht sich nicht auf die Version von IronPdfEngine.

Plattformspezifische Installation:

Windows x64:

npm install @ironsoftware/ironpdf-engine-windows-x64

npm install @ironsoftware/ironpdf-engine-windows-x64

SHELL

Windows x86:

npm install @ironsoftware/ironpdf-engine-windows-x86

npm install @ironsoftware/ironpdf-engine-windows-x86

SHELL

Linux x64:

npm install @ironsoftware/ironpdf-engine-linux-x64

npm install @ironsoftware/ironpdf-engine-linux-x64

SHELL

macOS x64:

npm install @ironsoftware/ironpdf-engine-macos-x64

npm install @ironsoftware/ironpdf-engine-macos-x64

SHELL

macOS arm:

npm install @ironsoftware/ironpdf-engine-macos-arm64

npm install @ironsoftware/ironpdf-engine-macos-arm64

SHELL

Vorteile:

Schnellere Startzeit.
Nach der Installation der Abhängigkeit ist kein Internetzugang erforderlich.

Nachteile:

Ihr Bewerbungspaket wird umfangreich sein.
Die Zielplattformen müssen angegeben werden.

IronPdf for Node.js mit Remote IronPdfEngine

Für die Verwendung einer entfernten IronPdfEngine wird eine bestimmte Version von IronPdfEngine benötigt. Wenn zum Beispiel IronPDF for Node.js Version 2024.2.2 IronPdfEngine Version 2024.2.2 erfordert, verwenden Sie nicht IronPdfEngine Version 2024.2.1. Greifen Sie auf die ironPdfEngineVersion Eigenschaft zu, um die benötigte Version zu überprüfen.

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;

JAVASCRIPT

Anschlussmöglichkeiten

Nehmen wir an, dass IronPdfEngine per Fernzugriff unter 123.456.7.8:33350 läuft.

Siehe "How to Pull and Run IronPdfEngine".

Um eine Verbindung herzustellen, müssen Sie lediglich angeben, wo sich IronPdfEngine befindet (stellen Sie sicher, dass die Adresse zugänglich ist und nicht durch eine Firewall blockiert wird). Fügen Sie diesen Code in der Anfangsphase Ihrer Anwendung oder kurz vor dem Aufruf einer IronPdf-Methode ein.

IronPdfGlobalConfig.setConfig({
    ironPdfEngineDockerAddress: "123.456.7.8:33350"
});

IronPdfGlobalConfig.setConfig({
    ironPdfEngineDockerAddress: "123.456.7.8:33350"
});

JAVASCRIPT

So einfach ist das! Danach wird Ihre Anwendung mit einer Remote IronPdfEngine verbunden!

Für Remote IronPdfEngine ist die Installation von IronPdfEngine als Abhängigkeit nicht erforderlich. Sie können den Abschnitt "Option 2 (empfohlen) IronPdfEngine als Abhängigkeit zu installieren" überspringen

Häufig gestellte Fragen

Wofür wird IronPdfEngine in Node.js verwendet?

IronPdfEngine ist ein gRPC-Server, der in Node.js zur Verwaltung von PDF-Aufgaben wie Erstellung, Bearbeitung und Rendering verwendet wird und ein nahtloses PDF-Handling-Erlebnis bietet.

Wie kann ich IronPDF für Node.js installieren?

Sie können IronPDF für Node.js mit npm und dem Befehl npm install @ironsoftware/ironpdf installieren.

Was sind die Unterschiede zwischen lokalen und entfernten Setups für IronPdfEngine?

Ein lokales Setup beinhaltet entweder das Herunterladen von IronPdfEngine zur Laufzeit oder die Installation als Abhängigkeit, was schnellere Startzeiten bietet. Ein entferntes Setup verbindet sich mit einem entfernten IronPdfEngine-Host, wodurch lokale Installationen überflüssig werden.

Wie stelle ich die Kompatibilität zwischen IronPdf- und IronPdfEngine-Versionen sicher?

Jede Version von IronPdf für Node.js erfordert eine spezifische Version von IronPdfEngine. Verwenden Sie die ironPdfEngineVersion-Eigenschaft, um die erforderliche Version zu überprüfen und sicherzustellen, dass beide Versionen übereinstimmen.

Welche Vorteile hat die Installation von IronPdfEngine als Abhängigkeit?

Die Installation von IronPdfEngine als Abhängigkeit führt zu schnelleren Startzeiten und beseitigt die Notwendigkeit eines Internetzugangs nach der Installation, obwohl die Anwendungsgröße zunimmt.

Wie kann ich mich mit einem entfernten IronPdfEngine verbinden?

Um sich mit einem entfernten IronPdfEngine zu verbinden, verwenden Sie IronPdfGlobalConfig.setConfig, um die Serveradresse anzugeben und sicherzustellen, dass sie zugänglich und nicht durch eine Firewall blockiert ist.

Ist für den Laufzeit-Download von IronPdfEngine ein Internetzugang erforderlich?

Ja, für die ersten Ausführungen ist ein Internetzugang erforderlich, wenn IronPdfEngine zur Laufzeit heruntergeladen wird, was auch zu langsameren Startzeiten führt.

Muss ich IronPdfEngine für die Fernnutzung installieren?

Nein, bei Verwendung eines entfernten IronPdfEngine müssen Sie es nicht lokal als Abhängigkeit installieren.

Kann IronPdfEngine auf verschiedenen Plattformen verwendet werden?

Ja, IronPdfEngine kann auf mehreren Plattformen eingesetzt werden. Plattform-spezifische npm-Befehle sind für Installationen auf Windows, Linux und macOS verfügbar.

Ist IronPDF mit .NET 10 kompatibel und welche Umgebungen werden unterstützt?

Ja, IronPDF ist vollständig kompatibel mit .NET 10 (sowie .NET 9, 8, 7 usw.). Es unterstützt C#, VB.NET und F# und funktioniert plattformübergreifend unter Windows, Linux und macOS – einschließlich Docker- und Cloud-Umgebungen – und eignet sich daher für .NET 10-Web-, Desktop-, Konsolen- und Cloud-Projekte.

Curtis Chau

Jetzt mit dem Ingenieurteam chatten

Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Bereit anzufangen?

Version: 2025.11 gerade veröffentlicht

Lizenzen anzeigen