ppizzo/libreoffice

LibreOffice 镜像文档

镜像概述和主要用途

本Docker镜像包含LibreOffice办公套件，主要利用其无头（headless）模式实现文档格式转换功能。通过该镜像，用户可以在隔离的容器环境中便捷地将文档从一种格式转换为另一种格式（如docx转pdf、odt转doc等）。

核心功能和特性

• 基于LibreOffice构建，支持多种文档格式转换
• 无头模式运行，无需图形界面，适合服务器环境和自动化任务
• 可通过挂载本地目录实现文件输入输出，操作简单
• 轻量级容器化部署，环境隔离，避免依赖冲突

使用场景和适用范围

• 文档格式批量转换任务（如批量将Office文档转为PDF）
• 服务器端文档处理自动化流程
• 需要在隔离环境中进行文档格式转换的应用场景
• 开发环境中的文档格式处理测试

构建方法

使用预构建镜像

可直接从Docker Hub拉取预构建镜像：

https://hub.docker.com/r/ppizzo/libreoffice

自行构建镜像

若需本地构建，执行以下命令：

bash
docker build -t ppizzo/libreoffice .

使用方法

基本使用说明

镜像的工作目录为/doc，使用时需将包含待处理文件的本地目录挂载到容器内的/doc目录，然后执行libreoffice命令进行格式转换。

格式转换示例

以将.docx文件转换为.pdf格式为例：

1. 执行转换命令：

bash
docker run -ti -v $(pwd):/doc \
            ppizzo/libreoffice \
            libreoffice --headless --convert-to pdf \
            FILE.docx

• -v $(pwd):/doc：将当前目录挂载到容器内的/doc目录
• --headless：启用无头模式（无图形界面）
• --convert-to pdf：指定转换目标格式为PDF
• FILE.docx：待转换的源文件名称

2. 修改输出文件所有者： 由于LibreOffice无法处理/etc/passwd中未列出的UID，转换后的文件所有者可能为root，需执行以下命令修改所有者：

bash
docker run -ti -v $(pwd):/doc \
            ppizzo/libreoffice \
            chown `id -u`:`id -g` FILE.pdf

• id -u和id -g分别获取当前用户的UID和GID，确保文件所有者与宿主机用户一致

支持的转换格式

LibreOffice支持的常见格式转换包括但不限于：

• docx → pdf
• odt → docx
• xlsx → csv
• pptx → pdf
• txt → docx

可通过libreoffice --headless --convert-to help命令查看所有支持的转换格式。