部署到 Vercel

Vercel 為靜態網站提供最簡單的部署體驗。

一鍵部署

手動部署

步驟 1：Fork 儲存庫

將 bentopdf/bentopdf Fork 到您的 GitHub 帳號。

步驟 2：匯入至 Vercel

前往 vercel.com/new
選擇您 Fork 的儲存庫
設定專案：

設定項目	值
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」並等待建置完成。

自訂網域

前往專案設定
進入「Domains」
加入您的自訂網域
依照指示設定 DNS

限制

::: warning 大型檔案 Vercel 的無伺服器函式有 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。

3.5 KiB Raw Blame History Unescape Escape