Adding IronPDF to an Existing Docker Container

Mis à jour:septembre 4, 2025

Translated

View the article in English

IronPDF pour .NET Standard prend désormais en charge Docker, y compris les conteneurs Docker Azure pour Linux et Windows.

Souhaitez-vous déployer IronPDF comme un conteneur Docker séparé à la place ? En savoir plus sur le guide des tutoriels IronPDFEngine.

class="container-fluid">

class="row">

class="col-md-2">

Pourquoi utiliser Docker sur Azure ?

En plus d'une évolutivité d'entreprise exceptionnelle, les conteneurs Docker sur Azure bénéficient de plus de permissions que les applications Web régulières. Cela permet le rendu des polices SVG car l'accès au système aux graphiques GDI+ est activé.

IronPDF et Linux Introduction

Si Docker avec .NET est nouveau pour vous, nous recommandons cet excellent article sur la configuration du débogage Docker et l'intégration avec des projets Visual Studio.

Nous vous recommandons également vivement de lire notre Guide de configuration et de compatibilité IronPDF Linux

Distributions Linux Docker recommandées

Nous recommandons les derniers systèmes d'exploitation Linux 64 bits ci-dessous pour une "configuration facile" de IronPDF.

Ubuntu 22
Ubuntu 20
Ubuntu 18
Debian 11
Debian 10
CentOS 8
Amazon AWS Linux 2 Lisez le guide de configuration IronPDF AWS Lambda

Nous recommandons d'utiliser les images Docker officielles pour .NET de Microsoft. D'autres distributions Linux sont partiellement supportées, mais peuvent nécessiter une configuration manuelle. Voir notre guide "Configuration manuelle Linux".

Installation de IronPDF Linux Docker

Utiliser les packages NuGet optimisés pour Linux

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. Ne vous inquiétez pas, cela fonctionne toujours lors du développement sous Windows ou macOS - il est juste optimisé pour Linux.

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

Éviter l'installation automatique des dépendances

De nombreux utilisateurs rapportent de meilleurs résultats avec Linux & Docker lorsque LinuxAndDockerDependenciesAutoConfig est défini sur false. C'est parce que les prérequis sont déjà installés par les gestionnaires de packages de style apt-get dans vos fichiers Docker.

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

Désactiver l'accélération GPU

Les conteneurs Docker Linux n'ont souvent pas accès à un GPU. L'accélération GPU est désactivée par défaut. Si vous avez activé ChromeGpuModes.Enabled, nous vous recommandons fortement de le désactiver pour les déploiements Docker :

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

Fichiers Docker Ubuntu Linux

class="container-fluid">

class="row">

class="col-md-2">

Ubuntu 22 avec .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.

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

Questions Fréquemment Posées

Comment puis-je intégrer une bibliothèque .NET pour la génération de PDF dans un conteneur Docker ?

Vous pouvez intégrer IronPDF, une bibliothèque .NET pour la génération de PDF, dans un conteneur Docker en utilisant les images Docker officielles de Microsoft et le package IronPdf.Linux NuGet pour Linux, ou des conteneurs Docker Windows pré-configurés pour les environnements Windows.

Quels sont les avantages d'utiliser des conteneurs Docker pour la manipulation de PDF sur Azure ?

L'utilisation de conteneurs Docker pour la manipulation de PDF sur Azure offre une évolutivité améliorée pour les entreprises et plus de permissions que les WebApps ordinaires. Cette configuration est idéale pour activer des fonctionnalités avancées telles que le rendu de polices SVG via l'accès aux graphiques GDI+.

Quelles distributions Linux sont les plus adaptées pour exécuter une bibliothèque PDF .NET dans Docker ?

Les distributions Linux les plus adaptées pour exécuter IronPDF dans Docker incluent Ubuntu 18/20/22, Debian 10/11, CentOS 8 et Amazon AWS Linux 2, car elles offrent une configuration et une compatibilité simples.

Comment puis-je optimiser les performances d'une bibliothèque PDF .NET dans des conteneurs Docker Linux ?

Pour optimiser les performances, utilisez le package IronPdf.Linux, désactivez l'installation automatique des dépendances et désactivez l'accélération GPU en configurant le IronPdf.Installation.ChromeGpuMode sur IronPdf.Engines.Chrome.ChromeGpuModes.Disabled.

IronPDF peut-il s'exécuter sur Alpine Linux dans un conteneur Docker ?

IronPDF ne prend pas en charge nativement Alpine Linux en raison des bibliothèques 'musl' incompatibles. Pour utiliser IronPDF sur Alpine Linux, envisagez de l'exécuter via un conteneur IronPdfEngine Docker.

Quel est le but d'utiliser des conteneurs Docker pré-configurés pour une bibliothèque .NET ?

Les conteneurs Docker pré-configurés fournissent toutes les dépendances nécessaires pour exécuter IronPDF efficacement, garantissant une haute performance et une évolutivité, particulièrement bénéfiques lors du déploiement sur des plateformes comme Azure.

Comment puis-je configurer une bibliothèque PDF .NET pour des applications .NET dans Docker ?

Vous pouvez configurer IronPDF pour des applications .NET dans Docker en l'intégrant à des conteneurs Docker Linux et Windows, permettant de robustes fonctionnalités PDF au sein d'une architecture de microservices.

Quelles sont les étapes d'installation recommandées pour déployer une bibliothèque .NET dans Docker ?

Les étapes recommandées incluent l'utilisation d'un package optimisé pour Linux comme IronPdf.Linux, la désactivation des installations automatiques de dépendances, et la pré-initialisation de IronPDF pour éviter les délais pendant l'exécution dans les environnements Docker.

Comment configurer une bibliothèque PDF .NET dans un conteneur Docker Windows Server 2019 exécutant .NET 6.0 ?

Configurez une bibliothèque PDF .NET dans un conteneur Docker Windows Server 2019 en utilisant un Dockerfile pré-configuré qui inclut toutes les dépendances et configurations nécessaires pour exécuter IronPDF avec .NET 6.0.

Pourquoi désactiver l'accélération GPU dans une configuration Docker pour une bibliothèque .NET ?

Désactiver l'accélération GPU pour IronPDF dans Docker peut conduire à un déploiement et à des performances plus fluides en évitant les problèmes potentiels liés aux graphiques dans des environnements où les ressources GPU sont limitées.

Curtis Chau

Discutez maintenant avec l'équipe d'ingénierie

Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Prêt à commencer?

Nuget Téléchargements 16,154,058 | Version : 2025.11 vient de sortir