Hinzufügen von IronPDF zu einem bestehenden Docker-Container

Aktualisiert:26. April 2026

Translated

View the article in English

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

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 Ihnen auch dringend, unser IronPDF Linux-Setup- und Kompatibilitäts-Leitfaden zu lesen.

Empfohlene Linux-Docker-Distributionen

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

Ubuntu 24 (Noble)
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 for .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

Wir empfehlen, das IronPdf.Linux-NuGet-Paket zu verwenden, anstelle des regulären IronPDF-Pakets, um Speicherplatz zu sparen und zu vermeiden, dass beim Starten Ihrer Docker-Instanz Assets heruntergeladen werden. Keine Sorge, es funktioniert immer noch beim Entwickeln auf Windows oder macOS - es ist nur für Linux optimiert.

Install-Package IronPdf.Linux

Eine weitere Lösung besteht darin, einfach IronPdf.Native.Chrome.Linux oben auf das reguläre IronPDF-NuGet-Paket hinzuzufügen.

Install-Package IronPdf.Native.Chrome.Linux

Automatische Abhängigkeitsinstallation vermeiden

Many users report better results with Linux & Docker when LinuxAndDockerDependenciesAutoConfig is set to false. This is because the prerequisites are already installed by apt-get style package managers in your Docker files.

// 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. If you have enabled ChromeGpuModes.Enabled, we highly recommend you disable it for Docker deployments:

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

Ubuntu 24 mit .NET 10

Ubuntu 24.04 (Noble) uses 64-bit time_t transition packages, so some library names differ from earlier Ubuntu versions (e.g., libasound2t64 instead of libasound2).

# Build stage
FROM mcr.microsoft.com/dotnet/sdk:10.0-noble AS build
WORKDIR /app
COPY *.csproj .
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

# Runtime stage
FROM mcr.microsoft.com/dotnet/aspnet:10.0-noble AS runtime

# Install IronPDF dependencies for Ubuntu 24.04 Noble (64-bit transition libraries)
RUN apt-get update && apt-get install -y \
    libasound2t64 \
    libatk1.0-0t64 \
    libatk-bridge2.0-0t64 \
    libcairo2 \
    libcups2t64 \
    libdbus-1-3 \
    libdrm2 \
    libexpat1 \
    libfontconfig1 \
    libgbm1 \
    libglib2.0-0t64 \
    libgtk-3-0t64 \
    libnspr4 \
    libnss3 \
    libpango-1.0-0 \
    libpangocairo-1.0-0 \
    libx11-6 \
    libxcb1 \
    libxcomposite1 \
    libxdamage1 \
    libxext6 \
    libxfixes3 \
    libxkbcommon0 \
    libxrandr2 \
    fonts-liberation \
    wget \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "YourApp.dll"]

Ubuntu 24 mit .NET 8

.NET 8 LTS in Kombination mit Ubuntu 24.04 LTS ist eine gängige Produktionskombination. Für die gleichen 64-Bit-Übergangsbibliotheksnamen gelten dieselben.

# Build stage
FROM mcr.microsoft.com/dotnet/sdk:8.0-noble AS build
WORKDIR /app
COPY *.csproj .
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

# Runtime stage
FROM mcr.microsoft.com/dotnet/aspnet:8.0-noble AS runtime

# Install IronPDF dependencies for Ubuntu 24.04 Noble (64-bit transition libraries)
RUN apt-get update && apt-get install -y \
    libasound2t64 \
    libatk1.0-0t64 \
    libatk-bridge2.0-0t64 \
    libcairo2 \
    libcups2t64 \
    libdbus-1-3 \
    libdrm2 \
    libexpat1 \
    libfontconfig1 \
    libgbm1 \
    libglib2.0-0t64 \
    libgtk-3-0t64 \
    libnspr4 \
    libnss3 \
    libpango-1.0-0 \
    libpangocairo-1.0-0 \
    libx11-6 \
    libxcb1 \
    libxcomposite1 \
    libxdamage1 \
    libxext6 \
    libxfixes3 \
    libxkbcommon0 \
    libxrandr2 \
    fonts-liberation \
    wget \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "YourApp.dll"]

Ubuntu 22 mit .NET 8

Ubuntu 22 mit .NET 7

Ubuntu 20 mit .NET 6

Ubuntu 20 mit .NET 5

Ubuntu 20 mit .NET 3.1 LTS

Ubuntu 18 mit .NET 3.1 LTS

Debian Linux Docker-Dateien

Debian 12 mit .NET 8

Debian 11 mit .NET 7

Debian 11 mit .NET 6

Debian 11 mit .NET 5

Debian 11 mit .NET 3.1 LTS

Debian 10 mit .NET 5

Debian 10 mit .NET 3.1 LTS

Alpine Linux Docker-Dateien

Das Ausführen von IronPDF auf Alpine Linux wird nicht unterstützt. Wir wünschten, wir könnten es, aber wir können es nicht. Offen gesagt, wir mögen Alpine und hoffen, dass dieses Projekt fortgesetzt wird und wächst. Im Jahr 2023 verwendet Alpine immer noch veraltete "musl" C-Sprachbibliotheken, die es den Chromium-Entwicklern noch nicht ermöglichen, dieses Betriebssystem vollständig zu unterstützen.

Alpine-Docker mit IronPDFEngine in .NET 6 verwenden

IronPDF bietet ein Container-Image, das alle IronPDF-Funktionen enthält. Dadurch können Projekte, die auf Alpine laufen, auf IronPD-Funktionen zugreifen, indem sie sich mit dem IronPDFEngine-Container verbinden.

Schritt 1: IronPDF Engine Docker Image ziehen und ausführen

Führen Sie die folgenden Befehle in Ihrem Terminal aus, um das IronPDF Engine Docker-Image zu laden und auszuführen:

# 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

Schritt 2: Konsolenanwendung einrichten

Erstellen Sie eine neue Konsolenanwendung for .NET 6. Installieren Sie das NuGet-Paket IronPdf.Slim mit dem NuGet Package Manager.

Windows Docker-Datei

Windows Docker Containers werden auf Azure immer beliebter, da sie ein höheres Maß an Leistung und Skalierbarkeit bieten und Entwicklern mehr Rechte zur Konfiguration von Instanzen geben.

IronPDF wird innerhalb eines Docker-Containers (Windows oder Linux) auf Azure aufgrund des besseren Zugriffs auf die Grafikbibliothek und die virtuelle Grafikkarte tatsächlich eine attraktivere Textdarstellung bieten.

Der Artikel 'Visual Studio Container Tools for Docker' ist ein wirklich guter Leitfaden für den Einstieg in die Entwicklung.

Dies ist ein Beispiel für ein Windows-Container-Dockerfile for .NET Core 3.1

Windows Server 2019 .NET 6.0

Die vorkonfigurierten Windows-Container enthalten alle notwendigen Abhängigkeiten, um IronPDF auszuführen.

Hinweis:Bitte beachten Sie, dass diese Container nicht zum Erstellen von .NET Anwendungen, sondern zum Ausführen dieser Anwendungen gedacht sind.

Besuchen Sie das Docker-Repository, um weitere vorkonfigurierte Images für die Ausführung von IronPDF zu entdecken.

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 for .NET-Anwendungen in Docker konfigurieren?

Sie können IronPDF for .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 19,014,616 | Version: 2026.5 just released

Lizenzen anzeigen

Scrollst du immer noch?

Sie brauchen schnell einen Beweis? PM > Install-Package IronPdf
Führen Sie eine Probe aus Sehen Sie zu, wie Ihr HTML-Code in eine PDF-Datei umgewandelt wird.