1. IronPDF
  2. Erste Schritte
  3. Installationsübersicht

Installationsübersicht

Curtis Chau
Curtis Chau
Aktualisiert:
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 IconLegen Sie jetzt mit NuGet los, um PDFs zu erstellen:

  1. Installieren Sie IronPDF mit dem NuGet-Paketmanager.

    PM > Install-Package IronPdf

  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    IronPdf.ChromePdfRenderer
       .StaticRenderHtmlAsPdf("<p>Hello World</p>")
       .SaveAs("pixelperfect.pdf");

  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute mit der Nutzung von IronPDF in Ihrem Projekt – mit einer kostenlosen Testversion.
    arrow pointer

1. Plattformanforderungen

Platform .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.
  • Mindestanforderungen: 1 Kern und 1,75 GB RAM
  • Empfohlen: 2 Kerne und 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-Betriebssysteme: 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.

Remote Engine Mode Separate PDF-Verarbeitung über gRPC-Protokoll.
  • Ideal geeignet für: Cloud- und containerisierte Bereitstellungen, Unterstützung älterer Betriebssysteme.
  • Paket: IronPdf.Slim
  • Größe: Leichter, benötigt nur wenige Megabyte.
  • Voraussetzungen: Die Verbindung zum Host muss konfiguriert werden.
Nativer Modus (Standard) Alles läuft lokal in Ihrer Anwendung.
Float Recommended related to 2. Installationsmethoden
  • Ideal für: Moderne Windows-, macOS- und Linux-Systeme.
  • Paket: Vollständiges IronPdf NuGet-Paket.
  • Größe: Deutlich größer (mehrere hundert MB), einschließlich der Binärdateien von Chrome und Pdfium.
  • Systemvoraussetzungen: Funktioniert auf modernen Betriebssystemen.

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.

NuGet-Paket
Handbuch herunterladen
Remote IronPdfEngine

Rufen Sie die IronPDF NuGet-Bibliothek auf (oder die Paketmanager-Konsole in Visual Studio)

  1. Rechtsklick auf Verweise im Projektmappen-Explorer
  2. Wählen Sie 'NuGet-Pakete verwalten' > 'Durchsuchen' > Suchen Sie IronPdf
  3. Paket auswählen und installieren.
Install-Package IronPdf

VERWANDT: Erweiterte IronPDF NuGet-Pakete

  1. Laden Sie das IronPDF-DLL-Paket für Ihre Plattform herunter: Windows, Linux, macOS
  2. Entpacken Sie die ZIP-Datei für Ihr Betriebssystem in ein Verzeichnis innerhalb Ihres Projektmappenverzeichnisses.
  3. Klicken Sie im Visual Studio Projektmappen-Explorer mit der rechten Maustaste auf "Abhängigkeiten".
  4. projektreferenz hinzufügen" > Wählen Sie "Durchsuchen", um alle aus der ZIP-Datei extrahierten DLLs einzuschließen.

Hinweis:Bitte beachten Sie: Jede IronPDF-Version erfordert die entsprechende Version von IronPdfEngine. Versionsübergreifende Unterstützung ist nicht verfügbar. IronPDF 2024.2.2 muss zum Beispiel IronPdfEngine 2024.2.2.
verwenden

Installieren Sie IronPdf mit NuGet.

Install-Package IronPdf.Slim

4. Zusätzliche Konfigurationen

Lizenz verwalten
Path & Permission
Ferngesteuerte Maschine

Nachdem Sie IronPDF gekauft oder sich für eine 30-tägige Testversion angemeldet haben, finden Sie den Lizenzschlüssel, der Ihnen per E-Mail zugesandt wurde.

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

Lizenzstatus überprüfen.

bool valid = IronPdf.License.IsLicensed;
bool valid = IronPdf.License.IsLicensed;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Setzen Sie die TempFolderPath-Eigenschaft des IronPdf.Installation-Objekts.

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 Temp- und Cache-Ordner auf Ihren Entwicklungs- und Servern löschen und dann eine saubere 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

TippsErteilen Sie dem IIS-Benutzer (IUSER) auf einem gesperrten Server Lese- und Schreibrechte für Ihren Installationspfad-Ordner sowie für Ihren Windows- und Temp-Ordner.

[Remote IronPdfEngine] Verbinden Sie sich nach der Installation des IronPdf.Slim-Pakets mit dem Engine-Container und konfigurieren Sie die Verbindung beim Start der Anwendung oder vor dem Aufruf einer IronPDF-Methode.

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

Siehe auch: Einschränkungen der 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

Siehe auch: IronPDF Linux Docker-Kompatibilität und -Einrichtung

5. Bereitstellungsszenarien

Logo Azure related to 5. Bereitstellungsszenarien

Ausführen und Bereitstellen von IronPDF for .NET auf

Azure-Funktion
Logo Aws related to 5. Bereitstellungsszenarien

Ausführen und Bereitstellen von IronPDF for .NET auf

AWS Lambda
Logo Linux related to 5. Bereitstellungsszenarien

Führen Sie IronPDF aus in

Linux Docker-Container
Logo Remote related to 5. Bereitstellungsszenarien

Führen Sie IronPDF als

Remote-Container

Nächste Schritte

Vollständiger Leitfaden zur Umwandlung von HTML in PDF mit C#

Siehe Tutorial
Änderungsübersicht: Aktualisierungen, Meilensteine, Roadmap

Produktaktualisierungen ansehen
Technische Unterstützung anfordern

Siehe Fehlerbehebung
Quickstart Guide Native vs Remote Engine

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

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