Docker解决容器中文字体乱码问题的终极方案分享

更新时间：2025年09月16日 09:44:49 作者：寒冰碧海

在腾讯云服务器使用Docker部署Java后端服务时,经常遇到生成图片、PDF或报表时中文显示为方框的问题,这是因为基础Docker镜像通常不包含中文字体,下面我们就来看看如何解决吧

问题背景

在腾讯云服务器使用Docker部署Java后端服务时，经常遇到生成图片、PDF或报表时中文显示为方框的问题。这是因为基础Docker镜像通常不包含中文字体，导致Java应用无法正确渲染中文文本。

解决方案：四步添加中文字体

步骤1：获取字体文件

从Windows系统拷贝所需字体（推荐使用宋体simsun.ttc）：

打开Windows字体目录：C:\Windows\Fonts

复制字体文件（我的操作是全放）

通过FTP/SFTP或SCP上传到Linux服务器

步骤2：宿主机准备字体目录

在服务器上创建字体存储目录并复制字体：

# 创建字体目录（推荐使用标准位置）
sudo mkdir -p /usr/local/share/fonts/chinese

# 复制字体到该目录
sudo cp /tmp/simsun.ttc /usr/local/share/fonts/chinese/

# 设置权限
sudo chmod 644 /usr/local/share/fonts/chinese/*

步骤3：复制字体到Docker容器

将字体复制到运行中的容器内：

# 语法：docker cp <宿主机路径> <容器名>:<容器内路径>
docker cp /usr/local/share/fonts/chinese/simsun.ttc your-container:/usr/share/fonts/

# 示例（容器名为app-server）：
docker cp /usr/local/share/fonts/chinese/simsun.ttc app-server:/usr/share/fonts/

步骤4：容器内安装字体支持

进入容器安装字体工具并刷新缓存：

# 进入容器
docker exec -it your-container bash

查看镜像类型：

command -v apt-get || command -v yum || command -v apk

结果判断：

/usr/bin/apt-get → Debian/Ubuntu
/usr/bin/yum 或 /usr/bin/dnf → CentOS/RHEL
/sbin/apk → Alpine

根据镜像类型选择安装命令：

# 🔹 Debian/Ubuntu 镜像
apt-get update && apt-get install -y fontconfig

# 🔸 CentOS/RHEL 镜像
yum install -y fontconfig

# 🔹 Alpine 镜像
apk update && apk add fontconfig

刷新字体缓存并验证：

# 刷新字体缓存
fc-cache -fv

# 验证字体安装
fc-list | grep -i "simsun"
# 预期输出：/usr/share/fonts/simsun.ttc: SimSun,宋体:style=Regular

进阶方案：构建时集成字体

创建自定义Dockerfile，永久解决字体问题：

FROM openjdk:11-jre-slim

# 1️⃣ 安装字体工具
RUN apt-get update && apt-get install -y fontconfig

# 2️⃣ 创建字体目录
RUN mkdir -p /usr/share/fonts/chinese

# 3️⃣ 添加字体文件（需提前放在Dockerfile同目录的fonts/下）
COPY fonts/simsun.ttc /usr/share/`在这里插入代码片`fonts/chinese/

# 4️⃣ 刷新字体缓存
RUN fc-cache -fv

# 后续构建步骤...

构建命令：

docker build -t java-with-chinese-fonts .

注意事项

字体授权：确保使用的字体有合法授权，商业字体需购买授权

容器重启：动态添加的字体在容器重启后会丢失，推荐使用Dockerfile方案

字体路径：Java应用默认搜索/usr/share/fonts，如需自定义路径需设置环境变量：

ENV JAVA_FONTS /usr/share/fonts/chinese

字体精简：Alpine镜像建议使用精简字体包：

apk add --no-cache font-noto-cjk

总结

通过以上步骤，我们成功解决了Docker容器中Java应用的中文字体缺失问题。关键点：

步骤	关键操作	命令示例
字体准备	从Windows提取	scp fonts user@server:/tmp
宿主机存储	创建字体目录	mkdir /usr/local/share/fonts/chinese
容器复制	动态添加字体	docker cp font.ttc container:/usr/share/fonts
容器配置	安装fontconfig	apt-get install fontconfig && fc-cache -fv

最佳实践：对于生产环境，强烈推荐使用Dockerfile构建包含字体的自定义镜像，一劳永逸解决字体问题！

到此这篇关于Docker解决容器中文字体乱码问题的终极方案分享的文章就介绍到这了,更多相关Docker容器中文字体乱码解决内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Docker的MySQL容器时区问题修改
这篇文章主要给大家介绍了关于Docker的MySQL容器时区问题修改的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
2020-07-07
Docker搭建私有仓库(registry与Harbor)的实现
这篇文章主要介绍了Docker搭建私有仓库(registry与Harbor)的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-12-12
docker删除none镜像的操作方法
删除none的镜像，要先删除镜像中的容器，要删除镜像中的容器，必须先停止容器，这篇文章主要介绍了docker删除none镜像的操作方法,需要的朋友可以参考下
2023-01-01
Docker安装Nacos详细图文教程
这篇文章主要为大家详细介绍了Docker安装Nacos详细图文教程，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-07-07
docker compose安装、使用及快速入门教程
Docker Compose是一个用于定义和运行多容器Docker应用程序的工具,这篇文章给大家介绍docker-compose 如何安装、使用及快速入门,感兴趣的朋友跟随小编一起看看吧
2026-05-05
Docker镜像大小查看和排序方法小结
在 Docker 日常使用中,随着镜像数量的增加,磁盘空间管理变得尤为重要,了解如何有效地查看和排序 Docker 镜像大小不仅可以帮助我们释放宝贵的磁盘空间,还能优化容器的构建和部署流程,所以本文给大家总结了Docker镜像大小查看和排序方法,需要的朋友可以参考下
2025-05-05
如何解决mysql配置文件错误导致在docker中无法启动的问题
这篇文章主要介绍了如何解决mysql配置文件错误导致在docker中无法启动的问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-01-01
CentOS7构建docker-ce的过程详解
使用CentOS 7.9系列的Linux操作系统,从CentOS系统基础配置开始,0到1快速构建docker应用,本文给大家分享CentOS7构建docker-ce的过程,感兴趣的朋友跟随小编一起看看吧
2024-05-05
dockerExecute 函数和docker.build的区别解析
dockerExecute 通常是一个自定义的函数或者由特定的 Jenkins 库（如 piper-lib）提供,用于在 Docker 容器中执行特定的命令,这篇文章主要介绍了dockerExecute 函数和docker.build的区别,需要的朋友可以参考下
2024-12-12
Dockerfile基础分享
在Docker中，构建一个自定义镜像共有两种方法，一是通过commit指令构建，二是通过Dockerfile文件构建。今天我们主要来详细探讨下Dockerfile的一些基础。
2017-01-01