1. IronPDF
  2. トラブルシューティング
  3. Windows Server Core コンテナ上のIronPDF

Windows Server Coreコンテナ上のIronPDF

Curtis Chau
Curtis Chau
更新日:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDFは、コンテンツを正しくレンダリングするためにシステムフォントを必要とします。 Windows Server Core 2019および2022は、ほとんど何も他に持たず、主にルコーンしか持っていないため、適切な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
  今すぐエンジニアリングチームとチャット
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT（Internet of Things）への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか？
Nuget ダウンロード 20,296,129 | バージョン: 2026.7 リリースされたばかり
Still Scrolling Icon

まだスクロールしていますか?

すぐに証拠が欲しいですか? PM > Install-Package IronPdf
サンプルを実行するHTML が PDF に変換されるのを確認します。