Windows Server Core 2019 容器中为 IIS 添加字体，解决 PDF 字体缺失问题

2024-10-15 19:29:54

在 Windows Server Core 2019 容器中运行 IIS，为 HTTP 转 PDF 网络解决方案提供服务，的确是一个高效便捷的选择。但是，Server Core 系统自带的字体数量有限，而你安装的新字体 IIS 却无法识别，这会导致生成的 PDF 文件出现字体缺失，影响文档的质量和美观。本文将深入探讨 Windows 字体加载机制，并提供三种解决方案，帮助你在 Windows Server Core 2019 容器中为 IIS 添加新字体，使你的 PDF 文件不再“面目全非”。

Windows 系统中，应用程序加载字体主要依赖于注册表和字体缓存。安装新字体时，系统会将字体信息写入注册表，并更新字体缓存。IIS 作为一个系统服务，它加载字体的方式与普通应用程序略有不同。IIS 依赖于 Windows 字体缓存服务来获取字体信息。当字体缓存服务检测到字体文件发生变化时，它会自动更新缓存。然而，在 Server Core 容器环境下，由于资源和服务的限制，字体缓存服务的自动更新机制可能无法正常工作，导致 IIS 无法识别新安装的字体。

既然 IIS 无法自动识别新字体，我们就需要手动“提醒”它。一种可行的方案是重建字体缓存。在传统的 Windows Server 系统中，我们可以通过重启 IIS 服务或使用一些字体管理工具来实现。但在 Server Core 容器中，由于没有图形界面和许多系统工具，操作起来会略显复杂。下面介绍三种解决方案，帮助你解决这个问题。

方案一：利用 Dockerfile 构建镜像时重建字体缓存

我们可以在 Dockerfile 中添加命令，在构建镜像的过程中重建字体缓存。这样，当容器启动时，IIS 就能直接使用更新后的字体缓存。

以下是一种常用的方法：

# ... 其他 Dockerfile 指令 ...

# 安装新字体
COPY Fonts/* /Windows/Fonts/

# 重建字体缓存
RUN fc-cache -fv

# ... 其他 Dockerfile 指令 ...

fc-cache -fv 命令会强制刷新系统字体缓存，并将结果输出到控制台。这种方法的优点是在构建镜像时就完成了字体安装和缓存重建，容器启动后可以直接使用新字体，无需额外操作。

方案二：进入容器内部手动重建字体缓存

如果你的镜像已经构建完成，或者你希望在运行中的容器中添加新字体，那么你可以通过进入容器内部手动执行 fc-cache 命令。

首先，使用以下命令进入容器：

docker exec -it <容器ID或名称> powershell

然后，在容器内部执行 fc-cache -fv 命令重建字体缓存。这种方法的优点是灵活，可以在任何时候添加新字体并重建缓存，但需要手动操作，稍微繁琐一些。

方案三：使用 PowerShell 脚本自动化字体安装和缓存重建

为了简化操作，我们可以将字体安装和缓存重建的步骤整合到一个 PowerShell 脚本中。

以下是一个示例脚本：

# 复制字体文件到系统字体目录
Copy-Item -Path "C:\Fonts\*" -Destination "C:\Windows/Fonts/" -Force

# 重建字体缓存
fc-cache -fv

你可以将这个脚本添加到 Dockerfile 中，或者在容器启动后手动执行。这种方法结合了方案一和方案二的优点，既可以自动化操作，又可以灵活地添加新字体。

完成以上操作后，你可以通过以下几种方式验证字体是否已经被 IIS 正确加载：

查看 IIS 日志 : 如果字体加载失败，IIS 日志中可能会出现相关的错误信息，例如“找不到字体”或“无法加载字体”。
生成测试 PDF 文件 : 使用你的 HTTP 转 PDF 解决方案生成一个测试 PDF 文件，并检查其中是否使用了新字体。你可以使用文本编辑器或 PDF 阅读器打开 PDF 文件，查看字体信息。
使用字体查看工具 : 在容器内部安装一个字体查看工具，例如 FontView，查看系统中已安装的字体列表。如果新字体出现在列表中，说明字体已经成功安装并被系统识别。

在 Windows Server Core 2019 容器中为 IIS 添加新字体，需要我们对字体加载机制和容器环境有一定的了解。通过重建字体缓存，我们可以让 IIS 正确识别和使用新字体，从而解决 PDF 文件字体缺失的问题。本文提供的方案能够帮助你解决实际问题，让你的网络解决方案更加完善。

需要注意的是，以上方案并非万能的，具体操作可能因环境和应用场景而异。在实际操作过程中，建议你根据自身情况选择合适的方案，并进行充分的测试，确保字体能够被 IIS 正确加载和使用。