跳到主要内容

LibreOffice 格式转换

性能与适用性声明

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

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

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

一、LibreOffice 部署​

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

二、启用基于 LibreOffice 的 PDF 转换​

在 app 服务的 environment 下添加以下配置，然后重启服务：

app:
  environment:
    ENV_PDF_CONVERT_TYPE: "libreoffice" # 新增：启用 LibreOffice PDF 转换
ENV_HAP_INTRANET_CROSS_ENDPOINT 变量配置位置

ENV_HAP_INTRANET_CROSS_ENDPOINT 用于让文件服务访问 HAP 微服务，仅在以下场景配置：

ENV_HAP_INTRANET_CROSS_ENDPOINT: "192.168.0.10:8880"

单机 Docker Compose（文件服务独立部署）时，添加到 /data/mingdao/script/docker-compose.yaml 的 app.environment 下：

集群 Kubernetes 时，添加到 /data/mingdao/script/kubernetes/config.yaml 中 env-list ConfigMap 的 data 下。

请将 192.168.0.10:8880 替换为文件服务可访问的 HAP 微服务内网地址。

点击查看单机 Docker Compose 完整修改示例
version: '3'

services:
  app:
    image: registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-hap:7.5.3
    environment: &app-environment
      ENV_ADDRESS_MAIN: "https://hap.domain.com"
      ENV_APP_VERSION: "7.5.3"
      ENV_API_TOKEN: "******"
      ENV_PDF_CONVERT_TYPE: "libreoffice" # 新增：启用 LibreOffice PDF 转换
    ports:
      - 8880:8880
    volumes:
      - ./volume/data/:/data/
      - ../data:/data/mingdao/data

  sc:
    image: registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-sc:3.2.0
    environment:
      <<: *app-environment
    volumes:
      - ./volume/data/:/data/

  command:
    image: registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-command:node1018-python36

  doc:
    image: registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-doc:2.0.0