Installation Overview

This article was translated from English: Does it need improvement?
Translated
View the article in English

Vollständiger Leitfaden zur Installation und Konfiguration von IronPDF auf allen Plattformen.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    IronPdf.ChromePdfRenderer
           .StaticRenderHtmlAsPdf("<p>Hello World</p>")
           .SaveAs("pixelperfect.pdf");
  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer

1. Plattformanforderungen

Plattform .NET Version Hardware Zusätzliche Anforderungen, Kompatibilität
Logo Table Windows related to 1. Plattformanforderungen
Windows
.NET 10, 9, 8, 7, 6, 5, .NET Core, .NET Standard und .NET Framework.
  • Minimum: 1 Kern & 1,75 GB RAM
  • Empfohlen: 2 Kerne & 8 GB RAM oder mehr
  • Windows 10, 11 und Windows Server
  • Visual C++ Redistributable (x86 & x64)
Logo Table Linux related to 1. Plattformanforderungen
Linux
  • 64-Bit Linux OSs: Ubuntu 22, Ubuntu 20, Ubuntu 18, Ubuntu 16, Debian 10-11m CentOS 8, Fedora Linux 33, Amazon, AWS, Linux 2
  • IronCefSubprocess
  • Chrome-Abhängigkeiten
Logo Table Mac related to 1. Plattformanforderungen
macOS
Alle macOS-Versionen seit 2020

2. Installationsmethoden

Es gibt zwei Möglichkeiten, IronPDF zu installieren: nativer Modus und Remote-Engine. Standardmäßig wird der native Modus empfohlen. Für die Bereitstellung auf Produktionsservern mit Docker/Kubernetes verwenden Sie den Remote-Engine-Modus.

class="col-6">
class="install-mode">
class="install-mode__header"> class="install-mode__title">Remote-Engine-Modus class="install-mode__subtitle">Getrennte PDF-Verarbeitung über gRPC-Protokoll.
class="install-mode__body">
  • Am besten geeignet für: Cloud- und containerisierte Bereitstellungen, Unterstützung für ältere Betriebssysteme.
  • Paket: IronPdf.Slim
  • Größe: Leichter, nur wenige MB.
  • Anforderungen: Erfordert die Konfiguration der Verbindung zum Host.
class="col-6">

3. Installationsoptionen

Die Installation der C# PDF-Bibliothek dauert weniger als 5 Minuten. Laden Sie es kostenlos über NuGet oder direkten Download herunter und beginnen Sie sofort mit der Verwendung in Visual Studio.

data-active-tab="1">
class="installation-options__tabs">
data-tab="1"> NuGet-Paket
data-tab="2"> Manueller Download
data-tab="3"> Remote IronPdfEngine
data-tab="1">
data-tab="2">
data-tab="3">
id="nuget-package-start">

Gehen Sie zur IronPDF NuGet-Bibliothek (oder Paketmanager-Konsole in Visual Studio)

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise
  2. Wählen Sie 'NuGet-Pakete verwalten' > 'Durchsuchen' > Suchen Sie IronPdf
  3. Wählen Sie das Paket aus und installieren Sie es.
Install-Package IronPdf

class="related-link">VERWANDT: Mehr erweiterte IronPDF Nuget-Pakete

id="nuget-package-end">
id="manual-download-start">
  1. Laden Sie das IronPDF DLL-Paket für Ihre Plattform herunter: Windows, Linux, macOS
  2. Entzippen Sie die ZIP-Datei für Ihr Betriebssystem an einen Ort innerhalb Ihres Projektverzeichnisses.
  3. Klicken Sie im Visual Studio-Projektmappen-Explorer mit der rechten Maustaste auf 'Abhängigkeiten'.
  4. 'Projektverweis hinzufügen' > Wählen Sie 'Durchsuchen', um alle aus der ZIP extrahierten DLLs einzuschließen.
id="manual-download-end">
id="remote-ironpdfengine-start">

Hinweis:Bitte beachten: Jede IronPDF-Version erfordert die passende Version von IronPdfEngine. Cross-Version-Unterstützung ist nicht verfügbar. Zum Beispiel muss IronPDF 2024.2.2 IronPdfEngine 2024.2.2 verwenden.

Installieren Sie IronPdf mit NuGet.

Install-Package IronPdf.Slim
id="remote-ironpdfengine-end">

4. Zusätzliche Konfigurationen

data-active-tab="1">
class="installation-options__tabs">
data-tab="1"> Lizenz verwalten
data-tab="2"> Pfad & Berechtigung
data-tab="3"> Remote-Engine
data-tab="1">
data-tab="2">
data-tab="3">
id="manage-license-start">

Nachdem Sie eine 30-tägige Testversion von IronPDF gekauft oder registriert haben, finden Sie den Lizenzschlüssel in Ihrer E-Mail.

Fügen Sie Ihren Lizenzschlüssel am Anfang Ihrer Anwendung hinzu.

IronPdf.License.LicenseKey = "KEY";
IronPdf.License.LicenseKey = "KEY";
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Überprüfen Sie den Lizenzstatus.

bool valid = IronPdf.License.IsLicensed;
bool valid = IronPdf.License.IsLicensed;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel
id="manage-license-end">
id="path-permission-start">

Stellen Sie die TempFolderPath-Eigenschaft des IronPdf.Installation-Objekts ein.

IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";
IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";
IronPdf.Installation.TempFolderPath = "C:\My\Safe\Path"
$vbLabelText   $csharpLabel

TippsStellen Sie sicher, dass Sie alle temporären und Cache-Ordner auf Ihren Entwicklungs- und Serviermaschinen löschen und dann eine bereinigte Version Ihrer Anwendung neu bereitstellen, nachdem Sie einen Pfad aktualisiert haben.

Umgebungsvariable für den temporären Ordner im Anwendungskontext setzen.

using IronPdf;

// Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
using IronPdf;

// Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

TippsBei einem gesperrten Server geben Sie dem IIS-Benutzer (IUSER) Lese- und Schreibrechte für Ihr Installationspfadverzeichnis sowie für Ihr Windows- und Temp-Verzeichnis.

id="path-permission-end">
id="remote-engine-start">

[Remote IronPdfEngine] Nach der Installation des IronPdf.Slim-Pakets verbinden Sie sich mit dem Engine-Container und konfigurieren die Verbindung beim Anwendungsstart oder bevor Sie eine IronPDF-Methode aufrufen.

Angenommen, IronPdfEngine läuft remote auf 123.456.7.8:33350:

Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

class="related-link">VERWANDT: Einschränkungen von IronPdfEngine

[Linux] Aktivieren Sie IronPDF, um alle erforderlichen Linux-Abhängigkeiten automatisch zu installieren. Der erste HTML-zu-PDF-Vorgang kann länger als gewöhnlich dauern.

Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

[Docker] Chrome-Engine vorab initialisieren, um Voraussetzungen vorzuladen und die erste Nutzung in Docker zu beschleunigen.

IronPdf.Installation.Initialize();
IronPdf.Installation.Initialize();
IronPdf.Installation.Initialize()
$vbLabelText   $csharpLabel

class="related-link">VERWANDT: IronPDF Linux Docker-Kompatibilität und Einrichtung

id="remote-engine-end">

5. Bereitstellungsszenarien

class="col-6">
class="deployment-card">
class="deployment-card__icon"> Logo Azure related to 5. Bereitstellungsszenarien
class="deployment-card__info">

class="deployment-card__title">IronPDF .NET ausführen & bereitstellen auf

Azure Function
class="col-6">
class="deployment-card">
class="deployment-card__icon"> Logo Aws related to 5. Bereitstellungsszenarien
class="deployment-card__info">

class="deployment-card__title">IronPDF .NET ausführen & bereitstellen auf

AWS Lambda
class="col-6">
class="deployment-card">
class="deployment-card__icon"> Logo Linux related to 5. Bereitstellungsszenarien
class="deployment-card__info">

class="deployment-card__title">IronPDF ausführen in

Linux Docker Container
class="col-6">
class="deployment-card">
class="deployment-card__icon"> Logo Remote related to 5. Bereitstellungsszenarien
class="deployment-card__info">

class="deployment-card__title">IronPDF ausführen als

Remote-Container

Nächste Schritte


Häufig gestellte Fragen

Wie kann ich IronPdfEngine für die entfernte PDF-Erstellung einrichten?

Um IronPdfEngine für die entfernte PDF-Erstellung einzurichten, installieren Sie das IronPdf.Slim-Paket von NuGet und konfigurieren Sie die Verbindungseinstellungen mit der IronPdfConnectionConfiguration-Klasse. Diese Einrichtung ermöglicht es Ihnen, Ihre Anwendung mit der IronPdfEngine-Instanz remote zu verbinden.

Was sind die Hauptvorteile der Verwendung von IronPdfEngine mit meiner Anwendung?

Die Verwendung von IronPdfEngine mit Ihrer Anwendung ermöglicht die Remote-Ausführung von PDF-Aufgaben, was hilft, plattformspezifische Kompatibilitätsprobleme zu vermeiden, insbesondere auf älteren Systemen und mobilen Plattformen. Es eliminiert auch die Notwendigkeit der .NET-Laufzeit während der Ausführung.

Warum könnte ich mich entscheiden, IronPdfEngine anstelle der nativen PDF-Bibliothek zu verwenden?

Sie könnten sich für IronPdfEngine entscheiden, um leistungsintensive PDF-Funktionen remote auszuführen, die Kompatibilitätsprobleme mit verschiedenen Betriebssystemen zu reduzieren und die Leistung zu verbessern, indem ein Chrome-identischer Renderer für die Umwandlung von HTML in PDF genutzt wird.

Wird horizontale Skalierung in IronPdfEngine unterstützt?

Nein, IronPdfEngine unterstützt derzeit keine horizontale Skalierung, was bedeutet, dass es nicht über mehrere Instanzen hinweg geladen werden kann, da PDF-Datei-Binärdaten im Serverspeicher gehandhabt werden.

Kann IronPdfEngine unter verschiedenen Betriebssystemen ausgeführt werden?

IronPdfEngine ist darauf ausgelegt, auf Linux-Systemen mithilfe von Docker-Containern zu laufen. Die Binärdateien sind jedoch plattformabhängig, daher müssen Sie sicherstellen, dass Sie die richtige Version für Ihr Betriebssystem verwenden.

Was sollte ich tun, wenn meine PDF-Ausgaben unterschiedlich sind, wenn ich IronPdfEngine verwende?

PDF-Ausgaben können aufgrund unterschiedlicher Betriebssystemverhalten leicht variieren. Um Unterschiede zu minimieren, stellen Sie sicher, dass Sie das richtige Docker-Image verwenden und überprüfen Sie eventuell bestehende, betriebssystemspezifische Einstellungen, die das Rendering beeinflussen könnten.

Wie stelle ich sicher, dass meine Anwendung die richtige Version von IronPdfEngine verwendet?

Um Kompatibilität sicherzustellen, erfordert jede Version von IronPDF eine passende Version von IronPdfEngine. Stellen Sie sicher, dass Sie beide Komponenten gleichzeitig aktualisieren, um Probleme zwischen den Versionen zu vermeiden.

Welche Einschränkungen gibt es bei der Verwendung von IronPdfEngine auf Windows?

Bei der Verwendung von IronPdfEngine auf Windows benötigen Sie Linux-Container für Docker und müssen sicherstellen, dass der Serverport erreichbar ist. Die Binärdateien sind plattformspezifisch und der Wechsel zu Linux-Containern ist erforderlich.

Wie konfiguriere ich IronPDF für die Verbindung zu einem entfernten IronPdfEngine-Server?

Um IronPDF für einen entfernten Server zu konfigurieren, verwenden Sie Installation.ConnectToIronPdfHost mit der Methode IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer und spezifizieren Sie die IP- und Port-Details des Servers.

Welches Paket sollte ich verwenden, um die Anwendungsgröße bei Verwendung von IronPdfEngine zu minimieren?

Sie sollten das IronPdf.Slim-Paket von NuGet verwenden, da es nur die notwendigen Komponenten für den Betrieb von IronPDF mit IronPdfEngine enthält und so die Anwendungsgröße reduziert.

Curtis Chau
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 ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 16,133,208 | Version: 2025.11 gerade veröffentlicht