jostmart/libreoffice

jostmart/libreoffice 镜像文档

镜像概述

该镜像基于最新版Ubuntu系统构建，集成了最新版LibreOffice，主要用于以无头（headless）模式运行LibreOffice服务，支持通过UNO API进行远程连接，实现文档转换、自动化办公等功能。

核心功能与特性

• 无头模式运行：支持以无界面方式运行LibreOffice，适合作为后台服务部署
• UNO API支持：通过指定端口开放UNO acceptor，允许外部程序通过UNO API连接并调用LibreOffice功能
• SELinux兼容：提供SELinux环境下的挂载配置选项
• 轻量级配置：包含优化的启动参数，禁用不必要的界面元素和功能（如启动画面、文件恢复等）

使用场景

• 文档格式转换服务（如PDF转Word、文档格式批量处理）
• 自动化办公任务（如报表生成、文档模板填充）
• 需要集成LibreOffice功能的应用程序后端服务
• 服务器环境下的无头文档处理

使用方法

启动容器

在启用SELinux的主机上

bash
docker run -p 127.0.0.1:8997:8997 -v /tmp/convert/:/tmp/convert:z -it -d jostmart/libreoffice:latest

在未启用SELinux的主机上

移除挂载选项中的:z：

bash
docker run -p 127.0.0.1:8997:8997 -v /tmp/convert/:/tmp/convert -it -d jostmart/libreoffice:latest

LibreOffice参数说明

容器中的LibreOffice通过entrypoint.sh启动，以下是核心启动参数说明：

bash
libreoffice --headless 
            --accept="socket,host=0,port=8001,tcpNoDelay=1;urp"
            --nodefault --nofirststartwizard --nolockcheck
            --nologo --norestore --invisible &

主要参数解释

• --headless：以无头模式运行，无图形界面
• --accept：指定UNO连接字符串，用于创建UNO acceptor，允许外部程序通过指定端口（如8001）连接API。格式示例："socket,host=0,port=8001,tcpNoDelay=1;urp"（注意参数需用双引号包裹）
• --nodefault：启动时不创建默认文档
• --nofirststartwizard：禁用首次启动向导
• --nolockcheck：禁用对远程实例使用安装的检查
• --nologo：禁用启动时的 splash 屏幕
• --norestore：禁用系统崩溃后的重启和文件恢复功能（避免因崩溃文件导致无法启动）
• --invisible：以不可见模式运行，适合作为服务在后台运行
• &：使进程在后台运行（Shell多任务处理）

远程连接

通过--accept参数配置的端口（如8001），外部服务可通过UNO API连接到LibreOffice实例，实现文档操作、格式转换等功能。