IRONSOFTWAREHOME

Problema de Dependência do IronPDF no Ubuntu 24.04 no .NET 9 e .NET 10

Curtis Chau
Curtis Chau
Updated: 10 de junho de 2026

No Ubuntu 24.04 com .NET 9 ou .NET 10, o IronPDF não consegue instalar suas dependências de sistema necessárias na inicialização. Isso afeta imagens do Azure Linux e ambientes Linux não-Docker onde o aplicativo não é executado com privilégios de raiz.

E: Could not open lock file /var/lib/apt/lists/lock - open (13: Permission denied)
E: Unable to lock directory /var/lib/apt/lists/
Text

O Ubuntu 24.04 renomeou a biblioteca de áudio de libasound2 para libasound2t64. O instalador automático de dependências do IronPDF tem como alvo o nome do pacote original libasound2 e não pode adquirir o bloqueio APT ao ser executado como um usuário não raiz, produzindo o erro de permissão mostrado acima.

Solução

Opção 1: Ativar configuração automática de dependências (Docker e Azure Linux)

Defina LinuxAndDockerDependenciesAutoConfig para true antes da primeira chamada de renderização:

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

Para capturar a saída de diagnóstico durante a inicialização, ative o registro de arquivos:

IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.File;
IronSoftware.Logger.LogFilePath = "ironpdf.log";

Opção 2: Primeira execução com privilégios elevados (Linux não-Docker)

Para ambientes Linux não-Docker, execute o aplicativo uma vez com privilégios elevados para que o IronPDF possa instalar os pacotes necessários.

sudo -E dotnet run
SHELL

Se dotnet não for encontrado sob sudo, use o caminho completo:

sudo -E ~/.dotnet/dotnet run
SHELL

Após a primeira execução instalar as dependências, execuções subsequentes não requerem privilégios elevados. Para a lista completa de pacotes necessários no Ubuntu 24.04, veja o guia de implantação do Linux.

(Este problema foi resolvido no IronPDF 2026.3.x. Atualizar para essa versão ou posterior significa que a renomeação da biblioteca libasound2t64 é detectada automaticamente sem exigir configuração manual.)

Curtis Chau
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 bem estruturados e visualmente atraentes.

...
Leia mais

Pronto para começar?

Nuget Downloads 20,878,335Versão:2026.9recém-lançado

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.
Biblioteca NuGet C# para PDF
Instalar com NuGet

Versão: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. No Solution Explorer, clique com o botão direito do mouse em Referências e selecione Gerenciar Pacotes NuGet.
  2. Selecione Procurar e pesquise "IronPDF".
  3. Selecione o pacote e instale.
DLL de PDF em C#
Baixar DLL

Versão: 2026.9

ou faça o download do Windows Installer aqui .

  1. Baixe e descompacte o IronPDF em um local como ~/Libs dentro do diretório da sua solução.
  2. No Solution Explorer do Visual Studio, clique com o botão direito do mouse em Referências. Selecione Procurar e digite "IronPDF.dll".

Licenças a partir de US$ 749

Key in blue circle

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.

Your trial license will be sent to your email address

Sem limitações. 100% desbloqueado. Sem cartão de crédito.

bullet_checkedNão é necessário cartão de crédito nem criação de conta.Sem limitações. 100% desbloqueado. Sem cartão de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Agende sua demonstração ao vivo gratuita.
Booking Badge

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

Logotipos dos clientes da Iron Software
Agende sua consulta sem compromisso.
Preencha o formulário abaixo ou envie um e-mail para sales@ironsoftware.com
Os seus dados serão sempre mantidos em sigilo.
Aprovado por milhões de engenheiros em todo o mundo.
Logotipos dos clientes da Iron Software
Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.