制作Unoconv项目的Docker镜像

制作Unoconv项目的Docker镜像

1 介绍

1.1 Unoconv

在Linux下将Office转换为pdf的很多包仅支持Windows，Unoconv是一个用LibreOffice转化文档的项目，已经归档（2025-3-31）。迁移后的新版本是unoserver，unoserver不太好用，我没安装成功，推荐使用Unoconv。

参考地址

# 归档版本
https://github.com/unoconv/unoconv

# 新版本
https://github.com/unoconv/unoserver

1.2 LinuxServer.io

LinuxServer.io是一个借助docker将开源项目封装为镜像的组织团队。他们封装了很多有用的镜像。本文借助linuxserver封装的LibreOffice进行二次封装镜像。

参考地址

# linuxserver官网地址
https://www.linuxserver.io/

# Github地址
https://github.com/linuxserver/

1.3 LibreOffice

LibreOffice是一个功能强大的免费、开源的办公软件套件。由于LibreOffice官网没有见到封装docker镜像。所以本文使用LinuxServer.io封装的LibreOffice。

参考地址

# LibreOffice官网
https://www.libreoffice.org/

# Github上linuxserver封装的LibreOffice地址
https://github.com/linuxserver/docker-libreoffice

1.4 KasmVNC

KasmVNC是一款开源的、基于Web 的 VNC 服务器，用户可以直接通过浏览器访问远程桌面，无需安装任何客户端。 lscr.io/linuxserver/libreoffice:7.6.7使用这个开源项目借助浏览器访问LibreOffice系统。

参考地址

# 官网
https://www.kasmweb.com/kasmvnc

# Github上linuxserver封装的KasmVNC地址
https://github.com/linuxserver/docker-baseimage-kasmvnc

2 构建Unoconv镜像

2.1 下载linuxserver/libreoffice镜像

下载镜像

# lscr.io/linuxserver/libreoffice和linuxserver/libreoffice是同一个镜像

# 下载linuxserver/libreoffice
docker pull linuxserver/libreoffice:7.6.7

# 下载lscr.io/linuxserver/libreoffice
docker pull lscr.io/linuxserver/libreoffice:7.6.7

创建容器

docker run -itd --name pyunoconv linuxserver/libreoffice:7.6.7

在宿主机内将data.docx复制到unoserver容器中，用于文档转换测试。

docker cp data.docx pyunoconv:/home/

2.2 封装pyunoconv容器

（1）进入容器

# 进入容器
docker exec -it pyunoconv /bin/bash

（2）创建虚拟环境

⚠️ 注意：在linuxserver/libreoffice中自带Python，它是为linuxserver/libreoffice系统提供可视化支撑的（系统的Python环境），所以不能作为用户研发环境。如果使用系统的Python会出现下面错误。

error: externally-managed-environment

× This environment is externally managed

Python虚拟环境

# 进入容器中的home目录
cd /home

# 在home中创建虚拟环境
python -m venv pyunoconv

# 激活虚拟环境
source ./pyunoconv/bin/activate

Python安装unoserver依赖

pip install --upgrade setuptools wheel
pip install unoconv

⚠️下面的报错需要执行 pip install --upgrade setuptools wheel

ERROR: Could not find a version that satisfies the requirement distutils (from versions: none)
ERROR: No matching distribution found for distutils

（3）测试unoserver

使用python时可使用subprocess包通过命令行的形式调用即可。

# 在将测试的office转化为pdf
unoconv -f pdf data.docx

执行结果

2.3 解决中文乱码

没安装中文字体会出现转换时都是空，无法转中文。解决方法将Windows下的C:\Windows\Fonts的字体全部打包为”Fonts.zip“，复制到容器中的/usr/share/fonts/。

在宿主机中将"Fonts.zip"复制到容器中。

docker cp Fonts.zip pyunoconv:/home/

在pyunoconv容器中解压和移动字体

# 进入容器
docker exec -it pyunoconv /bin/bash

# 进入目录
cd /home

# 进入容器解压字体包
unzip Fonts

# 将字体移动到字体目录下
mv Fonts/* /usr/share/fonts/

3 Web访问LibreOffice

基于Docker使用linuxserver/libreoffice:7.6.7镜像实现在线预览LibreOffice。由于linuxserver/libreoffice内置了KasmVNC，所以可以使用浏览器使用LibreOffice。

使用Docker创建镜像

docker run -d \
  --name=libreoffice \
  --security-opt seccomp=unconfined `#optional` \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 3000:3000 \
  -p 3001:3001 \
  -v /path/to/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/libreoffice:7.6.7

访问地址

端口3000是http的访问地址，端口3001是https是https的访问地址。

http://192.168.108.146:3000/