Ubuntu 18.04 安装 LibreOffice(用于 Word 在线预览转换)

Ubuntu 18.04 安装 LibreOffice(用于 Word 在线预览转换)

适用场景: 服务器端需要将 .doc / .docx 转换为 HTML 或 PDF

操作用户: root 或具有 sudo 权限的用户


一、安装命令(稳定版)

⚠️ 避免踩坑: 不要安装 libreoffice-writer-nogui,容易与系统源冲突导致依赖问题。

执行以下命令:

bash 复制代码
sudo apt-get update
sudo apt-get install -y --no-install-recommends \
  libreoffice-writer \
  libreoffice-common \
  libreoffice-java-common \
  fonts-noto-cjk

参数说明:

包名 作用
libreoffice-writer Writer 文字处理组件(核心)
libreoffice-common 公共基础文件
libreoffice-java-common Java 运行时支持(部分转换依赖)
fonts-noto-cjk 中日韩字体,避免中文乱码

二、验证安装是否成功

2.1 查看 soffice 路径

bash 复制代码
which soffice

预期输出:/usr/bin/soffice

2.2 查看版本号

bash 复制代码
soffice --version

预期输出类似:

text 复制代码
LibreOffice 6.0.7.3 00m0(Build:3)

三、(可选)指定自定义路径

如果 soffice 不在默认路径,可在 .env 中配置(以 Laravel 为例):

bash 复制代码
CONTRACT_LIBREOFFICE_PATH=/usr/bin/soffice

四、测试转换功能(推荐执行)

用一个测试文件验证是否能正常转换:

bash 复制代码
# 准备测试文件
echo "test content" > /tmp/test.doc

# 执行转换
soffice --headless --nologo --nofirststartwizard --norestore \
  --convert-to html --outdir /tmp /tmp/test.doc

# 查看输出
ls -la /tmp/test.html

如果生成了 /tmp/test.html 文件,说明安装成功且可用。


五、常见问题速查

问题 解决方法
soffice: command not found 检查是否安装成功,或使用 find /usr -name soffice 查找路径
中文转 HTML 出现方块/乱码 确保已安装 fonts-noto-cjk,或补充安装 fonts-wqy-zenhei
转换无报错但无输出文件 检查 --outdir 目录是否可写
例子:PHP 调用 soffice 失败(程序已装好,但接口仍报错) 检查 PHP 配置文件 php.ini 中的 disable_functions 是否禁用了 exec 或 shell_exec。查看命令: `php -i

六、安装完成

执行完以上步骤,LibreOffice 即可供 PHP/Python/Java 等后端程序通过 exec / shell_exec 调用,用于 Word 文档的无界面转换。


原创整理,转载注明出处。

相关推荐
文丑颜不良啊4 小时前
LeetCode2981~3000题目解析
java·leetcode
黑客笔记4 小时前
python小工具win7翻车事故现场
python
nice_lcj5205 小时前
【从零理解 Spring AI · 13】RAG 要解决什么:把“闭卷考试“变成“开卷“
java·spring·检索增强·rag·spring ai·ai应用开发
pps-key5 小时前
网络攻防入门:从“黑客梦”到合法实操(生存篇)
开发语言·web安全·php
多弗朗皮卡丘6 小时前
网络基础:数据链路层与其他协议或技术
linux·网络·tcp/ip
学长毕设6 小时前
基于SpringBoot军事纪念馆管理系统设计与实现-附源码
java·spring boot·后端
岁月宁静6 小时前
从零拆解 AI 语音模拟面试系统
人工智能·python·agent
benchmark_cc6 小时前
个人开发者接入五档盘口:用 QuantDash 读取单只股票的验收清单与易错点
python·数据分析·pandas·量化交易·股票数据·quantdash
这个昵称不容易7 小时前
SpringBoot 医疗病历交互系统的设计与实现:192 个 Java 文件、256 个接口、22 张表,附真实运行截图
java·springboot·毕设
ZhengEnCi8 小时前
项目越写越乱?先别改架构:用一次目录重排 + 一份可复算的体检脚本把乱治住
python·架构·ai编程