1. 为什么选择Docker部署OpenOffice？

传统OpenOffice安装方式需要手动下载安装包、配置依赖项，整个过程繁琐且容易出错。我在实际项目中遇到过多次因系统环境差异导致的安装失败问题，比如缺少特定字体库、JDK版本冲突等。而Docker容器化部署就像把整个OpenOffice运行环境打包成一个"便携式行李箱"，无论搬到哪台服务器都能即开即用。

举个例子，团队新来的同事需要在测试环境部署OpenOffice服务。传统方式下他可能需要折腾半天解决各种依赖问题，而用Docker只需要执行两行命令：

docker pull 954l/openoffice:4.1.13
docker run -d -p 8100:8100 --name openoffice 954l/openoffice:4.1.13

容器化方案的核心优势：

• 环境一致性：开发、测试、生产环境使用完全相同的镜像
• 资源隔离：不会与宿主机其他服务产生端口或依赖冲突
• 快速扩容：需要增加处理节点时，秒级启动新容器
• 版本管理：通过tag区分不同版本，回滚只需切换镜像版本

2. 两种Docker部署方案详解

2.1 直接使用现成镜像

对于想快速上手的开发者，推荐直接使用Docker Hub上的预构建镜像。这里以我维护的954l/openoffice:4.1.13为例：

# 创建数据持久化目录
mkdir -p /data/openoffice/files

# 启动容器（不暴露端口，仅供内部访问）
docker run -d \
  --name openoffice \
  -v /data/openoffice/files:/data/files \
  954l/openoffice:4.1.13

注意：如果需要在宿主机访问OpenOffice服务，需添加-p 8100:8100参数。但在微服务架构中，更推荐通过容器网络互联。

2.2 自定义构建镜像

当需要特定版本或自定义配置时，可以自行构建Docker镜像。以下是完整构建流程：

1. 准备构建环境：

mkdir -p /data/openoffice/build
cd /data/openoffice/build

2. 下载安装包：

• OpenOffice 4.1.13中文版：

  wget https://udomain.dl.sourceforge.net/project/openofficeorg.mirror/4.1.13/binaries/zh-CN/Apache_OpenOffice_4.1.13_Linux_x86-64_install-rpm_zh-CN.tar.gz
  

• JDK 8安装包（需提前下载）

3. 准备字体文件：

mkdir fonts
# 将Windows下的simsun.ttf等中文字体拷贝到此目录

4. 编写Dockerfile：

FROM centos:7

# 安装JDK
COPY jdk-8u341-linux-x64.rpm /tmp/
RUN yum install -y /tmp/jdk-8u341-linux-x64.rpm && \
    rm -f /tmp/jdk-8u341-linux-x64.rpm

# 安装OpenOffice
ADD Apache_OpenOffice_4.1.13_Linux_x86-64_install-rpm_zh-CN.tar.gz /tmp/
RUN cd /tmp && yum install -y zh-CN/RPMS/*.rpm && \
    yum clean all && \
    rm -rf /tmp/zh-CN

# 配置中文字体
COPY fonts /usr/share/fonts/
RUN yum install -y mkfontscale fontconfig && \
    yum groupinstall -y "X Window System" && \
    cd /usr/share/fonts && \
    chmod 755 * && \
    mkfontscale && mkfontdir && fc-cache -fv

# 设置时区
RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
    echo "Asia/Shanghai" > /etc/timezone

EXPOSE 8100
CMD ["/opt/openoffice4/program/soffice", "-headless", "-nofirststartwizard", "-accept=socket,host=0.0.0.0,port=8100;urp;"]

5. 构建并推送镜像：

docker build -t yourname/openoffice:4.1.13 .
docker push yourname/openoffice:4.1.13

3. Spring Boot集成实战

3.1 基础环境配置

首先在pom.xml中添加JODConverter依赖：

<dependency>
    <groupId>org.jodconverter</groupId>
    <artifactId>jodconverter-spring-boot-starter</artifactId>
    <version>4.4.4</version>
</dependency>

application.yml配置示例：

jodconverter:
  local:
    enabled: true
    host-name: openoffice  # 容器名称
    port-numbers: 8100
    working-dir: /data/files
    max-tasks-per-process: 20
    process-timeout: 120000

踩坑提示：如果OpenOffice容器与Spring Boot容器分开部署，host-name需改为IP地址，并确保防火墙开放8100端口。

3.2 文档转换服务实现

实现一个Word转PDF的REST接口：

@RestController
@RequestMapping("/api/docs")
public class DocumentController {
    
    private final DocumentConverter converter;
    
    public DocumentController(DocumentConverter converter) {
        this.converter = converter;
    }
    
    @PostMapping("/word-to-pdf")
    public ResponseEntity<Resource> convertToPdf(@RequestParam MultipartFile file) 
        throws IOException {
        
        String originalName = file.getOriginalFilename();
        String pdfName = FilenameUtils.removeExtension(originalName) + ".pdf";
        Path outputPath = Paths.get("/data/files", pdfName);
        
        try (InputStream input = file.getInputStream()) {
            converter.convert(input)
                   .to(outputPath.toFile())
                   .execute();
        }
        
        FileSystemResource resource = new FileSystemResource(outputPath);
        return ResponseEntity.ok()
               .header(HttpHeaders.CONTENT_DISPOSITION, 
                      "attachment; filename=\"" + pdfName + "\"")
               .body(resource);
    }
}

3.3 高级功能扩展

批量转换处理：

@Async
public void batchConvert(List<MultipartFile> files) {
    files.parallelStream().forEach(file -> {
        try {
            String name = file.getOriginalFilename();
            Path output = Paths.get("/data/files/output", 
                FilenameUtils.removeExtension(name) + ".pdf");
            
            converter.convert(file.getInputStream())
                   .to(output.toFile())
                   .execute();
        } catch (Exception e) {
            log.error("转换失败: {}", file.getOriginalFilename(), e);
        }
    });
}

转换结果缓存：

@Cacheable(value = "documents", key = "#file.originalFilename")
public byte[] convertWithCache(MultipartFile file) throws IOException {
    ByteArrayOutputStream output = new ByteArrayOutputStream();
    converter.convert(file.getInputStream())
           .to(output)
           .execute();
    return output.toByteArray();
}

4. 生产环境优化建议

4.1 性能调优方案

通过实测发现，默认配置下单个OpenOffice实例同时处理3个以上文档时性能明显下降。推荐以下优化措施：

1. 容器资源限制：

docker run -d \
  --name openoffice \
  --memory 2g \
  --cpus 1.5 \
  -e OOO_DISABLE_RECOVERY=1 \
  954l/openoffice:4.1.13

2. 连接池配置：

jodconverter:
  local:
    pool-size: 5  # 根据容器数量调整

3. 横向扩展架构：

                          [Nginx]
                             |
        -------------------------------------
        |                   |               |
[Spring Boot]        [OpenOffice集群]    [Redis]
        |                   |
        ---------------------
                   |
              [共享存储NAS]

4.2 监控与运维

健康检查配置：

docker run -d \
  --health-cmd="netstat -an | grep 8100 || exit 1" \
  --health-interval=30s \
  --health-retries=3 \
  954l/openoffice:4.1.13

Prometheus监控指标：

@Bean
public JodConverterMetrics metrics() {
    return new JodConverterMetrics()
        .bindTo(Metrics.globalRegistry);
}

日志收集建议使用ELK栈，重点关注：

• 文档转换耗时
• 失败转换任务堆栈跟踪
• 内存占用变化趋势

4.3 安全防护措施

1. 网络隔离：

docker network create office-net
docker run -d --net office-net --name openoffice 954l/openoffice:4.1.13

2. 访问控制：

@PreAuthorize("hasRole('DOC_CONVERT')")
@PostMapping("/convert")
public ResponseEntity<?> secureConvert(@RequestParam MultipartFile file) {
    // 转换逻辑
}

3. 文件安全检查：

private void validateFile(MultipartFile file) {
    String contentType = file.getContentType();
    if (!Arrays.asList(
        "application/msword",
        "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
    ).contains(contentType)) {
        throw new IllegalArgumentException("不支持的文件类型");
    }
    
    if (file.getSize() > 10 * 1024 * 1024) {
        throw new IllegalArgumentException("文件大小超过10MB限制");
    }
}

在实际项目中，我们通过这套方案每天稳定处理3000+文档转换请求，平均耗时在5秒以内。最关键的是Docker部署方式让我们在服务器迁移时节省了90%的配置时间。对于需要处理复杂格式的场景，建议配合字体优化和模板预处理，可以进一步提升转换质量。