如何在.NET 8微软精简Docker容器中安装字体

问题背景 #

我正在开发一个.NET 8 API项目，使用ImageMagick库给图片添加文字水印，部署在Linux Docker容器中时遇到了以下错误：

{ImageMagick.MagickTypeErrorException: UnableToReadFont `arial' @ error/annotate.c/RenderFreetype/1654

之前在非精简容器（mcr.microsoft.com/dotnet/aspnet:8.0）中，我通过在Dockerfile中添加字体安装代码解决了问题：

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base

#install fonts
RUN echo "deb http://deb.debian.org/debian/ bookworm main contrib" > /etc/apt/sources.list && \
    echo "deb-src http://deb.debian.org/debian/ bookworm main contrib" >> /etc/apt/sources.list && \
    echo "deb http://security.debian.org/ bookworm-security main contrib" >> /etc/apt/sources.list && \
    echo "deb-src http://security.debian.org/ bookworm-security main contrib" >> /etc/apt/sources.list
RUN sed -i'.bak' 's/$/ contrib/' /etc/apt/sources.list
RUN apt-get update; apt-get install -y ttf-mscorefonts-installer fontconfig

WORKDIR /app
EXPOSE 8080

但生产环境使用的是基于Ubuntu的精简容器mcr.microsoft.com/dotnet/aspnet:8.0-jammy-chiseled，请问如何在此容器中安装字体？

我的完整Dockerfile如下：

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["DemoAPI/DemoAPI.csproj", "DemoAPI/"]
COPY ["nuget.config", "nuget.config"]
RUN dotnet restore "DemoAPI/DemoAPI.csproj" --ignore-failed-sources
COPY . .
WORKDIR "/src/DemoAPI"
RUN dotnet build "DemoAPI.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "DemoAPI.csproj" -c Release -o /app/publish

FROM mcr.microsoft.com/dotnet/nightly/aspnet:8.0-jammy-chiseled
WORKDIR /app
EXPOSE 8080
COPY --from=publish /app/publish .
ENV SPYENV_Urls=http://+:8080
ENTRYPOINT ["dotnet", "DemoAPI.dll"]

解决方案 #

针对Ubuntu jammy-chiseled精简容器，提供两种可行方案：

方案1：安装开源替代字体（无需额外源） #

chiseled容器基于Ubuntu，默认源包含开源字体，可直接安装Arial的开源替代字体（如fonts-dejavu-core的DejaVu Sans），同时安装fontconfig管理字体：

FROM mcr.microsoft.com/dotnet/nightly/aspnet:8.0-jammy-chiseled
WORKDIR /app
EXPOSE 8080

# 安装开源字体和fontconfig，--no-install-recommends减少镜像体积
RUN apt-get update && apt-get install -y --no-install-recommends fonts-dejavu-core fontconfig && \
    rm -rf /var/lib/apt/lists/*

# 更新字体缓存，确保ImageMagick识别
RUN fc-cache -fv

COPY --from=publish /app/publish .
ENV SPYENV_Urls=http://+:8080
ENTRYPOINT ["dotnet", "DemoAPI.dll"]

之后在代码中用DejaVu-Sans替代Arial，或配置ImageMagick将其设为默认字体。

方案2：手动添加自定义字体（如Arial） #

若必须使用Arial，可将字体文件直接打包进容器：

1. 在项目根目录创建fonts文件夹，放入arial.ttf字体文件。
2. 修改Dockerfile：

FROM mcr.microsoft.com/dotnet/nightly/aspnet:8.0-jammy-chiseled
WORKDIR /app
EXPOSE 8080

# 创建字体目录并复制字体文件
RUN mkdir -p /usr/share/fonts/truetype/arial
COPY fonts/arial.ttf /usr/share/fonts/truetype/arial/

# 安装fontconfig并更新缓存
RUN apt-get update && apt-get install -y --no-install-recommends fontconfig && \
    rm -rf /var/lib/apt/lists/* && \
    fc-cache -fv

COPY --from=publish /app/publish .
ENV SPYENV_Urls=http://+:8080
ENTRYPOINT ["dotnet", "DemoAPI.dll"]

该方式无需修改系统源，适配精简容器环境。

注意事项 #

• chiseled容器为极简环境，虽支持apt-get操作，但需用--no-install-recommends避免安装不必要依赖，控制镜像体积。
• 安装字体后必须执行fc-cache -fv更新缓存，否则ImageMagick无法识别新字体。

内容的提问来源于stack exchange，提问作者Divyang Desai