Docker实战 | 使用Docker部署Reubah文件转换器和图像处理器

【Docker项目实战】使用Docker部署Reubah文件转换器和图像处理器

一、Reubah介绍
- [1.1 Reubah简介](#1.1 Reubah简介)
- [1.2 Reubah主要特点](#1.2 Reubah主要特点)
二、本次实践规划
- [2.1 本地环境规划](#2.1 本地环境规划)
- [2.2 本次实践介绍](#2.2 本次实践介绍)
三、本地环境检查
- [3.1 检查Docker服务状态](#3.1 检查Docker服务状态)
- [3.2 检查Docker版本](#3.2 检查Docker版本)
- [3.3 检查docker compose 版本](#3.3 检查docker compose 版本)
四、拉取Reubah镜像
五、部署Reubah服务
- [5.1 创建部署目录](#5.1 创建部署目录)
- [5.2 创建Reubah容器](#5.2 创建Reubah容器)
- [5.3 查看Reubah容器状态](#5.3 查看Reubah容器状态)
- [5.4 检查Reubah容器日志](#5.4 检查Reubah容器日志)
六、访问Reubah服务
七、Reubah基本使用
- [7.1 图片处理](#7.1 图片处理)
- [7.2 文档转换](#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 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；

2.在Docker环境下部署Reubah文件转换器和图像处理器。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

bash 复制代码

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版本

bash 复制代码

root@jeven:~# docker -v
Docker version 28.5.0, build 887030f

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

bash 复制代码

root@jeven:~# docker compose version
Docker Compose version v2.39.4

四、拉取Reubah镜像

执行以下命令，拉取Reubah文相关镜像。

bash 复制代码

docker   pull    ghcr.io/dendianugerah/reubah:latest

五、部署Reubah服务

5.1 创建部署目录

部署项目之前，我们需要创建一个部署目录。

bash 复制代码

mkdir -p /data/reubah/ && cd /data/reubah/

目录授权，如果不设置权限，后面文档转换会报错。

bash 复制代码

 chmod -R 777 /data/reubah/

5.2 创建Reubah容器

docker-cli方式部署，可参考以下命令：

bash 复制代码

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文件：

bash 复制代码

vim docker-compose.yaml

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容器。

bash 复制代码

docker compose up -d

5.3 查看Reubah容器状态

检查Reubah容器运行状态，确保Reubah容器正常启动。

bash 复制代码

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服务正常运行。

bash 复制代码

docker compose logs

六、访问Reubah服务

浏览器地址： http://<个人的服务器IP>:8085，访问Reubah初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

七、Reubah基本使用

7.1 图片处理

上传本地图片，选择需要转换的图片格式，可自行设置输出的图片质量等级、图像大小等。这里选择默认配置，点击确认转化图片。

图片转换完毕后，我们点击下载转换后的图片。

7.2 文档转换

这里将pdf文档转换为word文档，如下所示：

确认转换后，可以看到浏览器成功下载转换后的文档。

八、总结

本次实践成功通过Docker部署了Reubah文件转换器，验证了其在容器化环境下的稳定运行能力。整个部署过程简洁高效，得益于Docker镜像的良好封装性。Reubah的网页界面操作流畅，图像处理与文档转换功能均正常可用，满足日常使用需求。该方案具备良好的可移植性和扩展性，便于后续集成到更多自动化工作流中。