mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 20:02:47 +01:00
81 lines
3.2 KiB
Markdown
81 lines
3.2 KiB
Markdown
# 快速入門
|
||
|
||
歡迎使用 BentoPDF！本指南將協助您快速上手。
|
||
|
||
## 什麼是 BentoPDF？
|
||
|
||
BentoPDF 是一套免費、開源、以隱私為優先的 PDF 工具箱，**完全在您的瀏覽器中**執行。您的檔案絕不會離開您的裝置，所有處理都透過 WebAssembly（WASM）技術在本機完成。
|
||
|
||
## 快速開始
|
||
|
||
### 選項 1：使用線上版
|
||
|
||
前往 [bentopdf.com](https://www.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。
|
||
|
||
```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 的主視覺、常見問題、使用者推薦與頁尾。如果不確定，請使用自行架設版。
|
||
|
||
接著在瀏覽器中開啟 `http://localhost:3000`。
|
||
|
||
> [!NOTE]
|
||
> 如果您正在準備離線隔離（air-gapped）的 OCR 部署，除了 Tesseract worker、核心執行環境與 traineddata 檔案外，還必須在內部架設 OCR 文字層字型。完整設定請參閱[自行架設](/zh-TW/self-hosting/)，包括 `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+
|
||
|
||
## 後續步驟
|
||
|
||
- [探索所有工具](/zh-TW/tools/)
|
||
- [自行架設 BentoPDF](/zh-TW/self-hosting/)
|
||
- [參與專案貢獻](/zh-TW/contributing)
|