在Windows Server Core容器上的IronPDF

This article was translated from English: Does it need improvement?
Translated
View the article in English

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

每行都應有其位置:

  • USER ContainerAdministrator: 授予修改系統註冊表和安裝字型所需的許可。
  • COPY arial.ttf c:/windows/fonts/arial.ttf: 將Arial字型文件放入系統字型目錄。
  • New-ItemProperty: 註冊Arial,使系統可以識別並在PDF渲染時使用。

對您的文件所依賴的任何其他字型重複RUN對。

小心這不適用於Windows Server Nano容器。 Nano Server是一個削減版的映像,缺乏關鍵字體渲染庫且不支持字體安裝,因此IronPDF無法在其上運行。

Curtis Chau
技術作家

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

除了開發,Curtis對物聯網(IoT)有濃厚的興趣,探索創新的方法來整合硬體和軟體。在空閒時間,他喜歡玩遊戲和建立Discord機器人,結合他對技術的熱愛與創造力。

準備開始了嗎?
Nuget 下載 20,296,129 | 版本: 2026.7 剛剛發布
Still Scrolling Icon

還在捲動嗎?

想快速獲得證明嗎? PM > Install-Package IronPdf
執行範例 看您的HTML變成PDF。