在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擁有Carleton大學的電腦科學學士學位,專精於前端開發,擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面,喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。
...
閱讀更多