Utilisation d'IronPDF sous Linux

Q: Comment puis-je convertir HTML en PDF en C# sur Linux?

Vous pouvez utiliser la méthode RenderHtmlAsPdf d'IronPDF pour convertir des chaînes HTML en PDFs sur Linux. Cela vous permet de générer des documents PDF directement à partir de contenu HTML.

Q: Comment puis-je améliorer les performances de génération de PDF dans un environnement Linux?

Pour optimiser IronPDF sous Linux, assurez-vous que LinuxAndDockerDependenciesAutoConfig est activé pour une configuration automatique des dépendances. Utilisez des paquets NuGet optimisés pour Linux et établissez un répertoire accessible en écriture pour les fichiers temporaires.

Curtis Chau

Updated: 4 juin 2026

IronPDF prend en charge Linux pour .NET 10, 9, 8, 7, 6, 5 et les applications .NET Core, ainsi que Docker, Azure, AWS, macOS et (naturellement) Windows.

Conteneurisation et hébergement officiellement pris en charge

Distributions Linux officiellement prises en charge

Conseils pour IronPDF sur Linux

Nous recommandons d'utiliser .NET Core 8.0 et tous les autres environnements d'exécution marqués comme LTS par Microsoft car ils bénéficient d'un support à long terme garanti et sont généralement bien testés sur Linux.

Aucun changement de code n'est nécessaire pour exécuter IronPDF sur Linux. En général, IronPDF fonctionne immédiatement grâce aux tests et à la configuration approfondis de nos ingénieurs.

Le support Linux est important car de nombreux services cloud tels que Azure Web Apps, Azure Functions, AWS EC2, AWS Lambda et Azure DevOps Docker reposent fortement sur Linux. Chez Iron Software, nous utilisons régulièrement ces outils cloud et comprenons que nombre de nos clients entreprise et SAAS le font également.

Lisez notre documentation complète sur l'utilisation d'IronPDF sur Docker si vous avez besoin d'aide pour votre configuration. Vous pouvez également utiliser IronPDF sur Linux à partir d'une machine Windows avec WSL, qui est une autre option populaire.

Packages spécifiques à Linux

NuGet

IronPdf.Linux

Téléchargement DLL

Pour une utilisation hors ligne, vous pouvez télécharger la DLL et ajouter une référence à votre projet.

IronPdf.Linux.zip

La documentation concernant les packages Linux et bien d'autres packages pour les systèmes d'exploitation spécifiques se trouve dans notre guide d'installation avancée de IronPDF via NuGet.

Distributions Linux officiellement prises en charge

Nous soutenons officiellement et recommandons les derniers systèmes d'exploitation Linux 64 bits ci-dessous pour une configuration "zéro configuration" de IronPDF.

Ubuntu 24
Ubuntu 22
Ubuntu 20
Ubuntu 18
Ubuntu 16
Debian 11
Debian 10
CentOS 8
Fedora Linux 33
Amazon AWS Linux 2
Amazon AWS Linux 2023

Si vous installez IronPDF sur une version Linux non prise en charge, consultez les modèles de dépendance communs pour Linux à la fin de ce document.

Spécifications du matériel

IronPDF utilise Chromium pour transformer HTML en PDF. Le moteur Chromium génère des PDF avec une précision pixel par pixel à celle de la fonction d'impression de Chrome. Les spécifications matérielles sont principalement adaptées pour exécuter le moteur Chromium, qui nécessite une puissance de calcul significative.

Minimum : 1 cœur et 1,75 Go de RAM
Recommandé : 2 cœurs et 8 Go de RAM ou plus

Configuration automatique sous Linux

Le paramètre par défaut LinuxAndDockerDependenciesAutoConfig défini sur true tentera d'installer automatiquement toutes les dépendances pour que IronPDF fonctionne sous Linux. Cela inclut la gestion des différences de paquet spécifiques à la plateforme telles que libasound2t64 sur Ubuntu 24.04. La première opération HTML-to-PDF peut prendre plus de temps que d'habitude.

// Enables automatic configuration of dependencies for Linux
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

// Enables automatic configuration of dependencies for Linux
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

' Enables automatic configuration of dependencies for Linux
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True

' Enables automatic configuration of dependencies for Linux
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True

Compatibilité Ubuntu

Ubuntu est notre système d'exploitation Linux le plus testé, largement utilisé dans l'infrastructure Azure pour les tests et le déploiement continus. Cette plateforme dispose également du support officiel de Microsoft .NET et d'images Docker officielles.

Ubuntu 24

Nous prenons en charge Ubuntu 24 (24.04 LTS) sans aucune configuration.

Prise en charge du moteur de rendu HTML vers PDF basé sur Chrome
Prise en charge officielle des environnements d'exécution .NET 6 (LTS), 7, 8, 9 et 10
Effectuez plus de 997 tests unitaires sur cette plateforme avant chaque version

Veuillez noter: Ubuntu 24.04 a renommé plusieurs bibliothèques système en leur ajoutant le suffixe t64. La configuration manuelle ci-dessous reflète ces changements, par exemple libasound2 est maintenant libasound2t64, libgtk2.0-0 est maintenant libgtk2.0-0t64, libcups2 est maintenant libcups2t64, et libatk-bridge2.0-0 est maintenant libatk-bridge2.0-0t64.)]

Configuration manuelle d'Ubuntu 24

Si une installation manuelle est nécessaire ou si votre application ne peut pas être exécutée avec des privilèges admin sudo. Définissez la propriété IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig sur false et installez les dépendances manuellement.

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libcups2t64
apt install -y libgtk2.0-0t64
apt install -y libnss3
apt install -y libatk-bridge2.0-0t64
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2t64
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1
apt install -y libgdiplus
apt install -y libva-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libcups2t64
apt install -y libgtk2.0-0t64
apt install -y libnss3
apt install -y libatk-bridge2.0-0t64
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2t64
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1
apt install -y libgdiplus
apt install -y libva-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Ubuntu 20

Nous prenons en charge Ubuntu 20 avec une configuration zéro.

Prise en charge de Chrome et de moteurs de rendu HTML en PDF basés sur WebKit
Prise en charge officielle des environnements d'exécution .NET Core 3.1, 5, 6 (LTS), 7, et 8
Prise en charge non officielle de nombreux autres environnements d'exécution .NET Core sur Ubuntu 20
Effectuez plus de 997 tests unitaires sur cette plateforme avant chaque version

Images Docker officielles de Microsoft:

Configuration manuelle d'Ubuntu 20

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1
apt install -y libgdiplus
apt install -y libva-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1
apt install -y libgdiplus
apt install -y libva-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Ubuntu 18

Nous prenons en charge Ubuntu 18 dès la sortie du carton avec une configuration zéro.

Prise en charge de Chrome et de moteurs de rendu HTML en PDF basés sur WebKit
Support officiel .NET Core 3.1 LTS et les environnements d'exécution .NET 5
Prise en charge non officielle de nombreux autres environnements d'exécution .NET Core sur Ubuntu 18 et 16
Effectuez des tests de fumée complets sur cette plateforme avant chaque version

Images Docker officielles de Microsoft:

Image Docker 64 bits Ubuntu 18.04 for .NET Runtime 3.1 ('3.1-bionic')
Bien qu'il n'y ait pas d'image docker officielle pour .NET 5 sur Ubuntu 18, la compatibilité est très élevée.

Configuration manuelle d'Ubuntu 18

# Update and install necessary libraries
apt update
apt install -y libc6
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Ubuntu 16

Nous avons un support limité pour Ubuntu 16. .NET sur Ubuntu 16 est officiellement supporté par Microsoft et est réputé fonctionner avec IronPDF par de nombreux utilisateurs. Les développeurs peuvent avoir besoin d'installer des dépendances supplémentaires manuellement.

Chrome et WebKit fonctionnent généralement avec une configuration manuelle.
Les environnements d'exécution .NET Core 3.1 LTS et .NET 5 ont le support de Microsoft pour Ubuntu 16.
Il n'y a actuellement aucune image Docker officielle de Microsoft pour Ubuntu 16.

Configuration manuelle d'Ubuntu 16

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Compatibilité Debian

Debian est notre deuxième système d'exploitation Linux le plus testé. Cette plateforme dispose également du support officiel de Microsoft .NET et d'images Docker officielles.

Debian 11

Nous prenons en charge Debian 11 dès la sortie du carton avec une configuration zéro.

Prise en charge de Chrome et de moteurs de rendu HTML en PDF basés sur WebKit
Prise en charge officielle des environnements d'exécution .NET Core 3.1, 5, 6 (LTS), 7, et 8
Prise en charge non officielle de nombreux autres environnements d'exécution .NET Core sur Debian 11
Effectuez plus de 997 tests unitaires sur cette plateforme avant chaque version

Images Docker officielles de Microsoft:

Configuration manuelle de Debian 11

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libxkbcommon-x11-0
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libxkbcommon-x11-0
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Debian 10

Nous prenons en charge Debian 10 dès la sortie du carton avec une configuration zéro.

Prise en charge de Chrome et de moteurs de rendu HTML en PDF basés sur WebKit
Prise en charge officielle des environnements d'exécution .NET Core 3.1, 5, 6 (LTS), 7, et 8
Prise en charge non officielle de nombreux autres environnements d'exécution .NET Core sur Debian 10
Effectuez plus de 997 tests unitaires sur cette plateforme avant chaque version

Images Docker officielles de Microsoft:

Configuration manuelle de Debian 10

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Debian 9 et inférieur

Debian 9 n'est pas officiellement testé et ne fonctionnera pas tel quel avec IronPDF. Cependant, .NET sur Debian 9 est officiellement supporté par Microsoft et peut fonctionner avec IronPDF si configuré correctement. Consultez les modèles de dépendance communs pour Linux à la fin de ce document.

Il n'existe aucune image Docker officielle de Microsoft for .NET Core 3.1 ou .NET 5.0 sur Debian 9. Nous recommandons fortement de migrer vers Debian 10.

Compatibilité CentOS

Nous soutenons activement CentOS.

Support de CentOS 8

Nous prenons en charge CentOS 8 dès la sortie du carton avec une configuration zéro.

Prise en charge de Chrome et de moteurs de rendu HTML en PDF basés sur WebKit
Prise en charge officielle des environnements d'exécution .NET Core 3.1, 5, 6 (LTS), 7, et 8
Prise en charge non officielle de nombreux autres environnements d'exécution .NET Core sur CentOS
Effectuez des tests de fumée complets sur cette plateforme avant chaque version

Malheureusement, il n'y a pas d'images Docker officielles de Microsoft for .NET Core 3.1 ou .NET 5.0 sur CentOS 8.

Configuration manuelle de CentOS 8

Si une installation manuelle est nécessaire ou si votre application ne peut pas être exécutée avec des privilèges admin sudo :

Définir IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

# Update and install necessary libraries
dnf -y update
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
dnf -y update
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

CentOS 7 et inférieur

CentOS 7 n'a pas été testé et ne fonctionnera pas tel quel avec IronPDF.

Cependant, .NET sur CentOS 7 est officiellement supporté par Microsoft et fonctionnerait probablement avec IronPDF si configuré correctement. Veuillez lire les modèles de dépendance communs pour Linux ci-dessous.

Il n'y a pas d'images Docker officielles de Microsoft for .NET Core 3.1 ou .NET 5.0 sur CentOS 7.

Compatibilité Amazon AWS Linux 2

Nous avons un support fonctionnel pour Amazon AWS Linux 2, qui constitue la base des services cloud d'Amazon tels que EC2 et Lambda.

Il n'y a pas d'images Docker officielles de Microsoft for .NET Core 3.1 ou .NET 5.0 sur Amazon AWS Linux 2.
Nous testons manuellement la compatibilité avec Amazon AWS Linux 2 au fur et à mesure que nous développons IronPDF.

Nous vous recommandons de lire notre guide IronPDF AWS Lambda, qui contient un fichier Docker fonctionnel pour IronPDF sur AWS Lambda.

Configuration manuelle d'Amazon Linux 2

# Update and install necessary libraries
yum update -y
yum install -y pango.x86_64
yum install -y libXcomposite.x86_64
yum install -y libXcursor.x86_64
yum install -y libXdamage.x86_64
yum install -y libXext.x86_64
yum install -y libXi.x86_64
yum install -y libXtst.x86_64
yum install -y cups-libs.x86_64
yum install -y libXScrnSaver.x86_64
yum install -y libXrandr.x86_64
yum install -y GConf2.x86_64
yum install -y alsa-lib.x86_64
yum install -y atk.x86_64
yum install -y gtk3.x86_64
yum install -y ipa-gothic-fonts
yum install -y xorg-x11-fonts-100dpi
yum install -y xorg-x11-fonts-75dpi
yum install -y xorg-x11-utils
yum install -y xorg-x11-fonts-cyrillic
yum install -y xorg-x11-fonts-Type1
yum install -y xorg-x11-fonts-misc
yum install -y glibc-devel.x86_64
yum install -y at-spi2-atk.x86_64
yum install -y mesa-libgbm.x86_64
yum install -y libxkbcommon

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
yum update -y
yum install -y pango.x86_64
yum install -y libXcomposite.x86_64
yum install -y libXcursor.x86_64
yum install -y libXdamage.x86_64
yum install -y libXext.x86_64
yum install -y libXi.x86_64
yum install -y libXtst.x86_64
yum install -y cups-libs.x86_64
yum install -y libXScrnSaver.x86_64
yum install -y libXrandr.x86_64
yum install -y GConf2.x86_64
yum install -y alsa-lib.x86_64
yum install -y atk.x86_64
yum install -y gtk3.x86_64
yum install -y ipa-gothic-fonts
yum install -y xorg-x11-fonts-100dpi
yum install -y xorg-x11-fonts-75dpi
yum install -y xorg-x11-utils
yum install -y xorg-x11-fonts-cyrillic
yum install -y xorg-x11-fonts-Type1
yum install -y xorg-x11-fonts-misc
yum install -y glibc-devel.x86_64
yum install -y at-spi2-atk.x86_64
yum install -y mesa-libgbm.x86_64
yum install -y libxkbcommon

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Veuillez également lire notre documentation sur notre support officiel IronPDF pour AWS Lambda qui inclut l'installation et la journalisation sur la plateforme cloud Amazon.

Amazon Linux 2023

Amazon Linux 2023 est basé sur Fedora et prend en charge la configuration manuelle. Il utilise dnf comme Package Manager.

Prise en charge du moteur de rendu HTML vers PDF basé sur Chrome
Nécessite l'installation manuelle de libxkbcommon et d'autres dépendances compatibles Fedora
Nous testons manuellement la compatibilité avec Amazon Linux 2023 au fur et à mesure du développement d'IronPDF

Configuration recommandée

Les paramètres suivants sont recommandés lors du déploiement d'IronPDF sur Amazon Linux 2023 :

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
IronPdf.Installation.AutomaticallyDownloadNativeBinaries = true;
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
IronPdf.Installation.CustomDeploymentDirectory = "/tmp";

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
IronPdf.Installation.AutomaticallyDownloadNativeBinaries = true;
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
IronPdf.Installation.CustomDeploymentDirectory = "/tmp";

Imports IronPdf

Installation.LinuxAndDockerDependenciesAutoConfig = True
Installation.AutomaticallyDownloadNativeBinaries = True
Installation.ChromeGpuMode = Engines.Chrome.ChromeGpuModes.Disabled
Installation.CustomDeploymentDirectory = "/tmp"

Imports IronPdf

Installation.LinuxAndDockerDependenciesAutoConfig = True
Installation.AutomaticallyDownloadNativeBinaries = True
Installation.ChromeGpuMode = Engines.Chrome.ChromeGpuModes.Disabled
Installation.CustomDeploymentDirectory = "/tmp"

Manuel d'installation d'Amazon Linux 2023

# Install necessary libraries
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence
dnf -y install libxkbcommon

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Install necessary libraries
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence
dnf -y install libxkbcommon

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Compatibilité Fedora Linux

Fedora Linux est pris en charge dès la sortie du carton avec une configuration zéro.

Prise en charge de Chrome et de moteurs de rendu HTML en PDF basés sur WebKit
Prise en charge officielle des environnements d'exécution .NET Core 3.1, 5, 6 (LTS), 7, et 8
Effectuez des tests de fumée complets sur cette plateforme avant chaque version

Configuration manuelle de Fedora Linux

# Install necessary libraries
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Install necessary libraries
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Compatibilité Alpine Linux

L'exécution d'IronPDF sur Alpine Linux n'est pas prise en charge. En 2023, Alpine utilise encore des bibliothèques de langage C "musl" périmées qui ne permettent pas aux développeurs de chrome de prendre pleinement en charge cet OS pour l'instant.

Utilisation de Docker Alpine avec IronPDFEngine dans .NET 6

IronPDF fournit une image de conteneur contenant toutes les fonctionnalités d'IronPDF. Cela permet aux projets exécutés sur Alpine d'accéder aux fonctionnalités d'IronPDF en se connectant au conteneur IronPdfEngine.

Étape 1 : Téléchargez et exécutez l'image Docker IronPDF Engine

Exécutez les commandes suivantes dans votre terminal pour tirer et exécuter l'image Docker du moteur IronPDF :

# Pull the IronPdfEngine Docker image
docker pull ironsoftwareofficial/ironpdfengine

# Run the IronPdfEngine container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

# Pull the IronPdfEngine Docker image
docker pull ironsoftwareofficial/ironpdfengine

# Run the IronPdfEngine container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

SHELL

Étape 2 : Configurer l'application Console

Créez une nouvelle application console ciblant .NET 6.
Installez le package NuGet IronPdf.Slim en utilisant le gestionnaire de packages NuGet.

En savoir plus sur comment utiliser IronPDFEngine.

Autres distributions Linux

Vous pouvez installer manuellement les prérequis de IronPDF pour Linux en utilisant apt-get, hfs et yum. Cela vous permet d'utiliser IronPDF sur de nombreuses distributions Linux non officiellement prises en charge.

Lors de l'installation pour la première fois, IronPDF peut lancer des exceptions pour vous informer des dépendances système nécessaires.

IronCefSubprocess mentionné est un binaire dans le dossier bin de votre application. Vous pourriez avoir besoin de spécifier un chemin exact, qui pourrait se trouver dans le sous-répertoire runtimes de bin.
Vous pourriez avoir besoin des privilèges sudo.

Si vous ignorez comment procéder avec un système d'exploitation Linux non répertorié, étudiez les dépendances pour le navigateur Chromium sur cet OS.

Pour demander un support officiel pour une autre distribution Linux, veuillez contacter support@ironsoftware.com.

Modèles de dépendance communs pour Linux

Veuillez vous référer aux packages de dépendance pour d'autres systèmes d'exploitation Linux ci-dessus.

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Identifier les dépendances manquantes

ldd est un outil puissant pour diagnostiquer les dépendances manquantes. En exécutant ldd IronInterop.so, vous pouvez voir une liste de toutes les bibliothèques partagées requises par une application. Un message "not found" à côté d'une bibliothèque, comme libcef.so => not found, indique une dépendance critique manquante qui empêchera le programme de fonctionner correctement. Le fichier IronInterop.so se trouve dans le dossier natif du système d'exploitation spécifique. Par exemple, bin/Debug/net6.0/runtimes/linux-x64/native.

ldd IronInterop.so

ldd IronInterop.so

SHELL

IronCefSubprocess

IronCefSubprocess est un fichier binaire dans le dossier bin de votre application. Il doit être exécutable par le processus .NET.

# Change permissions for IronCefSubprocess
chmod 755 bin/runtimes/linux-64/IronCefSubprocess

# Change permissions for IronCefSubprocess
chmod 755 bin/runtimes/linux-64/IronCefSubprocess

SHELL

Questions Fréquemment Posées

Comment puis-je convertir HTML en PDF en C# sur Linux?

Vous pouvez utiliser la méthode RenderHtmlAsPdf d'IronPDF pour convertir des chaînes HTML en PDFs sur Linux. Cela vous permet de générer des documents PDF directement à partir de contenu HTML.

Quelles sont les exigences système pour utiliser les bibliothèques PDF sur Linux?

Pour utiliser IronPDF sur Linux, les exigences matérielles minimales sont 1 cœur et 1,75 Go de RAM. Pour des performances optimales, il est recommandé d'avoir 2 cœurs et 8 Go de RAM, en utilisant le moteur Chromium pour le rendu.

Quelles distributions Linux sont compatibles avec les outils de génération de PDF?

IronPDF prend en charge Ubuntu 24, 22, 20, 18, 16, Debian 11, 10, CentOS 8, Fedora Linux 33, Amazon AWS Linux 2 et Amazon AWS Linux 2023 pour la génération de PDF, offrant une configuration sans aucune modification pour une intégration transparente.

Puis-je intégrer la génération de PDF avec Docker sur Linux?

Oui, IronPDF peut être intégré avec Docker sur Linux. En définissant LinuxAndDockerDependenciesAutoConfig sur vrai, IronPDF tentera d'installer automatiquement toutes les dépendances nécessaires pour s'exécuter dans Docker.

Comment puis-je installer des outils de génération de PDF dans un environnement Linux?

Installez IronPDF sur Linux en utilisant le paquet NuGet IronPdf.Linux ou téléchargez le DLL depuis le site Web IronPDF. Assurez-vous que toutes les dépendances sont correctement installées et que IronCefSubprocess est défini comme exécutable.

Quelles versions de .NET conviennent pour la génération de PDF sur les plateformes Linux?

IronPDF prend en charge .NET 10, 9, 8, 7, 6, 5, et .NET Core pour la génération de PDF sur Linux. Il est conseillé d'utiliser des versions de support à long terme (LTS) comme .NET Core 3.1 pour la stabilité et la performance.

Est-il faisable d'exécuter la génération de PDF sur Alpine Linux?

L'utilisation directe d'IronPDF sur Alpine Linux n'est pas prise en charge en raison de problèmes de compatibilité avec les bibliothèques C musl. Cependant, l'utilisation d'un conteneur Docker IronPDFEngine peut faciliter les fonctionnalités PDF sur Alpine.

Que dois-je faire si je rencontre une erreur de dépendance manquante avec les outils PDF sur Linux?

Si une erreur de dépendance manquante survient, installez manuellement les paquets nécessaires en utilisant des gestionnaires de paquets comme apt-get, dnf ou yum, en fonction des exigences de votre distribution Linux.

Les distributions Linux non prises en charge peuvent-elles utiliser les outils de génération de PDF?

IronPDF peut être utilisé sur les distributions Linux non prises en charge en installant manuellement les dépendances requises. Consulter les dépendances Chromium est recommandé pour obtenir des conseils sur les installations manuelles.

Comment puis-je améliorer les performances de génération de PDF dans un environnement Linux?

Pour optimiser IronPDF sous Linux, assurez-vous que LinuxAndDockerDependenciesAutoConfig est activé pour une configuration automatique des dépendances. Utilisez des paquets NuGet optimisés pour Linux et établissez un répertoire accessible en écriture pour les fichiers temporaires.

Existe-t-il un guide spécifique pour configurer des outils PDF sur AWS Lambda?

Oui, IronPDF fournit un guide de configuration AWS Lambda disponible sur leur site Web, offrant des instructions détaillées sur la configuration d'IronPDF pour une utilisation dans les environnements AWS Lambda.

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 et créer des manuels bien structurés et visuellement attrayants.

...

Prêt à commencer ?

Nuget Downloads 21,105,021|Version :2026.9vient de sortir

Téléchargement NuGet gratuit

Total des téléchargements :21,105,021

Voir les licences

Installer avec NuGet

Version : 2026.9

PM > Install-Package IronPdf

nuget.org/packages/IronPdf/

Dans l'explorateur de solutions, faites un clic droit sur Références, Gestion des packages NuGet
Sélectionnez Parcourir et recherchez « IronPDF »
Sélectionnez le package et installez

Télécharger DLL

Version : 2026.9

ou téléchargez l'installateur Windows ici.

Téléchargez et décompressez IronPDF à un emplacement tel que ~/Libs dans votre répertoire de solution
Dans l'explorateur de solutions Visual Studio, faites un clic droit sur Références. Sélectionnez Parcourir, « IronPDF.dll »

Licences à partir de 749 $