IRONSOFTWAREHOME

Hinzufügen von IronPDF zu einem bestehenden Docker-Container

Curtis Chau
Curtis Chau
Updated: 4. Juni 2026

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.

Anleitungen
Sprachen
K
Funktionen
Windows-Logo

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.

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.

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

PM > 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;

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 für Docker deployments:

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

Ubuntu Linux Docker Dateien

Anleitungen
Ubuntu-Logo

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"]
Text

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"]
Text

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

Anleitungen
Debian-Logo

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
SHELL
# 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

Anleitungen
Windows-Logo

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 für .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
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 Handbücher.

...
Weiterlesen

Bereit anzufangen?

Nuget Downloads 21,105,021Version:2026.9gerade veröffentlicht

Erhalten Sie sofort Ihren kostenlosen 30-Tage-Testschlüssel.
Ihr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.
C# NuGet-Bibliothek für PDF
Installation mit NuGet

Version: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Rechtsklick auf Referenzen, NuGet-Pakete verwalten
  2. Wählen Sie Durchsuchen und suchen Sie nach 'IronPDF'
  3. Paket auswählen und installieren
C# PDF DLL
Download DLL

Version: 2026.9

oder laden Sie den Windows-Installer hier herunter.

  1. Laden Sie IronPDF herunter und entpacken Sie es in ein Verzeichnis wie ~/Libs innerhalb Ihres Lösungsverzeichnisses
  2. Im Visual Studio-Projektmappen-Explorer klicken Sie mit der rechten Maustaste auf Referenzen. Wählen Sie Durchsuchen, "IronPDF.dll"

Lizenzen ab 749 $

Key in blue circle

Holen Sie sich sofort Ihren kostenlosen 30-Tage-Testschlüssel.

Your trial license will be sent to your email address

Keine Einschränkungen. 100 % freigeschaltet. Keine Kreditkarte.

OR
bullet_checkedIhr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.Keine Einschränkungen. 100 % freigeschaltet. Keine Kreditkarte.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
Buchen Sie Ihre kostenlose Live-Demo
Booking Badge

Von Millionen von Ingenieur*innen weltweit vertraut

Kundenlogos von Iron Software
Erhalten Sie Ihre unverbindliche Beratung
Füllen Sie das Formular unten aus oder senden Sie eine E-Mail an sales@ironsoftware.com
Ihre Daten werden immer vertraulich behandelt.
Von Millionen von Ingenieur*innen weltweit vertraut
Kundenlogos von Iron Software
Erhalten Sie sofort Ihren kostenlosen 30-Tage-Testschlüssel.
Ihr Testlizenzschlüssel wurde Ihnen per E-Mail gesendet.
C# NuGet-Bibliothek für PDF
Installation mit NuGet

Version: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. Rechtsklick auf Referenzen, NuGet-Pakete verwalten
  2. Wählen Sie Durchsuchen und suchen Sie nach 'IronPDF'
  3. Paket auswählen und installieren
C# PDF DLL
Download DLL

Version: 2026.9

oder laden Sie den Windows-Installer hier herunter.

  1. Laden Sie IronPDF herunter und entpacken Sie es in ein Verzeichnis wie ~/Libs innerhalb Ihres Lösungsverzeichnisses
  2. Im Visual Studio-Projektmappen-Explorer klicken Sie mit der rechten Maustaste auf Referenzen. Wählen Sie Durchsuchen, "IronPDF.dll"

Lizenzen ab 749 $