部署到 Vercel

Vercel 为静态站点提供最简单的部署体验。

一键部署

手动部署

步骤 1：Fork 仓库

将 bentopdf/bentopdf Fork 到您的 GitHub 账户。

步骤 2：导入到 Vercel

1. 前往 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

限制

大文件

Vercel 的 serverless 函数有 50MB 的限制。由于 BentoPDF 是静态站点，这通常不会影响您，但 WASM 模块很大（总计约 100MB）。请确保它们从 /public 文件夹提供。

故障排除

构建超时

如果构建超时，请尝试：

// vercel.json
{
  "buildCommand": "npm run build",
  "outputDirectory": "dist"
}

刷新后出现 404

添加 vercel.json 以支持 SPA 路由：

{
  "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：

{
  "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。