IronPDF em Contêineres Windows Server Core

Atualizado:junho 28, 2026

Translated

View the article in English

IronPDF precisa de fontes do sistema para renderizar conteúdo corretamente. O Windows Server Core 2019 e 2022 são enviados com quase nada, principalmente apenas Lucon, que não é suficiente para uma saída de PDF adequada. A solução é instalar as fontes que você precisa, como Arial, diretamente na imagem do contêiner.

Solução

Adicione a fonte ao diretório de fontes do sistema e registre-a para que o renderizador possa encontrá-la. O Dockerfile abaixo copia arial.ttf para o lugar e escreve a entrada correspondente no registro:

FROM mcr.microsoft.com/dotnet/sdk:8.0-windowsservercore-ltsc2022 as base
USER ContainerAdministrator
WORKDIR C:/

COPY arial.ttf c:/windows/fonts/arial.ttf
RUN powershell.exe -NoProfile -Command New-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts' -Name 'Arial (TrueType)' -PropertyType String -Value arial.ttf

Cada linha ganha seu lugar:

USER ContainerAdministrator: concede a permissão necessária para modificar o registro do sistema e instalar fontes.
COPY arial.ttf c:/windows/fonts/arial.ttf: coloca o arquivo de fonte Arial no diretório de fontes do sistema.
New-ItemProperty: registra Arial para que o sistema a reconheça e possa usá-la durante a renderização do PDF.

Repita o par COPY e RUN para qualquer outro tipo de letra de que seus documentos dependam.

CuidadoIsso não funciona com contêineres do Windows Server Nano. O Nano Server é uma imagem reduzida que carece de bibliotecas de renderização de fontes chave e não suporta instalação de fontes, portanto o IronPDF não pode ser executado nele.

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