在Linux Docker容器中嵌入自定义字体到IronPDF中
Curtis Chau
Updated: 2026年6月10日
在Windows上生成PDF时自定义字体正确嵌入，但在Linux Docker容器内嵌入失败。 取而代之的是，渲染器使用DejaVu Sans作为替代。
在Linux系统和Docker容器中，字体必须明确安装或引用。 如果Chrome渲染引擎无法获取可用字体，IronPDF会替换系统的默认后备字体，导致视觉差异和嵌入失败。
解决方案
选项1：安装Microsoft核心字体如Arial及类似字体
添加到您的Dockerfile中：
RUN apt update && apt install -y ttf-mscorefonts-installerText
选项2：通过@font-face嵌入自定义字体
对于非系统字体，如Poppins或Roboto，在HTML中使用.ttf文件路径：
<!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：使用Print CSS媒体类型
设置@font-face声明：
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。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。
...
阅读更多
