一、BentoPDF介绍

1.1 BentoPDF

BentoPDF 是一款注重隐私、完全在客户端运行的 PDF 工具包，支持在浏览器中直接编辑、合并和处理 PDF 文件，无需上传至服务器，确保用户数据安全。它可自行托管，完全免费且开源。

1.2 BentoPDF主要特点

• 隐私优先：所有操作均在浏览器内完成，文件从不上传至任何服务器。
• 无使用限制：可无限次处理任意数量的 PDF 文件，无上传或功能限制。
• 高性能：基于现代 Web 技术构建，能快速高效地处理大型 PDF 文档。
• 完全免费：作为开源项目，BentoPDF 对所有人免费开放使用。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署PDF工具箱BentoPDF。

三、本地环境检查

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

四、拉取BentoPDF镜像

下载BentoPDF镜像，镜像名称为： bentopdf/bentopdf:v1.1.5

docker pull bentopdf/bentopdf:v1.1.5

五、部署BentoPDF服务

5.1 docker-cli方式部署（可选）

• 如果使用docker-cli方式部署，可参考以下命令：

docker run -d \
  --name bentopdf \
  --restart always  \
  -p 8560:8080 \
  bentopdf/bentopdf:v1.1.5

5.2 docker compose方式部署

• 创建部署目录

mkdir -p /data/bentopdf  && cd /data/bentopdf

新建及编辑docker-compose.yaml文件，宿主机映射端口可自行设置，注意防止端口冲突。

vim docker-compose.yaml

services:
  bentopdf:
    image: bentopdf/bentopdf:v1.1.5
    container_name: bentopdf
    restart: always 
    ports:
      - '8560:8080'

5.3 创建BentoPDF容器

执行以下命令，创建BentoPDF容器。

docker compose up -d

5.4 查看BentoPDF容器状态

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

root@jeven:/data/bentopdf# docker compose ps
NAME       IMAGE                      COMMAND                  SERVICE    CREATED         STATUS         PORTS
bentopdf   bentopdf/bentopdf:v1.1.5   "/docker-entrypoint.…"   bentopdf   4 seconds ago   Up 3 seconds   0.0.0.0:8560->8080/tcp, [::]:8560->8080/tcp

5.5 检查BentoPDF容器日志

检查容器运行日志，确保BentoPDF服务正常运行。

docker compose logs

六、访问BentoPDF服务

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

BentoPDF 功能概览

七、总结

本次Docker项目实战成功地将BentoPDF工具箱部署到了本地环境，实现了在线PDF处理服务的快速搭建。通过Docker容器化技术，我们确保了应用环境的隔离性和一致性，简化了复杂的部署流程。实践验证了使用docker-compose进行多服务管理的便捷与高效。BentoPDF的成功部署为后续集成更多Web应用提供了可复用的模板和宝贵经验。