Ubuntu24.04 离线安装 LibreOffice 25.8.7（deb 离线包完整版教程）

适用系统：Ubuntu 24.04 LTS x86_64

用途：SpringBoot 后端无头模式 Word/Excel/PPT 转 PDF，无桌面服务器专用

安装包：LibreOffice_25.8.7_Linux_x86-64_deb.tar.gz

一、前期准备

准备离线安装包 LibreOffice_25.8.7_Linux_x86-64_deb.tar.gz，上传至服务器 /root 目录
服务器具备外网（用于安装依赖库 / 字体，纯离线需提前下载所有依赖 deb）
全程 root 用户操作

二、上传文件并解压安装包

1. 创建存放目录并移动压缩包

bash 复制代码

# 创建目录
mkdir -p /opt/libreoffice
# 复制压缩包（手动输入文件名，不要粘贴避免乱码）
cp /root/LibreOffice_25.8.7_Linux_x86-64_deb.tar.gz /opt/libreoffice/
# 进入目录
cd /opt/libreoffice

2. 解压压缩包

bash 复制代码

tar -zxvf LibreOffice_25.8.7_Linux_x86-64_deb.tar.gz
# 进入解压后的DEBS安装包目录（版本号会略有差异）
cd LibreOffice_25.8.7.3_Linux_x86-64_deb/DEBS

三、批量安装 LibreOffice 主程序 deb 包

bash 复制代码

# 批量安装所有deb安装包
dpkg -i *.deb
# 自动补全缺失依赖
apt --fix-broken install -y

四、创建全局命令软链接（任意目录直接调用 libreoffice）

bash 复制代码

# 建立软链接
ln -s /opt/libreoffice25.8/program/soffice /usr/local/bin/libreoffice
# 验证是否生成成功
ls /usr/local/bin/libreoffice

五、安装无头运行全套依赖库（解决各种 .so 文件缺失报错）

LibreOffice 后台无界面转换必须依赖 X11、打印、渲染库，一次性安装全部依赖：

bash 复制代码

apt update
apt install -y libxinerama1 libx11-6 libxrender1 libxext6 libxtst6 libcairo2 fontconfig libcups2 libx11-xcb1

六、配置中文字体（解决 PDF 中文方框乱码）

Ubuntu24.04 自带文泉驿字体，只需刷新缓存生效：

bash 复制代码

# 刷新系统字体缓存
fc-cache -fv
# 验证字体是否存在
fc-list | grep wqy

七、验证 LibreOffice 是否安装成功

1. 查看版本

bash 复制代码

libreoffice --version

输出 LibreOffice 25.8.7.3 代表程序正常。

2. 无头模式 PDF 转换测试（后端真实调用逻辑）

bash 复制代码

# 生成带中文的测试文档
cat > test.docx <<EOF
SpringBoot调用LibreOffice转换PDF测试
测试中文：张三、李四
文档类型：docx转pdf
EOF

# 执行无界面转换命令
libreoffice --headless --norestore --nofirststartwizard --convert-to pdf test.docx

# 查看是否生成pdf文件
ls test.pdf

目录出现 test.pdf 文件，说明转换功能完全可用。