项目介绍
BentoPDF 将多种 PDF 操作放在网页工具集中。使用前应确认当前工具是否在浏览器本地处理,以及程序和字体等资源是否仍需联网加载。
页面提供多种 PDF 操作,实际处理由当前工具实现决定。浏览器内处理会消耗访问设备的内存,并不会因为页面放在 NAS 就使用 NAS 算力。
适合日常拆分、合并与页面整理。先用小文件核对结果,再处理大文档和中文资料。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 页面拆分 | 按范围保存所需页 |
| 文档合并 | 调整文件顺序 |
| 页面整理 | 旋转与删除页面 |
| 格式处理 | 按版本选择转换工具 |
| 本地验证 | 检查文件是否上传 |
界面展示

图 1:官方仓库提供的项目示意图,用于说明功能与布局。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Docker |
| 分类 | 知识与效率 |
| 项目仓库 | alam00000/bentopdf |
| 整理日期 | 2026-11-14 |
安装或使用条件
准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。
安装与使用步骤
- 按官方部署说明选择静态托管或容器方式,先在内网提供访问。
- 用无敏感信息的 PDF 检查合并、拆分和导出,分别验证页数、旋转和文字。
- 再测试较大文件和中文字体,观察内存与页面响应,确认适合后再处理正式资料。
首次使用与操作检查
用两份含中文和图片的 PDF 合并后拆分,检查页数、顺序与文字复制。
大文件卡顿先减少批量大小。处理后保留原件,逐页抽查,不只看导出文件是否存在。
Docker Compose
采用当前官方 README 给出的 Simple 镜像,打开 http://NAS_IP:3015。先用非敏感文件测试所需功能;不同发行模式的功能与前端资源配置应分别核对。
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/bentopdf/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/bentopdf
cd /volume1/docker/bentopdf
HALO_PREPARE
cd /volume1/docker/bentopdf
services:
bentopdf:
image: ghcr.io/alam00000/bentopdf-simple:latest
restart: unless-stopped
ports:
- "3015:8080"
在项目目录保存为 compose.yaml 后,先检查配置,再启动:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100
配置与常见问题
- 不能把原文“本地处理”直接推定为每个功能都已通过隐私或离线验证。
- 页面无法打开:先用
docker compose ps检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。 - 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。
更新与备份
保留原始 PDF 和导出文件,不直接覆盖唯一副本。
更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。
参考资料
配图来自 alam00000/bentopdf 官方仓库,按 AGPL 许可 保留来源与许可;图片只做等比例缩小和压缩。