docker-compose: 在容器中添加中文字体

利用 docker-compose 的 volumes 及 build 来配置容器内的中文字体。

前言

先上案例代码: liumapp/add-mandarin-fonts-in-docker

Docker 容器内运行的项目，涉及到中文字体的输出时如果没有其他配置，一般都是以乱码结尾。

总结其原因，其实就跟 Linux 下没有中文字体一样。

在 Docker 下部署中文字体，除了写 Dockerfile 之外，也可以利用 docker exec 命令进入容器内部安装字体，但...

这些都太麻烦了呀.....

网络上很多复制粘贴的帖子也都是这样的套路...

其实利用 docker-compose 简单进行两项配置就可以了，完全不用再做其他多余的事情。

docker-compose 配置

先上 docker-compose.yml 的内容

version: '2'

services:
  mandarin:
	container_name: mandarin
	restart: always
	image: liumapp/add-mandarin-fonts-in-docker:v1.0.0
	build:
	  context: .
	  args:
		- LANG=C.UTF-8
	ports:
	  - 8080:8080
	volumes:
	  - ./fonts:/usr/share/fonts
	  - ./pdf:/pdf
	  - ./doc:/doc

比较特殊的地方就两个:build 跟 volumes

build

build:
  context: .
  args:
	- LANG=C.UTF-8
	

设置容器内编码为 UTF-8，使之支持中文字体。

volumes

volumes:
  - ./fonts:/usr/share/fonts
  - ./pdf:/pdf
  - ./doc:/doc

将宿主机，或者说项目下的 fonts 目录下的中文字体全部与容器内的/usr/share/fonts 建立关联，使绝大多数的中文字体都能够被找到。

另外补充一下，案例项目下的 fonts 目录有大约 300 多 M，下面的字体文件是来自于 windows7 下字体库的所有.ttf 和.ttc 结尾的字体文件，这样做的理由，是因为仅仅让 Docker 支持中文字体是远远不够的，我们很多的需求，比如文档转换、图片转换都是需要用到很多不同的字体，所以方便起见，直接拷贝 windows7 下所有的相关字体是最直截了当的方式。

fontconfig

可能有人会注意到，一般在 Linux 下面配置中文字体都是需要用到 fontconfig 这样的工具，然而，在以 Java:8 为 baseImage 的项目下，fontconfig 是自动配置好了的，所以我们不需要额外关心这个家伙。

不过 Java:8 以外的我就没有去尝试了，估计就要多做几步了吧 ～