Uso de IronPDF en Linux

Q: ¿Cómo puedo convertir HTML a PDF en C# en Linux?

Puede usar el método RenderHtmlAsPdf de IronPDF para convertir cadenas HTML en PDFs en Linux. Esto le permite generar documentos PDF directamente desde contenido HTML.

Q: ¿Cómo puedo mejorar el rendimiento de la generación de PDF en un entorno Linux?

Para optimizar IronPDF en Linux, asegúrese de que LinuxAndDockerDependenciesAutoConfig esté habilitado para la configuración automática de dependencias. Utilice paquetes NuGet optimizados para Linux y configure un directorio escribible para archivos temporales.

Curtis Chau

Updated: 4 de junio de 2026

IronPDF es compatible con Linux para .NET 10, 9, 8, 7, 6, 5 y aplicaciones de .NET Core, así como Docker, Azure, AWS, macOS y, naturalmente, Windows.

Contenedores y hosting oficialmente soportados

Distribuciones de Linux oficialmente soportadas

Consejos para IronPDF en Linux

Recomendamos usar .NET Core 8.0 y cualquier otro runtime marcado como LTS por Microsoft porque tienen soporte a largo plazo garantizado y están generalmente bien probados en Linux.

No se requieren cambios de código para ejecutar IronPDF en Linux. En general, IronPDF funciona de inmediato gracias a las pruebas exhaustivas y configuraciones realizadas por nuestros ingenieros.

El soporte para Linux es importante porque muchos servicios en la nube, como Azure Web Apps, Azure Functions, AWS EC2, AWS Lambda y Docker de Azure, dependen en gran medida de Linux. En Iron Software, utilizamos estas herramientas en la nube regularmente y entendemos que muchos de nuestros clientes empresariales y de SAAS también lo hacen.

Lee nuestra extensa documentación sobre el uso de IronPDF en Docker si necesitas ayuda con tu configuración. También puedes usar IronPDF en Linux desde una máquina Windows con WSL, otra opción popular.

Paquetes específicos de Linux

NuGet

IronPdf.Linux

Descarga de DLL

Para uso sin conexión, puede descargar el DLL y agregar una referencia a su proyecto.

IronPdf.Linux.zip

La documentación sobre paquetes para Linux y muchos otros sistemas operativos específicos se puede encontrar en nuestra guía avanzada de instalación de IronPDF con NuGet.

Disposiciones de Linux admitidas oficialmente

Oficialmente soportamos y recomendamos los últimos sistemas operativos de Linux de 64 bits a continuación para la configuración "sin configuración" 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 está instalando IronPDF en una versión no soportada de Linux, consulte Patrones comunes de dependencias para Linux al final de este documento.

Especificación de hardware

IronPDF utiliza Chromium para renderizar HTML a PDF. El motor de Chromium renderiza PDFs con una precisión de píxel perfecta a la función de impresión de Chrome. Las especificaciones de hardware están enfocadas principalmente en ejecutar el motor de Chromium, que requiere una potencia informática significativa.

Mínimo: 1 núcleo y 1.75 GB de RAM
Recomendado: 2 núcleos y 8 GB de RAM o más

Configuración automática de Linux

La configuración predeterminada LinuxAndDockerDependenciesAutoConfig establecida en true intentará instalar automáticamente todas las dependencias para que IronPDF se ejecute en Linux. Esto incluye manejar diferencias de paquetes específicos de la plataforma como libasound2t64 en Ubuntu 24.04. La primera operación de HTML a PDF puede tardar más de lo habitual.

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

Compatibilidad con Ubuntu

Ubuntu es nuestro sistema operativo Linux más probado, ampliamente utilizado en la infraestructura de Azure para pruebas y despliegues continuos. Esta plataforma también cuenta con soporte oficial de Microsoft .NET e Imágenes Oficiales de Docker.

Ubuntu 24

Admitimos Ubuntu 24 (24.04 LTS) con configuración cero.

Compatible con el motor de renderizado de HTML a PDF basado en Chrome
Compatibilidad oficial con los entornos de ejecución .NET 6 (LTS), 7, 8, 9 y 10
Realizamos más de 997 pruebas unitarias en esta plataforma antes de cada lanzamiento

Por favor nota: Ubuntu 24.04 ha renombrado varias bibliotecas del sistema añadiéndoles el sufijo t64. La configuración manual a continuación refleja estos cambios, por ejemplo libasound2 ahora es libasound2t64, libgtk2.0-0 ahora es libgtk2.0-0t64, libcups2 ahora es libcups2t64 y libatk-bridge2.0-0 ahora es libatk-bridge2.0-0t64.

Configuración manual de Ubuntu 24

Si es necesaria una instalación manual o su aplicación no puede ejecutarse con privilegios de administrador sudo. Establezca la propiedad IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig en false e instale las dependencias manualmente.

# 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

Soportamos Ubuntu 20 con configuración cero.

Soporte para motores de renderizado HTML a PDF basados en Chrome y WebKit
Soporte oficial para los runtimes .NET Core 3.1, 5, 6 (LTS), 7 y 8
Soporte no oficial para muchos otros runtimes de .NET Core en Ubuntu 20
Realizamos más de 997 pruebas unitarias en esta plataforma antes de cada lanzamiento

Imágenes oficiales de Docker de Microsoft:

Configuración manual de 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

Soportamos Ubuntu 18 de inmediato con configuración cero.

Soporte para motores de renderizado HTML a PDF basados en Chrome y WebKit
Soporte oficial para los runtimes .NET Core 3.1 LTS y .NET 5
Soporte no oficial para muchos otros runtimes de .NET Core en Ubuntu 18 y 16
Realizamos pruebas de humo exhaustivas en esta plataforma antes de cada lanzamiento

Imágenes oficiales de Docker de Microsoft:

Imagen de Docker de 64 bits para Ubuntu 18.04 del Runtime .NET 3.1 ('3.1-bionic')
Aunque no hay una imagen oficial de Docker for .NET 5 en Ubuntu 18, la compatibilidad es muy alta.

Configuración manual de 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

Tenemos soporte limitado para Ubuntu 16. .NET en Ubuntu 16 es oficialmente compatible por Microsoft y se reporta que funciona con IronPDF por muchos usuarios. Los desarrolladores pueden necesitar instalar dependencias adicionales manualmente.

Chrome y WebKit normalmente funcionan con configuración manual.
Los runtimes .NET Core 3.1 LTS y .NET 5 cuentan con soporte de Microsoft para Ubuntu 16.
Actualmente no hay imágenes oficiales de Docker de Microsoft para Ubuntu 16.

Configuración manual de 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

Compatibilidad con Debian

Debian es nuestro segundo sistema operativo Linux más probado. Esta plataforma también cuenta con soporte oficial de Microsoft .NET e Imágenes Oficiales de Docker.

Debian 11

Soportamos Debian 11 de inmediato con configuración cero.

Soporte para motores de renderizado HTML a PDF basados en Chrome y WebKit
Soporte oficial para los runtimes .NET Core 3.1, 5, 6 (LTS), 7 y 8
Soporte no oficial para muchos otros runtimes de .NET Core en Debian 11
Realizamos más de 997 pruebas unitarias en esta plataforma antes de cada lanzamiento

Imágenes oficiales de Docker de Microsoft:

Configuración manual 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

Soportamos Debian 10 de inmediato con configuración cero.

Soporte para motores de renderizado HTML a PDF basados en Chrome y WebKit
Soporte oficial para los runtimes .NET Core 3.1, 5, 6 (LTS), 7 y 8
Soporte no oficial para muchos otros runtimes de .NET Core en Debian 10
Realizamos más de 997 pruebas unitarias en esta plataforma antes de cada lanzamiento

Imágenes oficiales de Docker de Microsoft:

Configuración manual 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 y versiones inferiores

Debian 9 no se ha probado oficialmente y no funcionará automáticamente con IronPDF. Sin embargo, .NET en Debian 9 es oficialmente compatible por Microsoft y puede funcionar con IronPDF si se configura correctamente. Consulte Patrones comunes de dependencias para Linux al final de este documento.

No hay imágenes oficiales de Docker por Microsoft for .NET Core 3.1 o .NET 5.0 en Debian 9. Recomendamos encarecidamente migrar a Debian 10.

Compatibilidad con CentOS

Apoyamos activamente a CentOS.

Soporte para CentOS 8

Soportamos CentOS 8 de inmediato con configuración cero.

Soporte para motores de renderizado HTML a PDF basados en Chrome y WebKit
Soporte oficial para los runtimes .NET Core 3.1, 5, 6 (LTS), 7 y 8
Soporte no oficial para muchos otros runtimes de .NET Core en CentOS
Realizamos pruebas de humo exhaustivas en esta plataforma antes de cada lanzamiento

Desafortunadamente, no hay imágenes oficiales de Docker por Microsoft for .NET Core 3.1 o .NET 5.0 en CentOS 8.

Configuración manual de CentOS 8

Si es necesaria una instalación manual o su aplicación no puede ejecutarse con privilegios de administrador sudo:

Establecer 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 y versiones inferiores

CentOS 7 no ha sido probado y no funcionará automáticamente con IronPDF.

Sin embargo, .NET en CentOS 7 es oficialmente compatible por Microsoft y probablemente funcione con IronPDF si se configura correctamente. Lea Patrones comunes de dependencias para Linux abajo.

No hay imágenes oficiales de Docker por Microsoft for .NET Core 3.1 o .NET 5.0 en CentOS 7.

Compatibilidad con Amazon AWS Linux 2

Tenemos soporte activo para Amazon AWS Linux 2, que forma la base de los servicios en la nube de Amazon, como EC2 y Lambda.

No hay imágenes oficiales de Docker por Microsoft for .NET Core 3.1 o .NET 5.0 en Amazon AWS Linux 2.
Probamos manualmente la compatibilidad con Amazon AWS Linux 2 al desarrollar IronPDF.

Recomendamos que leas nuestra guía IronPDF AWS Lambda, que contiene un archivo Docker funcional para IronPDF en AWS Lambda.

Configuración manual de 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

Por favor, también lee nuestra documentación sobre nuestro soporte oficial IronPDF para AWS Lambda que incluye instalación y registro en la plataforma de nube de Amazon.

Amazon Linux 2023

Amazon Linux 2023 está basado en Fedora y es compatible con la configuración manual. Usa dnf como su gestor de paquetes.

Compatible con el motor de renderizado de HTML a PDF basado en Chrome
Requiere instalación manual de libxkbcommon y otras dependencias compatibles con Fedora
Comprobamos manualmente la compatibilidad con Amazon Linux 2023 a medida que desarrollamos IronPDF

Configuración recomendada

Se recomiendan los siguientes ajustes al implementar IronPDF en 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"

Manual de configuración de 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

Compatibilidad con Fedora Linux

Fedora Linux es compatible de inmediato con configuración cero.

Soporte para motores de renderizado HTML a PDF basados en Chrome y WebKit
Soporte oficial para los runtimes .NET Core 3.1, 5, 6 (LTS), 7 y 8
Realizamos pruebas de humo exhaustivas en esta plataforma antes de cada lanzamiento

Configuración manual 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

Compatibilidad con Alpine Linux

No se admite la ejecución de IronPDF en Alpine Linux. A partir de 2023, Alpine aún utiliza las bibliotecas de lenguaje C "musl" desactualizadas que no permiten que los desarrolladores de Chromium soporten completamente este sistema operativo aún.

Uso de Alpine Docker con IronPDFEngine en .NET 6

IronPDF proporciona una imagen contenedora que contiene todas las funcionalidades de IronPDF. Esto permite a los proyectos que se ejecutan en Alpine acceder a las funcionalidades de IronPDF conectándose al contenedor de IronPdfEngine.

Paso 1: Descargar e ejecutar la imagen de Docker de IronPDF Engine

Ejecute los siguientes comandos en su terminal para extraer y ejecutar la imagen Docker del motor 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

Paso 2: Configurar app de consola

Cree una nueva aplicación de consola dirigida a .NET 6.
Instale el paquete NuGet IronPdf.Slim usando el Administrador de Paquetes NuGet.

Aprenda más sobre cómo usar IronPDFEngine.

Otras distribuciones de Linux

Puede instalar manualmente los prerrequisitos de IronPDF para Linux usando apt-get, hfs y yum. Esto le permite usar IronPDF en muchas distribuciones de Linux no oficialmente soportadas.

Durante la instalación por primera vez, IronPDF puede lanzar excepciones para informarle de cualquier dependencia del sistema necesaria.

IronCefSubprocess mencionado es un archivo binario dentro de la carpeta bin de su aplicación. Puede que necesite especificar una ruta exacta, que podría estar en el subdirectorio runtimes de bin.
Puede necesitar privilegios de sudo.

Si no está seguro de cómo proceder con un sistema operativo Linux no mencionado, investigue las dependencias para el navegador Chromium en ese sistema operativo.

Para solicitar soporte oficial para una distribución diferente de Linux, comuníquese con support@ironsoftware.com.

Patrones de dependencia comunes para Linux

Consulte los paquetes de dependencias para otros Linux mencionados.

# 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

Identifique las dependencias que faltan

ldd es una herramienta poderosa para diagnosticar dependencias faltantes. Ejecutando ldd IronInterop.so, puede ver una lista de todas las bibliotecas compartidas que requiere una aplicación. Un mensaje de "no encontrado" junto a una biblioteca, como libcef.so => no encontrado, indica una dependencia crítica faltante que impedirá que el programa funcione correctamente. El archivo IronInterop.so se encuentra en la carpeta nativa del sistema operativo específico. Por ejemplo, bin/Debug/net6.0/runtimes/linux-x64/native.

ldd IronInterop.so

ldd IronInterop.so

SHELL

Subproceso IronCef

IronCefSubprocess es un archivo binario dentro de la carpeta bin de su aplicación. Debe ser ejecutable por el proceso .NET.

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

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

SHELL

Linux en España: cloud soberana y cumplimiento normativo

Para equipos de desarrollo en España, Linux es el sistema operativo habitual en servicios en la nube compatibles con los requisitos de residencia de datos de la LOPDGDD. Las distribuciones recomendadas para despliegues en España son Ubuntu 22 LTS y Debian 11, disponibles en las principales nubes con presencia en territorio español.

Proveedores de nube en España para IronPDF en Linux

AWS eu-south-2 (Madrid): Instancias EC2 con Amazon Linux 2023 o Ubuntu 22 LTS. Recomendado para flujos de generación de PDFs de facturas que requieren baja latencia con los sistemas AEAT y SII (Suministro Inmediato de Información).
Azure Spain Central (Madrid) y Spain North (Bilbao): Máquinas virtuales Linux con Ubuntu 22 o Debian 11. Cumple con los requisitos de residencia de datos de la AEPD para el procesamiento de datos personales en PDFs.
VPS españoles (OVHcloud Gravelines/Madrid, Hetzner Falkenstein, etc.): Para equipos que prefieren infraestructura propia o que tienen restricciones contractuales de soberanía de datos.

Casos de uso en facturación fiscal española

Los ISV españoles que desarrollan software de facturación certificado para VeriFactu o Facturae utilizan habitualmente Ubuntu 22 o Debian 11 como base de sus servicios de generación de PDFs. Consideraciones clave:

Ubuntu 22 con .NET 8 LTS es la combinación más probada para entornos de producción en servicios de facturación de alta disponibilidad.
Para flujos Facturae con envío a FACe (plataforma B2G de la AEAT), se recomienda desactivar LinuxAndDockerDependenciesAutoConfig en producción y declarar todas las dependencias en el sistema de gestión de configuración.
La generación de PDFs en Linux no requiere modificaciones de código respecto a Windows, lo que facilita el desarrollo local en Windows y el despliegue en producción en Linux.

Nota: IronPDF actúa como componente de generación de PDF dentro del software de facturación. La certificación VeriFactu corresponde al sistema completo, no a la biblioteca de forma aislada.

Preguntas Frecuentes

¿Cómo puedo convertir HTML a PDF en C# en Linux?

Puede usar el método RenderHtmlAsPdf de IronPDF para convertir cadenas HTML en PDFs en Linux. Esto le permite generar documentos PDF directamente desde contenido HTML.

¿Cuáles son los requisitos del sistema para utilizar bibliotecas PDF en Linux?

Para usar IronPDF en Linux, los requisitos mínimos de hardware son 1 núcleo y 1.75 GB de RAM. Para un rendimiento óptimo, se recomienda tener 2 núcleos y 8 GB de RAM, aprovechando el motor Chromium para la renderización.

¿Qué distribuciones de Linux son compatibles con las herramientas de generación de PDF?

IronPDF es compatible con Ubuntu 24, 22, 20, 18, 16, Debian 11, 10, CentOS 8, Fedora Linux 33, Amazon AWS Linux 2 y Amazon AWS Linux 2023 para la generación de PDF, lo que proporciona una configuración sin necesidad de ajustes para una integración perfecta.

¿Puedo integrar la generación de PDF con Docker en Linux?

Sí, IronPDF se puede integrar con Docker en Linux. Al configurar LinuxAndDockerDependenciesAutoConfig a verdadero, IronPDF intentará instalar automáticamente todas las dependencias necesarias para funcionar dentro de Docker.

¿Cómo instalo herramientas de generación de PDF en un entorno Linux?

Instale IronPDF en Linux usando el paquete NuGet IronPdf.Linux o descargue el DLL desde el sitio web de IronPDF. Asegúrese de que todas las dependencias estén correctamente instaladas y que IronCefSubprocess esté configurado como ejecutable.

¿Qué versiones de .NET son adecuadas para la generación de PDF en plataformas Linux?

IronPDF es compatible con .NET 10, 9, 8, 7, 6, 5 y .NET Core para generación de PDF en Linux. Se recomienda utilizar versiones de soporte a largo plazo (LTS) como .NET Core 3.1 para estabilidad y rendimiento.

¿Es factible ejecutar la generación de PDF en Alpine Linux?

El uso directo de IronPDF en Alpine Linux no es compatible debido a problemas de compatibilidad con las bibliotecas musl C. Sin embargo, el uso de un contenedor Docker de IronPDFEngine puede facilitar las funcionalidades PDF en Alpine.

¿Qué debo hacer si encuentro un error de dependencia faltante con herramientas PDF en Linux?

Si ocurre un error de dependencia faltante, instale manualmente los paquetes necesarios usando gestores de paquetes como apt-get, dnf, o yum, según los requisitos de su distribución de Linux.

¿Pueden las distribuciones de Linux no compatibles usar herramientas de generación de PDF?

IronPDF puede usarse en distribuciones de Linux no compatibles instalando manualmente las dependencias requeridas. Se recomienda consultar las dependencias de Chromium para orientación sobre instalaciones manuales.

¿Cómo puedo mejorar el rendimiento de la generación de PDF en un entorno Linux?

Para optimizar IronPDF en Linux, asegúrese de que LinuxAndDockerDependenciesAutoConfig esté habilitado para la configuración automática de dependencias. Utilice paquetes NuGet optimizados para Linux y configure un directorio escribible para archivos temporales.

¿Hay una guía específica para configurar herramientas PDF en AWS Lambda?

Sí, IronPDF ofrece una Guía de Configuración para AWS Lambda disponible en su sitio web, que ofrece instrucciones detalladas sobre cómo configurar IronPDF para usar en entornos AWS Lambda.

Curtis Chau

Chatea con el equipo de ingeniería ahora

Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

...

¿Listo para empezar?

Nuget Downloads 21,105,021|Versión:2026.9recién publicada

Descarga Gratis de NuGet

Descargas totales: 21,105,021

Ver Licencias

Ver en GitHub

Instalar con NuGet

Versión: 2026.9

PM > Install-Package IronPdf

nuget.org/packages/IronPdf/

En el Explorador de Soluciones, haga clic derecho en Referencias, Administrar Paquetes NuGet
Seleccione Examinar y busque "IronPDF"
Seleccione el paquete e instale

Descargar DLL

Versión: 2026.9

o descargue el Instalador de Windows aquí.

Descargue y descomprima IronPDF en una ubicación como ~/Libs dentro del directorio de su solución
En el Explorador de Soluciones de Visual Studio, haga clic derecho en Referencias. Seleccione Examinar, "IronPDF.dll"

Licencias desde $999