快速入门

欢迎使用 BentoPDF！本指南将帮助您快速上手。

什么是 BentoPDF？

BentoPDF 是一款免费、开源、隐私优先的 PDF 工具箱，完全在浏览器中运行。您的文件不会离开您的设备，所有处理都通过 WebAssembly (WASM) 技术在本地完成。

快速开始

方式 1：使用托管版本

访问 bentopdf.com 即可立即使用 BentoPDF，无需安装。

方式 2：使用 Docker 自托管

IMPORTANT

Office 文件转换需要 SharedArrayBuffer，这需要同时满足：

Cross-Origin-Opener-Policy: same-origin
Cross-Origin-Embedder-Policy: require-corp
安全上下文

http://localhost 可用于本地测试，因为浏览器将环回地址视为可信。http://192.168.x.x 等局域网 IP 通常不被视为可信，因此从网络中的其他设备访问时，Word/Excel/PowerPoint 转换需要使用 HTTPS。

bash

# Pull and run the Docker image (self-hosted build)
docker run -d -p 3000:8080 ghcr.io/alam00000/bentopdf-simple:latest

# Or use Docker Compose
curl -O https://raw.githubusercontent.com/alam00000/bentopdf/main/docker-compose.yml
docker compose up -d

TIP

BentoPDF 提供两种构建版本：自托管版本（bentopdf-simple，上文使用的版本）适用于内部/团队/组织部署；商业版本（bentopdf:latest）由 bentopdf.com 自身使用，也供持有商业许可、运行面向公众部署的用户使用。两者的 PDF 工具完全相同，商业版本额外包含 bentopdf.com 的首页横幅、FAQ、用户评价和页脚。如果拿不准，请使用自托管版本。

然后在浏览器中打开 http://localhost:3000。

NOTE

如果您要准备离线隔离（air-gapped）的 OCR 部署，除了 Tesseract worker、核心运行时和 traineddata 文件外，还必须在内部托管 OCR 文本层字体。完整的设置步骤见自托管，其中包括 VITE_OCR_FONT_BASE_URL 和随附的 ocr-fonts/ 目录。

方式 3：从源码构建

bash

# Clone the repository
git clone https://github.com/alam00000/bentopdf.git
cd bentopdf

# Install dependencies
npm install

# Start development server
npm run dev

功能一览

类别	工具
转换为 PDF	Word、Excel、PowerPoint、图片、Markdown、EPUB、MOBI 等
从 PDF 转换	JPG、PNG、文本、Excel、SVG 等
编辑与批注	签名、高亮、涂黑、填写表单、添加印章
整理	合并、拆分、旋转、删除页面、重新排序
优化	压缩、修复、扁平化、OCR
安全	加密、解密、移除限制

浏览器支持

BentoPDF 在现代浏览器上表现最佳：

✅ Chrome/Edge 90+
✅ Firefox 90+
✅ Safari 15+

快速入门 ​

什么是 BentoPDF？ ​

快速开始 ​

方式 1：使用托管版本 ​

方式 2：使用 Docker 自托管 ​

方式 3：从源码构建 ​

功能一览 ​

浏览器支持 ​

下一步 ​