Windows Server Core 컨테이너에서의 IronPDF

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

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 렌더링 중 사용할 수 있도록 합니다.

문서에서 사용되는 다른 서체에 대해 COPY 및 RUN 쌍을 반복합니다.

주의: 이것은 Windows Server Nano 컨테이너에서 작동하지 않습니다. Nano Server는 키 폰트 렌더링 라이브러리가 부족한 축소된 이미지이며 폰트 설치를 지원하지 않아 IronPDF를 실행할 수 없습니다.

Curtis Chau

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

...

더 읽어보기