Usando o IronPDF no Linux

Name: IronPDF
Brand: Iron Software
Availability: InStock
Rating: 4.87 (307 reviews)

Curtis Chau

Atualizado:março 17, 2026

Translated

View the article in English

O IronPDF oferece suporte a Linux para aplicativos .NET 10, 9, 8, 7, 6, 5 e .NET Core , bem como Docker, Azure, AWS, macOS e (naturalmente) Windows.

Containerização e hospedagem com suporte oficial

Distribuições Linux oficialmente suportadas

Dicas para usar o IronPDF no Linux

Recomendamos o uso do .NET Core 8.0 e de quaisquer outros runtimes marcados como LTS pela Microsoft, pois eles têm suporte garantido a longo prazo e geralmente são bem testados no Linux.

Não são necessárias alterações no código para executar o IronPDF no Linux. Em geral, o IronPDF funciona sem necessidade de configuração adicional, graças aos extensos testes e configurações realizados por nossos engenheiros.

O suporte ao Linux é importante porque muitos serviços em nuvem, como Azure Web Apps, Azure Functions, AWS EC2, AWS Lambda e Azure DevOps Docker, dependem fortemente do Linux. Na Iron Software, usamos essas ferramentas em nuvem regularmente e entendemos que muitos de nossos clientes corporativos e de SaaS também as utilizam.

Leia nossa documentação extensa sobre o uso do IronPDF no Docker se precisar de ajuda com sua configuração. Você também pode usar o IronPDF no Linux a partir de uma máquina Windows com WSL, que é outra opção popular.

Pacotes específicos para Linux

NuGet

IronPdf.Linux

Download do arquivo DLL

Para uso offline, você pode baixar a DLL e adicionar uma referência ao seu projeto.

IronPdf.Linux.zip

A documentação relativa aos pacotes Linux e a muitos outros pacotes para sistemas operacionais específicos pode ser encontrada em nosso guia avançado de instalação do NuGet, o IronPDF .

Distribuições Linux oficialmente suportadas

Oficialmente, oferecemos suporte e recomendamos os sistemas operacionais Linux de 64 bits mais recentes listados abaixo para a instalação do IronPDF sem nenhuma configuração adicional.

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

Se estiver instalando o IronPDF em uma versão do Linux não suportada, consulte Padrões de Dependência Comuns para Linux no final deste documento.

Especificações de hardware

O IronPDF usa o Chromium para renderizar HTML em PDF. O mecanismo Chromium renderiza PDFs com precisão perfeita em termos de pixels para a função de impressão do Chrome. As especificações de hardware são voltadas principalmente para a execução do mecanismo Chromium, que exige uma capacidade computacional significativa.

Requisitos mínimos: 1 núcleo e 1,75 GB de RAM
Recomendado: 2 núcleos e 8 GB de RAM ou superior

Configuração automática do Linux

A configuração padrão LinuxAndDockerDependenciesAutoConfig definida como true tentará instalar automaticamente todas as dependências para que o IronPDF seja executado no Linux. Isso inclui lidar com diferenças de pacotes específicas da plataforma, como libasound2t64 no Ubuntu 24.04. A primeira operação de conversão de HTML para PDF pode demorar mais do que o normal.

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

Compatibilidade com Ubuntu

O Ubuntu é o nosso sistema operacional Linux mais testado, amplamente utilizado na infraestrutura do Azure para testes e implantações contínuas. Esta plataforma também possui suporte oficial do Microsoft .NET e imagens oficiais do Docker.

Ubuntu 24

Oferecemos suporte ao Ubuntu 24 (24.04 LTS) com nenhuma configuração.

Suporte ao mecanismo de renderização de HTML para PDF baseado no Chrome
Suporte oficial para os ambientes de execução .NET 6 (LTS), 7, 8, 9 e 10.
Realizar mais de 997 testes unitários nesta plataforma antes de cada lançamento.

ObserveO Ubuntu 24.04 renomeou várias bibliotecas do sistema com o sufixo t64 . A configuração manual abaixo reflete essas alterações; por exemplo, libasound2 agora é libasound2t64, libgtk2.0-0 agora é libgtk2.0-0t64, libcups2 agora é libcups2t64 e libatk-bridge2.0-0 agora é libatk-bridge2.0-0t64.

Configuração manual do Ubuntu 24

Caso seja necessária a instalação manual ou se o seu aplicativo não puder ser executado com privilégios de administrador sudo. Defina a propriedade IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig como false e instale as dependências 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

Oferecemos suporte ao Ubuntu 20 com nenhuma configuração.

Suporte a mecanismos de renderização de HTML para PDF baseados em Chrome e WebKit
Suporte oficial para os ambientes de execução .NET Core 3.1, 5, 6 (LTS), 7 e 8.
Suporte não oficial para vários outros ambientes de execução .NET Core no Ubuntu 20
Realizar mais de 997 testes unitários nesta plataforma antes de cada lançamento.

Imagens oficiais do Docker da Microsoft:

Configuração manual do 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

Oferecemos suporte imediato ao Ubuntu 18, sem necessidade de configuração.

Suporte a mecanismos de renderização de HTML para PDF baseados em Chrome e WebKit
Suporte oficial para os ambientes de execução .NET Core 3.1 LTS e .NET 5
Oferece suporte não oficial a muitos outros runtimes do .NET Core no Ubuntu 18 e 16.
Realizar testes de fumaça completos nesta plataforma antes de cada lançamento.

Imagens oficiais do Docker da Microsoft:

Imagem Docker do Ubuntu 18.04 de 64 bits para o .NET Runtime 3.1 ('3.1-bionic')
Embora não exista uma imagem Docker oficial for .NET 5 no Ubuntu 18, a compatibilidade é muito alta.

Configuração manual do 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

Temos suporte limitado para o Ubuntu 16. O .NET no Ubuntu 16 é oficialmente suportado pela Microsoft e, segundo relatos de muitos usuários, funciona com o IronPDF. Os desenvolvedores podem precisar instalar dependências adicionais manualmente.

O Chrome e o WebKit normalmente funcionam com configuração manual.
Os runtimes .NET Core 3.1 LTS e .NET 5 têm suporte da Microsoft para Ubuntu 16.
Atualmente, não existem imagens oficiais do Docker da Microsoft para o Ubuntu 16.

Configuração manual do 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

Compatibilidade com Debian

O Debian é o nosso segundo sistema operacional Linux mais testado. Esta plataforma também possui suporte oficial do Microsoft .NET e imagens oficiais do Docker.

Debian 11

Oferecemos suporte imediato ao Debian 11, sem necessidade de configuração.

Suporte a mecanismos de renderização de HTML para PDF baseados em Chrome e WebKit
Suporte oficial para os ambientes de execução .NET Core 3.1, 5, 6 (LTS), 7 e 8.
Suporte não oficial para vários outros ambientes de execução .NET Core no Debian 11
Realizar mais de 997 testes unitários nesta plataforma antes de cada lançamento.

Imagens oficiais do Docker da Microsoft:

Configuração manual do 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

Oferecemos suporte imediato ao Debian 10, sem necessidade de configuração.

Suporte a mecanismos de renderização de HTML para PDF baseados em Chrome e WebKit
Suporte oficial para os ambientes de execução .NET Core 3.1, 5, 6 (LTS), 7 e 8.
Suporte não oficial para muitos outros ambientes de execução .NET Core no Debian 10
Realizar mais de 997 testes unitários nesta plataforma antes de cada lançamento.

Imagens oficiais do Docker da Microsoft:

Configuração manual do 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 e versões anteriores

O Debian 9 não foi oficialmente testado e não funcionará imediatamente com o IronPDF. No entanto, o .NET no Debian 9 é oficialmente suportado pela Microsoft e pode funcionar com o IronPDF se configurado corretamente. Consulte os Padrões de Dependência Comuns para Linux no final deste documento.

Não existem imagens Docker oficiais da Microsoft for .NET Core 3.1 ou .NET 5.0 no Debian 9. Recomendamos fortemente a migração para o Debian 10.

Compatibilidade com CentOS

Apoiamos ativamente o CentOS.

Suporte ao CentOS 8

Oferecemos suporte imediato ao CentOS 8, sem necessidade de configuração.

Suporte a mecanismos de renderização de HTML para PDF baseados em Chrome e WebKit
Suporte oficial para os ambientes de execução .NET Core 3.1, 5, 6 (LTS), 7 e 8.
Suporte não oficial para muitos outros ambientes de execução .NET Core no CentOS
Realizar testes de fumaça completos nesta plataforma antes de cada lançamento.

Infelizmente, não existem imagens Docker oficiais da Microsoft for .NET Core 3.1 ou .NET 5.0 no CentOS 8.

Configuração manual do CentOS 8

Se a instalação manual for necessária ou se o seu aplicativo não puder ser executado com privilégios de administrador sudo:

Conjunto 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 e versões anteriores

O CentOS 7 não foi testado e não funcionará imediatamente com o IronPDF.

No entanto, o .NET no CentOS 7 é oficialmente suportado pela Microsoft e provavelmente funcionaria com o IronPDF se configurado corretamente. Leia abaixo os Padrões de Dependência Comuns para Linux .

Não existem imagens Docker oficiais da Microsoft for .NET Core 3.1 ou .NET 5.0 no CentOS 7.

Compatibilidade do Amazon AWS com Linux 2

Temos suporte funcional para o Amazon AWS Linux 2, que constitui a base dos serviços em nuvem da Amazon, como o EC2 e o Lambda.

Não existem imagens Docker oficiais da Microsoft for .NET Core 3.1 ou .NET 5.0 no Amazon AWS Linux 2.
Durante o desenvolvimento do IronPDF, realizamos testes manuais de compatibilidade com o Amazon AWS Linux 2.

Recomendamos que você leia nosso guia do IronPDF para AWS Lambda , que contém um arquivo Docker funcional para o IronPDF no AWS Lambda.

Configuração manual do 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

Leia também nossa documentação sobre o suporte oficial ao IronPDF para AWS Lambda , que inclui instalação e registro de logs na plataforma de nuvem da Amazon.

Amazon Linux 2023

O Amazon Linux 2023 é baseado no Fedora e oferece suporte à configuração manual. Ele usa o dnf como gerenciador de pacotes.

Suporte ao mecanismo de renderização de HTML para PDF baseado no Chrome
Requer instalação manual de libxkbcommon e outras dependências compatíveis com o Fedora.
Realizamos testes manuais de compatibilidade com o Amazon Linux 2023 durante o desenvolvimento do IronPDF.

Configuração recomendada

As seguintes configurações são recomendadas ao implantar o IronPDF no 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

Manual de Configuração do 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

Compatibilidade com Fedora Linux

O Fedora Linux é suportado imediatamente, sem necessidade de configuração.

Suporte a mecanismos de renderização de HTML para PDF baseados em Chrome e WebKit
Suporte oficial para os ambientes de execução .NET Core 3.1, 5, 6 (LTS), 7 e 8.
Realizar testes de fumaça completos nesta plataforma antes de cada lançamento.

Configuração manual do 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

Compatibilidade com Alpine Linux

A execução do IronPDF no Alpine Linux não é suportada. Em 2023, o Alpine ainda utilizava bibliotecas de linguagem C "musl" desatualizadas, que ainda não permitiam aos desenvolvedores do Chromium oferecer suporte completo a este sistema operacional.

Utilizando Alpine Docker com IronPDFEngine no .NET 6

O IronPDF fornece uma imagem de contêiner contendo todas as funcionalidades do IronPDF. Isso permite que projetos em execução no Alpine acessem as funcionalidades do IronPDF conectando-se ao contêiner IronPDFEngine.

Passo 1: Baixe e execute a imagem Docker do IronPDF Engine.

Execute os seguintes comandos no seu terminal para baixar e executar a imagem Docker do 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

Etapa 2: Configurar o aplicativo Console

Crie um novo aplicativo de console direcionado ao .NET 6. Instale o pacote NuGet IronPdf.Slim usando o Gerenciador de Pacotes NuGet.

Saiba mais sobre como usar o IronPDFEngine .

Outras distribuições Linux

Você pode instalar manualmente os pré-requisitos do IronPDF para Linux usando apt-get , hfs e yum . Isso permite que você use o IronPDF em muitas distribuições Linux não oficialmente suportadas.

Durante a instalação inicial, o IronPDF pode gerar exceções para informá-lo sobre quaisquer dependências de sistema necessárias.

O IronCefSubprocess mencionado é um binário localizado na pasta bin da sua aplicação. Você pode precisar especificar um caminho exato, que pode estar no subdiretório runtimes de bin.
Você pode precisar de privilégios sudo.

Se você não tiver certeza de como proceder com um sistema operacional Linux não listado, investigue as dependências do navegador Chromium nesse sistema operacional.

Para solicitar suporte oficial para uma distribuição Linux diferente, entre em contato com support@ironsoftware.com.

Padrões de dependência comuns para Linux

Consulte os pacotes de dependência para outros sistemas operacionais Linux acima.

# 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

Identificar dependências ausentes

O ldd é uma ferramenta poderosa para diagnosticar dependências ausentes. Executando ldd IronInterop.so, você pode ver uma lista de todas as bibliotecas compartilhadas que um aplicativo requer. Uma mensagem "não encontrado" ao lado de uma biblioteca, como libcef.so => não encontrado , indica uma dependência crítica ausente que impedirá o programa de funcionar corretamente. O arquivo IronInterop.so está localizado na pasta nativa do sistema operacional específico. Por exemplo, bin/Debug/net6.0/runtimes/linux-x64/native .

ldd IronInterop.so

ldd IronInterop.so

SHELL

Subprocesso IronCef

IronCefSubprocess é um arquivo binário localizado na pasta bin do seu aplicativo. Ele precisa ser executável pelo processo .NET.

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

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

SHELL

Perguntas frequentes

Como posso converter HTML para PDF em C# no Linux?

Você pode usar o método RenderHtmlAsPdf do IronPDF para converter strings HTML em PDFs no Linux. Isso permite gerar documentos PDF diretamente a partir do conteúdo HTML.

Quais são os requisitos de sistema para usar bibliotecas PDF no Linux?

Para usar o IronPDF no Linux, os requisitos mínimos de hardware são 1 núcleo e 1,75 GB de RAM. Para um desempenho ideal, recomenda-se 2 núcleos e 8 GB de RAM, utilizando o mecanismo Chromium para renderização.

Quais distribuições Linux são compatíveis com ferramentas de geração de PDF?

O IronPDF é compatível com Ubuntu 24, 22, 20, 18, 16, Debian 11, 10, CentOS 8, Fedora Linux 33, Amazon AWS Linux 2 e Amazon AWS Linux 2023 para geração de PDFs, oferecendo uma configuração sem necessidade de ajustes para uma integração perfeita.

Posso integrar a geração de PDFs com o Docker no Linux?

Sim, o IronPDF pode ser integrado ao Docker no Linux. Ao definir LinuxAndDockerDependenciesAutoConfig como true, o IronPDF tentará instalar automaticamente todas as dependências necessárias para execução dentro do Docker.

Como faço para instalar ferramentas de geração de PDF em um ambiente Linux?

Instale o IronPDF no Linux usando o pacote NuGet IronPdf.Linux ou baixe a DLL do site do IronPDF. Certifique-se de que todas as dependências estejam instaladas corretamente e que IronCefSubprocess esteja configurado como executável.

Quais versões do .NET são adequadas para geração de PDFs em plataformas Linux?

O IronPDF é compatível com .NET 10, 9, 8, 7, 6, 5 e .NET Core para geração de PDFs no Linux. Recomenda-se o uso de versões com suporte de longo prazo (LTS), como o .NET Core 3.1, para maior estabilidade e desempenho.

É viável executar a geração de PDFs no Alpine Linux?

O uso direto do IronPDF no Alpine Linux não é suportado devido a problemas de compatibilidade com as bibliotecas C musl. No entanto, o uso de um contêiner Docker do IronPDFEngine pode facilitar as funcionalidades de PDF no Alpine.

O que devo fazer se encontrar um erro de dependência ausente com as ferramentas de PDF no Linux?

Caso ocorra um erro de dependência ausente, instale manualmente os pacotes necessários usando gerenciadores de pacotes como apt-get, dnf ou yum, de acordo com os requisitos da sua distribuição Linux.

Distribuições Linux não suportadas podem usar ferramentas de geração de PDF?

O IronPDF pode ser usado em distribuições Linux não suportadas, instalando manualmente as dependências necessárias. Recomenda-se consultar as dependências do Chromium para obter orientações sobre instalações manuais.

Como posso melhorar o desempenho da geração de PDFs em um ambiente Linux?

Para otimizar o IronPDF no Linux, certifique-se de que LinuxAndDockerDependenciesAutoConfig esteja ativado para a configuração automática de dependências. Utilize pacotes NuGet otimizados para Linux e crie um diretório gravável para arquivos temporários.

Existe algum guia específico para configurar ferramentas de PDF no AWS Lambda?

Sim, a IronPDF disponibiliza um Guia de Configuração do AWS Lambda em seu site, com instruções detalhadas sobre como configurar o IronPDF para uso em ambientes AWS Lambda.

Curtis Chau

Converse agora mesmo com a equipe de engenharia.

Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronPdf
executar um exemplo Veja seu HTML se transformar em um PDF.

Ver licenças

Experimente gratuitamente por 30 dias.

Nesta página

Usando o IronPDF no Linux

Dicas para usar o IronPDF no Linux

Pacotes específicos para Linux

Distribuições Linux oficialmente suportadas

Especificações de hardware

Configuração automática do Linux

Compatibilidade com Ubuntu

Ubuntu 24

Ubuntu 20

Ubuntu 18

Ubuntu 16

Compatibilidade com Debian

Debian 11

Debian 10

Debian 9 e versões anteriores

Compatibilidade com CentOS

Suporte ao CentOS 8

CentOS 7 e versões anteriores

Compatibilidade do Amazon AWS com Linux 2

Amazon Linux 2023

Compatibilidade com Fedora Linux

Compatibilidade com Alpine Linux

Utilizando Alpine Docker com IronPDFEngine no .NET 6

Outras distribuições Linux

Padrões de dependência comuns para Linux

Identificar dependências ausentes

Subprocesso IronCef

Perguntas frequentes

Como posso converter HTML para PDF em C# no Linux?

Quais são os requisitos de sistema para usar bibliotecas PDF no Linux?

Quais distribuições Linux são compatíveis com ferramentas de geração de PDF?

Posso integrar a geração de PDFs com o Docker no Linux?

Como faço para instalar ferramentas de geração de PDF em um ambiente Linux?

Quais versões do .NET são adequadas para geração de PDFs em plataformas Linux?

É viável executar a geração de PDFs no Alpine Linux?

O que devo fazer se encontrar um erro de dependência ausente com as ferramentas de PDF no Linux?

Distribuições Linux não suportadas podem usar ferramentas de geração de PDF?

Como posso melhorar o desempenho da geração de PDFs em um ambiente Linux?

Existe algum guia específico para configurar ferramentas de PDF no AWS Lambda?

Ainda está rolando a tela?

Want to deploy IronSuite to a live project for FREE?

What’s included?

Thank You

Want to deploy IronSuite to a live project for FREE?

What’s included?

Aprovado por milhões de engenheiros em todo o mundo.

Equipe de suporte de ferro