跳到主要内容

LibreOffice 格式转换

性能与适用性声明

Word 转 PDF 由 LibreOffice 引擎执行,属于资源密集型操作,其转换性能显著受 CPU、内存、磁盘 IO、文件体积及文档复杂度等因素影响,存在较大波动。

为保障服务稳定性,在独立部署 ldoc 的场景下,建议将转换并发数控制在 CPU 物理核心数以内,并预留一定余量。推荐按 CPU 物理核心数 - 2 估算上限。例如:8 核(8C)服务器,同时开启的转换任务建议不超过 6 个(8 - 2 = 6)。

实际并发上限请结合业务文档样本进行充分的压力测试与容量评估后确定。

一、LibreOffice 部署

具体的安装配置步骤,请参考:如何部署 LibreOffice 服务

二、启用基于 LibreOffice 的 PDF 转换

在微服务应用对应的 yaml 配置文件中设置环境变量 ENV_PDF_CONVERT_TYPE,然后重启服务即可

ENV_PDF_CONVERT_TYPE: "libreoffice"

如果微服务采用集群模式部署,或文件服务为独立部署模式,则需要在微服务配置文件中新增以下环境变量:

ENV_HAP_INTRANET_CROSS_ENDPOINT: "192.168.0.10:8880"

注意: 该环境变量的值为 HAP 微服务的内网访问地址。请确保文件服务器能够通过该地址正常访问微服务,否则将导致 PDF 转换功能调用失败。