深耕数码、AI兴趣领域
23
49
手把手教程：通过Docker部署BentoPDF，轻松处理 PDF文档
2026-02-22 23:10:26
1点赞
2收藏
0评论
手把手教程：通过Docker部署BentoPDF，轻松处理 PDF文档
1.1 Reubah简介
1.2 Reubah主要特点
2.1 本地环境规划
2.2 本次实践介绍
3.1 检查Docker服务状态
3.2 检查Docker版本
3.3 检查docker compose 版本
5.1 创建部署目录
5.2 创建Reubah容器
5.3 查看Reubah容器状态
5.4 检查Reubah容器日志
7.1 图片处理
7.2 文档转换
一、Reubah介绍
1.1 Reubah简介
Reubah是一个基于网页的轻量级工具，提供简洁直观的界面，让用户无需安装软件即可在线快速处理图像和转换文档，支持多格式批量操作，并注重隐私与效率。
1.2 Reubah主要特点
支持 JPG、PNG、WebP、GIF 和 BMP 等常见图像格式之间的自由转换。
提供 PDF、DOCX、ODT、RTF 和 TXT 等文档格式之间的高效互转。
内置批处理功能，可一次性上传并转换多个文件，提升工作效率。
采用即时处理机制，文件转换后直接下载，服务器不留存任何数据。
界面简洁直观，操作无需学习成本，适合各类用户快速上手使用。
二、本次实践规划
2.1 本地环境规划
本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。
hostname IP地址 操作系统版本 Docker版本 部署项目 备注 jeven 192.168.3.88 Ubuntu 24.04.2 LTS 28.5.0 Reubah ——
2.2 本次实践介绍
三、本地环境检查
3.1 检查Docker服务状态
检查Docker服务是否正常运行，确保Docker正常运行。
root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-10-04 13:29:05 UTC; 2 days ago
TriggeredBy: ● docker.socket
Docs: https://docs.docker.com
Main PID: 888 (dockerd)
Tasks: 65
Memory: 1.2G (peak: 1.4G)
CPU: 3min 23.296s
CGroup: /system.slice/docker.service
3.2 检查Docker版本
检查Docker版本
root@jeven:~# docker -v
Docker version 28.5.0, build 887030f
3.3 检查docker compose 版本
检查Docker compose版本，确保2.0以上版本。
root@jeven:~# docker compose version
Docker Compose version v2.39.4
四、拉取Reubah镜像
执行以下命令，拉取Reubah文相关镜像。
docker pull ghcr.io/dendianugerah/reubah:latest
在这里插入图片描述
在这里插入图片描述
五、部署Reubah服务
5.1 创建部署目录
部署项目之前，我们需要创建一个部署目录。
mkdir -p /data/reubah/ && cd /data/reubah/
目录授权，如果不设置权限，后面文档转换会报错。
chmod -R 777 /data/reubah/
5.2 创建Reubah容器
docker-cli方式部署，可参考以下命令：
docker run -d
--restart unless-stopped
--name reubah
-p 8085:8085
-v $(pwd)/tmp:/app/tmp
-v $(pwd)/doc-temp:/tmp
-e PORT=8085
ghcr.io/dendianugerah/reubah:latest
本次实践使用docker compose方式部署，新建及编辑docker-compose.yaml文件：
vim docker-compose.yaml
version: '3.8'
services:
reubah:
image: ghcr.io/dendianugerah/reubah:latest
container_name: reubah
restart: always
ports:
- "8085:8085"
volumes:
- /data/reubah/tmp:/app/tmp
- /data/reubah/doc-temp:/tmp
environment:
- PORT=8085
执行以下命令，创建Reubah容器。
docker compose up -d
5.3 查看Reubah容器状态
检查Reubah容器运行状态，确保Reubah容器正常启动。
root@jeven:/data/reubah# docker compose ps
WARN[0000] /data/reubah/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
reubah ghcr.io/dendianugerah/reubah:latest "/app/reubah" reubah 11 minutes ago Up 11 minutes (unhealthy) 8081/tcp, 0.0.0.0:8085->8085/tcp, [::]:8085->8085/tcp
5.4 检查Reubah容器日志
检查容器运行日志，确保Reubah服务正常运行。
docker compose logs
六、访问Reubah服务
浏览器地址：
http://<个人的服务器IP>:8085，访问Reubah初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。
七、Reubah基本使用
7.1 图片处理
上传本地图片，选择需要转换的图片格式，可自行设置输出的图片质量等级、图像大小等。这里选择默认配置，点击确认转化图片。
图片转换完毕后，我们点击下载转换后的图片。
7.2 文档转换
这里将pdf文档转换为word文档，如下所示：
确认转换后，可以看到浏览器成功下载转换后的文档。
八、总结
本次实践成功通过Docker部署了Reubah文件转换器，验证了其在容器化环境下的稳定运行能力。整个部署过程简洁高效，得益于Docker镜像的良好封装性。Reubah的网页界面操作流畅，图像处理与文档转换功能均正常可用，满足日常使用需求。该方案具备良好的可移植性和扩展性，便于后续集成到更多自动化工作流中。
作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～
