mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 11:52:48 +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`
|
||
> - 安全上下文
|
||
>
|
||
> `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 文本层字体。完整的设置步骤见[自托管](/zh/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/tools/)
|
||
- [自托管 BentoPDF](/zh/self-hosting/)
|
||
- [参与项目贡献](/zh/contributing)
|