Adding IronPDF to an Existing Docker Container

Aktualisiert:September 4, 2025

Translated

View the article in English

IronPDF für .NET Standard unterstützt jetzt vollständig Docker, einschließlich Azure Docker-Containern für Linux und Windows.

Möchten Sie IronPDF stattdessen als separaten Docker-Container bereitstellen? Erfahren Sie mehr über den IronPDFEngine Tutorials Guide.

class="container-fluid">

class="row">

class="col-md-2">

Warum Docker auf Azure verwenden?

Neben ausgezeichneter Unternehmensskalierbarkeit genießen Docker-Container auf Azure mehr Berechtigungen als reguläre WebApps. Dies ermöglicht das Rendern von SVG-Schriften, weil der Systemzugriff auf GDI+-Grafiken aktiviert ist.

IronPDF und Linux Primer

Wenn Docker mit .NET neu für Sie ist, empfehlen wir diesen ausgezeichneten Artikel über das Einrichten von Docker-Debugging und Integration mit Visual Studio-Projekten.

Wir empfehlen auch dringend unser IronPDF Linux Setup und Kompatibilitätsanleitung zu lesen

Empfohlene Linux-Docker-Distributionen

Wir empfehlen die neuesten 64-Bit-Linux-Betriebssysteme unten für eine "einfache Konfiguration" von IronPDF.

Ubuntu 22
Ubuntu 20
Ubuntu 18
Debian 11
Debian 10
CentOS 8
Amazon AWS Linux 2 Lesen Sie den IronPDF AWS Lambda Setup Guide

Wir empfehlen die Verwendung von Microsofts offiziellen Docker-Images für .NET. Andere Linux-Distributionen werden teilweise unterstützt, erfordern jedoch möglicherweise eine manuelle Konfiguration. Siehe unser "Linux Handbuch Setup".

IronPDF Linux Docker Installation

Verwenden Sie Linux optimierte NuGet-Pakete

We recommend using the IronPdf.Linux NuGet package instead of the regular IronPdf package to save disk space and avoid assets being downloaded when you start your Docker instance. Keine Sorge, es funktioniert immer noch beim Entwickeln auf Windows oder macOS - es ist nur für Linux optimiert.

Install-Package IronPdf.Linux

Another solution is to simply add IronPdf.Native.Chrome.Linux on top of the regular IronPdf NuGet package.

Install-Package IronPdf.Native.Chrome.Linux

Automatische Abhängigkeitsinstallation vermeiden

Viele Benutzer berichten von besseren Ergebnissen mit Linux & Docker, wenn LinuxAndDockerDependenciesAutoConfig auf false gesetzt ist. Dies liegt daran, dass die Voraussetzungen bereits von apt-get-ähnlichen Paketmanagern in Ihren Docker-Dateien installiert werden.

// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

' Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = False

$vbLabelText $csharpLabel

GPU-Beschleunigung deaktivieren

Linux Docker-Container haben oft keinen Zugriff auf eine GPU. GPU-Beschleunigung ist standardmäßig deaktiviert. Wenn Sie ChromeGpuModes.Enabled aktiviert haben, empfehlen wir dringend, es für Docker-Bereitstellungen zu deaktivieren:

// Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

// Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

' Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled

$vbLabelText $csharpLabel

Ubuntu Linux Docker Dateien

class="container-fluid">

class="row">

class="col-md-2">

Ubuntu 22 mit .NET 8

Ubuntu 22 with .NET 7

Ubuntu 20 with .NET 6

Ubuntu 20 with .NET 5

Ubuntu 20 with .NET 3.1 LTS

Ubuntu 18 with .NET 3.1 LTS

Debian Linux Docker Files

Debian 12 with .NET 8

Debian 11 with .NET 7

Debian 11 with .NET 6

Debian 11 with .NET 5

Debian 11 with .NET 3.1 LTS

Debian 10 with .NET 5

Debian 10 with .NET 3.1 LTS

Alpine Linux Docker Files

Running IronPDF on Alpine Linux is not supported. We wish we could but we can't. Frankly, we like Alpine and hope this project continues and grows. As of 2023, Alpine still uses outdated "musl" C language libraries that do not allow chromium developers to fully support this OS yet.

Using Alpine Docker with IronPdfEngine in .NET 6

IronPDF provides a container image containing all IronPDF functionalities. This enables projects running on Alpine to access IronPD functionalities by connecting to the IronPdfEngine container.

Step 1: Pull and Run IronPDF Engine Docker Image

Execute the following commands in your terminal to pull and run the IronPDF Engine Docker image:

# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine

# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine

SHELL

# Run the IronPDF Engine Docker container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

# Run the IronPDF Engine Docker container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

SHELL

Step 2: Set Up Console App

Create a new console application targeting .NET 6. Install the IronPdf.Slim NuGet package using the NuGet Package Manager.

Windows Docker File

Windows Docker Containers are becoming increasingly popular on Azure, as they offer higher levels of performance and scalability and give developers more permissions to configure instances.

IronPDF will actually perform more attractive text rendering within a Docker container (Windows or Linux) on Azure due to higher levels of access to graphics library and the virtual graphics card.

The article 'Visual Studio Container Tools for Docker' is a really great get-started guide.

This is an example Windows container Dockerfile for .NET Core 3.1

Windows Server 2019 .NET 6.0

Pre-configured Windows containers include all the necessary dependencies for running IronPDF.

Hinweis:Note that these containers are not intended for BUILDING .NET applications, but rather for RUNNING them.

Visit the Docker repository to explore additional pre-configured images for running IronPDF.

Häufig gestellte Fragen

Wie kann ich eine .NET-Bibliothek zur PDF-Erzeugung in einen Docker-Container integrieren?

Sie können IronPDF, eine .NET-Bibliothek zur PDF-Erzeugung, in einen Docker-Container integrieren, indem Sie die offiziellen Docker-Images von Microsoft und das IronPdf.Linux NuGet-Paket für Linux verwenden oder vorkonfigurierte Windows-Docker-Container für Windows-Umgebungen nutzen.

Welche Vorteile bietet die Verwendung von Docker-Containern für die PDF-Bearbeitung auf Azure?

Die Verwendung von Docker-Containern für die PDF-Bearbeitung auf Azure bietet erweiterte Unternehmensskalierbarkeit und mehr Berechtigungen als normale WebApps. Diese Einrichtung ist ideal, um erweiterte Funktionen wie SVG-Schriftrendering über den GDI+-Grafikzugang zu ermöglichen.

Welche Linux-Distributionen sind am besten geeignet, um eine .NET PDF-Bibliothek in Docker auszuführen?

Die am besten geeigneten Linux-Distributionen zur Ausführung von IronPDF in Docker umfassen Ubuntu 18/20/22, Debian 10/11, CentOS 8 und Amazon AWS Linux 2, da sie eine einfache Konfiguration und Kompatibilität bieten.

Wie kann ich die Leistung für eine .NET PDF-Bibliothek in Linux-Docker-Containern optimieren?

Um die Leistung zu optimieren, verwenden Sie das IronPdf.Linux-Paket, deaktivieren Sie die automatische Abhängigkeitsinstallation und schalten Sie die GPU-Beschleunigung aus, indem Sie die IronPdf.Installation.ChromeGpuMode auf IronPdf.Engines.Chrome.ChromeGpuModes.Disabled konfigurieren.

Kann IronPDF auf Alpine Linux innerhalb eines Docker-Containers ausgeführt werden?

IronPDF unterstützt Alpine Linux aufgrund inkompatibler 'musl'-Bibliotheken nicht nativ. Um IronPDF auf Alpine Linux zu verwenden, ziehen Sie in Betracht, es über einen IronPdfEngine Docker-Container auszuführen.

Was ist der Zweck der Verwendung von vorkonfigurierten Docker-Containern für eine .NET-Bibliothek?

Vorkonfigurierte Docker-Container bieten alle notwendigen Abhängigkeiten, um IronPDF effizient auszuführen, und sorgen für hohe Leistung und Skalierbarkeit, insbesondere vorteilhaft bei der Bereitstellung auf Plattformen wie Azure.

Wie kann ich eine .NET PDF-Bibliothek für .NET-Anwendungen in Docker konfigurieren?

Sie können IronPDF für .NET-Anwendungen in Docker konfigurieren, indem Sie es sowohl in Linux- als auch in Windows-Docker-Container integrieren und robuste PDF-Funktionalitäten innerhalb der Microservices-Architektur ermöglichen.

Was sind die empfohlenen Schritte zur Einrichtung einer .NET-Bibliothek in Docker?

Empfohlene Schritte umfassen die Verwendung eines Linux-optimierten Pakets wie IronPdf.Linux, das Deaktivieren automatischer Abhängigkeitsinstallationen und die Vorinitialisierung von IronPDF, um Verzögerungen während der Laufzeit in Docker-Umgebungen zu vermeiden.

Wie richte ich eine .NET PDF-Bibliothek in einem Windows Server 2019 Docker-Container mit .NET 6.0 ein?

Richten Sie eine .NET PDF-Bibliothek in einem Windows Server 2019 Docker-Container ein, indem Sie ein vorkonfiguriertes Dockerfile verwenden, das alle notwendigen Abhängigkeiten und Konfigurationen für das Ausführen von IronPDF mit .NET 6.0 enthält.

Warum die GPU-Beschleunigung in einer Docker-Konfiguration für eine .NET-Bibliothek deaktivieren?

Das Deaktivieren der GPU-Beschleunigung für IronPDF in Docker kann zu einer reibungsloseren Bereitstellung und Leistung führen, da potenzielle grafikbezogene Probleme in Umgebungen vermieden werden, in denen GPU-Ressourcen begrenzt sind.

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?

Nuget Downloads 16,154,058 | Version: 2025.11 gerade veröffentlicht

Lizenzen anzeigen

Auf dieser Seite