mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 20:02:47 +01:00
123 lines
3.5 KiB
Markdown
123 lines
3.5 KiB
Markdown
# 部署到 Vercel
|
||
|
||
[Vercel](https://vercel.com) 为静态站点提供最简单的部署体验。
|
||
|
||
## 一键部署
|
||
|
||
[](https://vercel.com/new/clone?repository-url=https://github.com/alam00000/bentopdf)
|
||
|
||
## 手动部署
|
||
|
||
### 步骤 1：Fork 仓库
|
||
|
||
将 [bentopdf/bentopdf](https://github.com/alam00000/bentopdf) Fork 到您的 GitHub 账户。
|
||
|
||
### 步骤 2：导入到 Vercel
|
||
|
||
1. 前往 [vercel.com/new](https://vercel.com/new)
|
||
2. 选择您 Fork 的仓库
|
||
3. 配置项目：
|
||
|
||
| 设置 | 值 |
|
||
| ---------------- | --------------- |
|
||
| Framework Preset | Vite |
|
||
| Build Command | `npm run build` |
|
||
| Output Directory | `dist` |
|
||
| Install Command | `npm install` |
|
||
|
||
### 步骤 3：环境变量（可选）
|
||
|
||
如有需要，添加以下变量：
|
||
|
||
| 变量 | 说明 |
|
||
| ----------------------- | -------------------------------------------------------- |
|
||
| `SIMPLE_MODE` | 设为 `true` 以使用精简界面 |
|
||
| `VITE_BRAND_NAME` | 自定义品牌名称（替换 "BentoPDF"） |
|
||
| `VITE_BRAND_LOGO` | 相对于 `public/` 的标志路径（例如 `images/my-logo.svg`） |
|
||
| `VITE_FOOTER_TEXT` | 自定义页脚/版权文字 |
|
||
| `VITE_DEFAULT_LANGUAGE` | 默认界面语言（例如 `fr`、`de`、`es`） |
|
||
|
||
### 步骤 4：部署
|
||
|
||
点击 "Deploy" 并等待构建完成。
|
||
|
||
## 自定义域名
|
||
|
||
1. 前往项目设置
|
||
2. 进入 "Domains"
|
||
3. 添加您的自定义域名
|
||
4. 按说明配置 DNS
|
||
|
||
## 限制
|
||
|
||
::: warning 大文件
|
||
Vercel 的 serverless 函数有 50MB 的限制。由于 BentoPDF 是静态站点，这通常不会影响您，但 WASM 模块很大（总计约 100MB）。请确保它们从 `/public` 文件夹提供。
|
||
:::
|
||
|
||
## 故障排除
|
||
|
||
### 构建超时
|
||
|
||
如果构建超时，请尝试：
|
||
|
||
```json
|
||
// vercel.json
|
||
{
|
||
"buildCommand": "npm run build",
|
||
"outputDirectory": "dist"
|
||
}
|
||
```
|
||
|
||
### 刷新后出现 404
|
||
|
||
添加 `vercel.json` 以支持 SPA 路由：
|
||
|
||
```json
|
||
{
|
||
"rewrites": [{ "source": "/(.*)", "destination": "/index.html" }]
|
||
}
|
||
```
|
||
|
||
### Word/ODT/Excel 转 PDF 无法使用
|
||
|
||
LibreOffice WASM 转换需要 `SharedArrayBuffer`，这要求所有页面都带有以下响应标头：
|
||
|
||
- `Cross-Origin-Embedder-Policy: require-corp`
|
||
- `Cross-Origin-Opener-Policy: same-origin`
|
||
|
||
预压缩的 `.wasm.gz` 和 `.data.gz` 文件还需要 `Content-Encoding: gzip`，浏览器才会对其解压。
|
||
|
||
将以下内容添加到您的 `vercel.json`：
|
||
|
||
```json
|
||
{
|
||
"rewrites": [{ "source": "/(.*)", "destination": "/index.html" }],
|
||
"headers": [
|
||
{
|
||
"source": "/(.*)",
|
||
"headers": [
|
||
{ "key": "Cross-Origin-Embedder-Policy", "value": "require-corp" },
|
||
{ "key": "Cross-Origin-Opener-Policy", "value": "same-origin" },
|
||
{ "key": "Cross-Origin-Resource-Policy", "value": "cross-origin" }
|
||
]
|
||
},
|
||
{
|
||
"source": "/libreoffice-wasm/soffice.wasm.gz",
|
||
"headers": [
|
||
{ "key": "Content-Type", "value": "application/wasm" },
|
||
{ "key": "Content-Encoding", "value": "gzip" }
|
||
]
|
||
},
|
||
{
|
||
"source": "/libreoffice-wasm/soffice.data.gz",
|
||
"headers": [
|
||
{ "key": "Content-Type", "value": "application/octet-stream" },
|
||
{ "key": "Content-Encoding", "value": "gzip" }
|
||
]
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
要验证，请打开开发者工具控制台并运行 `console.log(window.crossOriginIsolated)`，它应返回 `true`。
|