Windows Server Core容器中的IronPDF

Curtis Chau
Curtis Chau
Updated: 2026年6月29日

IronPDF需要系统字体以正确渲染内容。 Windows Server Core 2019和2022几乎没有什么,主要是Lucon,这不足以输出合适的PDF。 解决方案是直接在容器镜像中安装您需要的字体,如Arial。

解决方案

将字体添加到系统字体目录中并注册,以便渲染器可以找到它。 下面的Dockerfile将arial.ttf复制到位置并写入匹配的注册表项:

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
Dockerfile

每行都有其作用:

  • USER ContainerAdministrator:授予修改系统注册表和安装字体所需的权限。
  • COPY arial.ttf c:/windows/fonts/arial.ttf:将Arial字体文件放置到系统字体目录中。
  • New-ItemProperty:注册Arial以使系统识别并在PDF渲染期间使用它。

对于您的文档依赖的任何其他字体,重复RUN配对。

注意: 这在Windows Server Nano容器上不起作用。) Nano Server是一个精简图像,缺少关键的字体渲染库,不支持字体安装,所以IronPDF无法在其上运行。)]

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

阅读更多

准备开始了吗?

Nuget Downloads 22,024,882版本:2026.11刚刚发布