PDF 转换不想上传?BentoPDF 私有化部署完整教程
莱卡云
2026年01月28日 14:55

只要你在工作中经常处理 PDF 文件,一定遇到过这些情况:

📄 合同、报告、扫描件需要转换 😵 在线 PDF 网站要先上传文件 🧠 文件内容比较敏感,不太放心 💻 转个格式、合并一下,却要开会员 🔁 用完一次,下次又得重新找工具

说实话,我也是在 PDF 用得越来越频繁之后,才意识到一个问题:

👉 PDF 处理这件事,最重要的不是功能,而是“文件在不在自己手里”。

后来我开始使用 BentoPDF 这种本地处理、不依赖外部服务的开源 PDF 工具箱,并把它部署在服务器上,作为一个长期稳定的 PDF 处理节点,体验才真正安心下来。

这篇文章我就从真实使用场景 + 实际搭建过程出发,教你用 莱卡云服务器,搭建一套安全、可控、适合长期使用的 PDF 工具箱 BentoPDF。

一、BentoPDF 是什么?它和在线 PDF 有什么不同?

一句话说明白:

👉 BentoPDF 是一款所有处理都在本地完成的开源 PDF 工具箱,不依赖第三方在线服务。

它的核心特点非常清晰:

  • 📄 PDF 本地处理,不上传文件

  • 🔒 数据完全可控

  • 🧰 常用 PDF 功能集中

  • 🪶 部署轻量,使用简单

  • 🆓 开源免费,可长期使用

你可以把 BentoPDF 理解成:

“一个放在自己服务器里的 PDF 瑞士军刀”。

二、BentoPDF 能做哪些事?

在日常办公中,它已经能覆盖绝大多数需求:

  • 合并多个 PDF

  • 拆分 PDF

  • PDF 转图片

  • 图片转 PDF

  • 页面排序、裁剪

  • 基础压缩处理

对我来说,它最大的价值不是“功能多”,而是:

👉 每一次处理,都不用担心文件外泄。

三、为什么要把 BentoPDF 部署在服务器上?

你可能会想:

👉 既然是“本地处理”,直接装电脑上不就好了?

但服务器方案在真实使用中有几个明显优势:

  • 🌍 浏览器即可使用

  • 🔁 多台设备共用

  • 🧱 换电脑无需重新配置

  • 🔒 文件处理环境统一

  • 🧠 不和个人电脑环境冲突

我自己的做法是:

👉 服务器只负责“处理文件”,电脑只负责“上传和下载结果”。

四、整体方案架构(先看懂)

这是一套非常干净、也非常安全的结构:

代码块
PlainText
自动换行
复制代码
复制成功
代码块
PlainText
自动换行
复制代码

浏览器
        ↓
BentoPDF Web 界面
        ↓
莱卡云服务器
        ↓
本地 PDF 处理引擎

复制成功

👉 文件不上第三方云 👉 处理全在你控制的环境中

五、服务器配置建议

BentoPDF 对服务器要求并不高:

  • CPU:1~2 核

  • 内存:1GB~2GB

  • 硬盘:10GB 起(临时文件)

  • 系统:Debian 12 / Ubuntu 22.04

一台 莱卡云服务器,就可以作为长期稳定的 PDF 处理工具箱。

六、服务器准备运行环境

6.1 更新系统

代码块
PlainText
自动换行
复制代码
复制成功
代码块
PlainText
自动换行
复制代码

apt update && apt upgrade -y
 
复制成功

6.2 安装基础依赖

代码块
PlainText
自动换行
复制代码
复制成功
代码块
PlainText
自动换行
复制代码

apt install -y curl git
 
复制成功

6.3 安装 Docker(推荐方式)

代码块
PlainText
自动换行
复制代码
复制成功
代码块
PlainText
自动换行
复制代码

curl -fsSL https://get.docker.com | bash
systemctl enable --now docker
 
复制成功

七、使用 Docker 部署 BentoPDF

7.1 创建目录

代码块
PlainText
自动换行
复制代码
复制成功
代码块
PlainText
自动换行
复制代码

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

复制成功

data 用于存放临时处理文件。

7.2 编写 docker-compose.yml

以下为通用、可直接使用的部署示例,镜像名以项目实际为准。

代码块
PlainText
自动换行
复制代码
复制成功
代码块
PlainText
自动换行
复制代码

services:
  bentopdf:
    image: bentopdf/bentopdf:latest
    container_name: bentopdf
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai
    ports:
      - "127.0.0.1:10190:8080"
    volumes:
      - ./data:/app/data

复制成功

启动服务:

代码块
PlainText
自动换行
复制代码
复制成功
代码块
PlainText
自动换行
复制代码

docker compose up -d
docker logs -f bentopdf

复制成功

测试:

代码块
PlainText
自动换行
复制代码
复制成功
代码块
PlainText
自动换行
复制代码

curl -I http://127.0.0.1:10190
 
复制成功

八、Nginx 反向代理(推荐)

代码块
PlainText
自动换行
复制代码
复制成功
代码块
PlainText
自动换行
复制代码

apt install -y nginx

复制成功
代码块
PlainText
自动换行
复制代码

cat > /etc/nginx/sites-available/bentopdf.conf <<'EOF'
server {
    listen 80;
    server_name pdf.example.com;

    location / {
        proxy_pass http://127.0.0.1:10190;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
EOF

复制成功
代码块
PlainText
自动换行
复制代码

ln -sf /etc/nginx/sites-available/bentopdf.conf /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx

复制成功

现在你就拥有了一个完全私有的 PDF 处理入口。

九、BentoPDF 的真实使用方式(非常关键)

这是我自己长期使用下来,最安心的一套用法:

1️⃣ 只用于内部或个人 PDF 2️⃣ 处理完成后立刻下载 3️⃣ 定期清理临时文件 4️⃣ 不长期存放原始文档 5️⃣ 把它当“工具台”,不是云盘

十、真实使用体验总结

这是我使用 BentoPDF 一段时间后的明显感受:

🟢 再也不用上传 PDF 到陌生网站 🟢 文件处理过程非常安心 🟢 功能够用,不花哨 🟢 多设备使用体验一致 🟢 长期使用没有心理负担

它解决的不是“不会处理 PDF”,而是:

  • 不想为处理 PDF 付出隐私成本

十一、使用与安全建议(很重要)

几点来自真实使用的建议:

1️⃣ 不对公网完全开放 2️⃣ 定期清理 data 目录 3️⃣ 大文件注意内存占用 4️⃣ 敏感文件处理完立即删除 5️⃣ 本地处理 ≠ 无限存储

十二、为什么我推荐「BentoPDF + 莱卡云服务器」

一句话总结:

👉 PDF 处理这件事,越本地,越安心。

  • BentoPDF 保证文件不外流

  • 莱卡云服务器提供稳定环境

  • 不依赖第三方平台

  • 适合长期、反复使用

BentoPDF 是工具箱, 莱卡云服务器是工作台, 你只需要专注内容本身。