如何优化 Word、PDF 文档预览效果

明道云默认提供的文档在线预览服务是基于 OnlyOffice 实现（mingdaoyun-doc），由于涉及字体版权问题，部分字体会出现无法渲染或乱码的情况。但由于没有比较理想的免费替代产品，所以提供了基于 LibreOffice 的镜像（mingdaoyun-ldoc）来针对 Word、PDF 预览效果进行优化，最终 Excel 预览效果依然基于 OnlyOffice，Word、PDF 则基于 LibreOffice。

1. 拉取镜像

   在线：

   docker pull registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-ldoc:1.0.0
   

   离线：

   https://pdpublic.mingdao.com/private-deployment/offline/mingdaoyun-ldoc-linux-amd64-1.0.0.tar.gz
   
   #下载到服务器后执行：
   docker load -i mingdaoyun-ldoc-linux-amd64-1.0.0.tar.gz
   

2. 安装 Docker Compose（以 CentOS 为例）

   yum install -y docker-compose
   

3. 任意目录下创建 docker-compose.yaml 文件，内容如下：

   version: '3'
   
   services:
     ldoc:
       image: registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-ldoc:1.0.0
       ports:
         - 8881:8000
       environment:
         ENV_FILE_INNER_URI: "微服务应用的内网地址，如：172.27.0.13:8880"
         ENV_DOCPREVIRE_SUBPATH: "/ldocpreview"
   

4. 启动 ldoc 文档预览服务，docker-compose.yaml 所在目录下执行

   docker-compose up -d
   

5. 微服务对应的 docker-compose.yaml（如：/data/mingdao/script/docker-compose.yaml）增加环境变量

   ENV_DOCPREVIRE_EXT_ENDPOINTS: "ldoc 服务的内网地址，如：172.27.0.13:8881"
   

6. 重启明道云微服务