ONLYOFFICE Docker版文档服务器字体安装指南

前言

在使用ONLYOFFICE文档服务器时，用户可能会遇到系统默认字体不满足需求的情况。本文将以Docker容器部署的ONLYOFFICE文档服务器为例，详细介绍如何添加自定义字体（如Calibri字体）到系统中。

字体安装原理

ONLYOFFICE文档服务器在启动时会自动扫描系统字体目录，但需要注意的是：

1. 官方Docker镜像默认不包含商业字体（如Calibri）
2. 字体需要放置在特定目录才能被识别
3. 添加新字体后需要触发字体缓存更新

具体操作步骤

1. 准备字体文件

首先确保拥有合法的字体文件（如calibri.ttf）。由于版权原因，请确保您有权使用该字体。

2. 挂载字体目录

在Docker容器中，推荐通过卷挂载的方式添加字体：

docker run ... -v /本地字体目录:/usr/share/fonts/truetype/custom ...

将字体文件放入本地目录后，它们会自动同步到容器内。

3. 触发字体更新

对于8.1.x版本，需要执行以下操作之一：

• 重启Docker容器（推荐）
• 在容器内执行documentserver-generate-allfonts.sh脚本（如果存在）

从8.2.0版本开始，系统会自动检测新字体，无需额外操作。

4. 清除浏览器缓存

对于8.1.x版本，添加新字体后需要：

1. 完全关闭浏览器
2. 清除浏览器缓存
3. 重新打开ONLYOFFICE页面

注意事项

1. 字体文件权限：确保字体文件具有可读权限
2. 字体格式：支持TrueType(.ttf)和OpenType(.otf)格式
3. 命名规范：建议使用英文命名，避免特殊字符
4. 容器版本差异：不同版本的处理方式可能略有不同

常见问题排查

如果字体仍未显示：

1. 检查容器日志确认字体加载过程
2. 验证字体文件是否完整
3. 确认挂载路径正确
4. 尝试使用其他字体测试

结语

通过以上步骤，用户可以轻松扩展ONLYOFFICE文档服务器的字体支持。建议定期检查字体授权状态，确保合规使用。对于企业用户，可以考虑创建包含常用字件的自定义Docker镜像以简化部署流程。