快速入門

歡迎使用 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
• 安全環境（secure context）

http://localhost 可用於本機測試，因為瀏覽器將迴路位址視為可信任。http://192.168.x.x 或其他區域網路 IP 通常不行，因此從網路中的其他裝置存取時，Word/Excel/PowerPoint 轉換需要 HTTPS。

# 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 的主視覺、常見問題、使用者推薦與頁尾。如果不確定，請使用自行架設版。

接著在瀏覽器中開啟 http://localhost:3000。

NOTE

如果您正在準備離線隔離（air-gapped）的 OCR 部署，除了 Tesseract worker、核心執行環境與 traineddata 檔案外，還必須在內部架設 OCR 文字層字型。完整設定請參閱自行架設，包括 VITE_OCR_FONT_BASE_URL 與內建的 ocr-fonts/ 目錄。

選項 3：從原始碼建置

# 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
• 參與專案貢獻