Windows Server Core容器中的IronPDF
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
Text
每行都有其作用:
- **
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。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。
...
阅读更多