Windows Server Core 컨테이너에서의 IronPDF

업데이트됨:6월 28, 2026

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

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

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

Curtis Chau

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

기술 문서 작성자

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

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?

Nuget 다운로드 20,296,129 | 버전: 2026.7 방금 출시