LibreOffice 与文档转换
基础版及以上商业版功能
校对日期:2026-11-16。Word 文档导入需要商业版基础版及以上;社区版没有这些功能,不需要安装 LibreOffice。
UJCMS 有两类功能会用到文档转换:
| 功能 | 是否需要 LibreOffice |
|---|---|
文章编辑器导入 .docx、.doc、.wps | 不需要,由程序内置的引擎处理 |
导入 .rtf、.odt 等其它格式 | 需要 |
| 把 Office 文档转成 PDF(文库文章的在线预览等) | 需要 |
所以只在用到后两项时才需要安装和配置 LibreOffice。导入功能的用法见文章管理。
一、Docker 部署
官方镜像已经装好了 LibreOffice 和中文字体,用环境变量开启即可:
| 环境变量 | 默认值 | 说明 |
|---|---|---|
UJCMS_ | false | 设为 true 开启。仓库自带的 compose.yaml 已设为 true |
UJCMS_ | /usr/ | LibreOffice 的安装目录,使用官方镜像时不用改 |
使用不含 LibreOffice 的自制镜像时不要开启:找不到 LibreOffice,程序会启动失败。
二、Jar 与 Tomcat 部署
安装 LibreOffice。 Windows 从 https://zh-cn.libreoffice.org/download/libreoffice/ 下载安装;Linux 一般可以直接从系统的软件源安装, 如使用
dnf/yum的发行版:bashdnf install libreoffice libreoffice-headless修改配置。 在
application.(Jar 为yaml config/,Tomcat 为application. yaml WEB-INF/)中设置:classes/ application. yaml yamljodconverter.local.enabled: true # LibreOffice 的安装目录 jodconverter.local.office-home: /usr/lib64/libreoffice安装目录因系统而异,常见的有:
系统 目录 Windows C:/Program Files/LibreOffice Linux /usr/、lib64/ libreoffice /usr/,或从官网安装包安装的lib/ libreoffice /opt/libreoffice<版本> 重启程序。
一台服务器上运行多个 UJCMS 实例时,给每个实例设置不同的 jodconverter.(默认 8100),否则会互相冲突。
三、集群:共用一个转换服务
集群部署时不必每个节点都安装 LibreOffice,可以只运行一个转换服务的容器(jodconverter/),各节点连接它:
yaml
jodconverter.remote.enabled: true
jodconverter.remote.url: http://office:8080Docker 部署对应的环境变量是 UJCMS_ 和 UJCMS_。集群的其它设置见集群部署。
四、转换出来的 PDF 缺字或乱码
原因是服务器上没有文档里用到的字体。
- Docker:镜像内置了开源的中文字体,并把宋体、微软雅黑、黑体、楷体、仿宋等字体名自动替换为它们,一般不会缺字。 需要与原文档完全一致的排版时,把自己持有授权的字体目录挂载到容器的
/usr/下,详见 Docker 部署的“字体”一节。share/ fonts/ - Linux 主机:安装中文字体包,或把持有授权的字体文件复制到
/usr/下的一个子目录,然后执行share/ fonts/ fc-cache -f并重启程序。