리눅스 Docker 컨테이너에서 IronPDF로 사용자 지정 글꼴 내장

Updated: 2026년 6월 10일

Windows에서 PDF를 생성할 때 사용자 지정 글꼴이 제대로 내장되지만 Linux Docker 컨테이너 내에서는 내장이 실패합니다. 의도한 글꼴 대신 렌더러는 대체 글꼴로 DejaVu Sans를 사용합니다.

Linux 시스템 및 Docker 컨테이너 내에서는 글꼴을 명시적으로 설치하거나 참조해야 합니다. Chrome 렌더링 엔진에서 글꼴을 사용할 수 없는 경우, IronPDF는 시스템의 기본 대체 글꼴을 대체하여 시각적 차이와 내장 실패를 초래합니다.

해결책

옵션 1: Arial 및 유사한 글꼴을 위한 Microsoft 핵심 글꼴 설치

Dockerfile에 추가하십시오:

RUN apt update && apt install -y ttf-mscorefonts-installer

RUN apt update && apt install -y ttf-mscorefonts-installer

Dockerfile

옵션 2: @font-face로 사용자 지정 글꼴 내장

Poppins 또는 Roboto와 같은 비시스템 글꼴의 경우 Docker 이미지 내부에 번들로 제공되는 .ttf 파일에 대한 경로와 함께 HTML에서 @font-face을 사용하여 선언하세요:

<!DOCTYPE html>
<html>
<head>
<style>
@font-face {
    font-family: 'Poppins';
    src: url('fonts/Poppins-Regular.ttf');
}
p {
    font-family: 'Poppins';
    font-size: 16px;
}
</style>
</head>
<body>
<p>Custom font text</p>
</body>
</html>

<!DOCTYPE html>
<html>
<head>
<style>
@font-face {
    font-family: 'Poppins';
    src: url('fonts/Poppins-Regular.ttf');
}
p {
    font-family: 'Poppins';
    font-size: 16px;
}
</style>
</head>
<body>
<p>Custom font text</p>
</body>
</html>

HTML

옵션 3: 인쇄 CSS 미디어 유형 사용

인쇄에 특화된 스타일을 적용하기 위해 CssMediaType을 설정하고, @font-face 선언을 포함하세요:

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print

전체 Linux Docker 설정은 IronPDF Docker 가이드를 참조하십시오.

Curtis Chau

기술 문서 작성자

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

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

더 읽어보기