1. IronPDF
  2. Commencer
  3. Utilisation sur Linux

Utilisation d'IronPDF sous Linux

Curtis Chau
Curtis Chau
Mis à jour:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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

Linux V1 related to Utilisation d'IronPDF sous Linux Docker related to Utilisation d'IronPDF sous Linux Azure 1 related to Utilisation d'IronPDF sous Linux Amazon Web Services related to Utilisation d'IronPDF sous Linux

Distributions Linux officiellement prises en charge

Ubuntu V1 related to Utilisation d'IronPDF sous Linux Debian V1 related to Utilisation d'IronPDF sous Linux Centos V1 related to Utilisation d'IronPDF sous Linux

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 de IronPDF avec Docker si vous avez besoin d'aide pour votre configuration. Vous pouvez également utiliser IronPDF sur Linux à partir d'une machine Windows avec WSL, ce qui est une autre option populaire.

Packages spécifiques à Linux

NuGet

Téléchargement DLL

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

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 nécessaires au fonctionnement d'IronPDF sous Linux. Cela inclut la gestion des différences de paquets spécifiques à certaines plateformes, telles que libasound2t64 sur Ubuntu 24.04. La première opération de conversion HTML vers 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
$vbLabelText   $csharpLabel

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

Microsoft related to Ubuntu 24 Ubuntu V1 related to Ubuntu 24 Chrome V1 related to Ubuntu 24 Docker related to Ubuntu 24 Azure 1 related to 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 noterUbuntu 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 désormais libasound2t64, libgtk2.0-0 est désormais libgtk2.0-0t64, libcups2 est désormais libcups2t64 et libatk-bridge2.0-0 est désormais 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

Microsoft related to Ubuntu 20 Ubuntu V1 related to Ubuntu 20 Chrome V1 related to Ubuntu 20 Safari V1 related to Ubuntu 20 Docker related to Ubuntu 20 Azure 1 related to 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

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

Microsoft related to Ubuntu 18 Ubuntu V1 related to Ubuntu 18 Chrome V1 related to Ubuntu 18 Safari V1 related to Ubuntu 18 Docker related to Ubuntu 18 Azure 1 related to 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:

Configuration manuelle d'Ubuntu 18

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

Ubuntu V1 related to Ubuntu 16 Test related to Ubuntu 16

Nous disposons d'un support limité pour Ubuntu 16. .NET sur Ubuntu 16 est officiellement soutenu par Microsoft et est rapporté 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

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

Debian related to Debian 11 Microsoft related to Debian 11 Chrome V1 related to Debian 11 Safari V1 related to Debian 11 Docker related to Debian 11 Azure 1 related to 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

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

Debian related to Debian 10 Microsoft related to Debian 10 Chrome V1 related to Debian 10 Safari V1 related to Debian 10 Docker related to Debian 10 Azure 1 related to 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

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 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 related to Debian 9 et inférieur Test related to Debian 9 et inférieur

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

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

Compatibilité CentOS

Centos related to Compatibilité CentOS Chrome V1 related to Compatibilité CentOS Safari V1 related to Compatibilité CentOS Test related to 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 pour .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 immédiatement avec IronPDF.

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

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

Compatibilité Amazon AWS Linux 2

Amazon Web Services related to Compatibilité Amazon AWS Linux 2 Chrome V1 related to Compatibilité Amazon AWS Linux 2 Safari V1 related to Compatibilité Amazon AWS Linux 2 Test related to 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 pour .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

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
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 Web Services related to Amazon Linux 2023 Chrome V1 related to Amazon Linux 2023 Test related to Amazon Linux 2023

Amazon Linux 2023 est basé sur Fedora et prend en charge la configuration manuelle. Elle 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 avec 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"
$vbLabelText   $csharpLabel

Manuel d'installation d'Amazon Linux 2023

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. La liste des dépendances suit celle du Manuel d'installation de Fedora Linux, avec l'ajout de libxkbcommon.

# 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

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.

# 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 de IronPDF. Cela permet aux projets fonctionnant sur Alpine d'accéder aux fonctionnalités de IronPDF en se connectant au conteneur IronPDFEngine.

Étape 1 : Extraire et exécuter l'image Docker de IronPDF Engine

Exécutez les commandes suivantes dans votre terminal pour extraire et exécuter l'image Docker de IronPDF Engine:

# 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 devrez peut-être spécifier un chemin d'accès exact, qui peut se trouver dans le sous-répertoire runtimes de bin.
  • Vous aurez peut-être 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 la 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 situé 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
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 ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 18,560,885 | Version : 2026.4 vient de sortir
Still Scrolling Icon

Vous faites encore défiler ?

Vous voulez une preuve rapidement ? PM > Install-Package IronPdf
exécuter un échantillon Regardez votre code HTML se transformer en PDF.