Triển khai lên Vercel

Vercel mang lại trải nghiệm triển khai dễ nhất cho các trang web tĩnh.

Triển khai một lần nhấp

Triển khai thủ công

Bước 1: Fork repository

Fork bentopdf/bentopdf về tài khoản GitHub của bạn.

Bước 2: Nhập vào Vercel

Truy cập vercel.com/new
Chọn repository đã fork của bạn
Cấu hình dự án:

Thiết lập	Giá trị
Framework Preset	Vite
Build Command	`npm run build`
Output Directory	`dist`
Install Command	`npm install`

Bước 3: Biến môi trường (tùy chọn)

Thêm các biến này nếu cần:

Variable	Mô tả
`SIMPLE_MODE`	Đặt là `true` để có giao diện tối giản
`VITE_BRAND_NAME`	Tên thương hiệu tùy chỉnh (thay cho "BentoPDF")
`VITE_BRAND_LOGO`	Đường dẫn logo tính từ `public/` (ví dụ `images/my-logo.svg`)
`VITE_FOOTER_TEXT`	Văn bản chân trang / bản quyền tùy chỉnh
`VITE_DEFAULT_LANGUAGE`	Ngôn ngữ giao diện mặc định (ví dụ `fr`, `de`, `es`)

Bước 4: Triển khai

Nhấp "Deploy" và đợi quá trình dựng hoàn tất.

Tên miền tùy chỉnh

Vào phần cài đặt dự án của bạn
Chuyển đến "Domains"
Thêm tên miền tùy chỉnh của bạn
Cấu hình DNS theo hướng dẫn

Hạn chế

::: warning Tệp lớn Các serverless function của Vercel có giới hạn 50MB. Vì BentoPDF là trang web tĩnh nên điều này không ảnh hưởng đến bạn, nhưng các mô-đun WASM khá lớn (tổng cộng ~100MB). Hãy đảm bảo chúng được phục vụ từ thư mục /public. :::

Khắc phục sự cố

Hết thời gian dựng

Nếu quá trình dựng bị hết thời gian, hãy thử:

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

Lỗi 404 khi làm mới trang

Thêm vercel.json để định tuyến SPA:

{
  "rewrites": [{ "source": "/(.*)", "destination": "/index.html" }]
}

Chuyển Word/ODT/Excel sang PDF không hoạt động

Việc chuyển đổi LibreOffice WASM cần SharedArrayBuffer, thứ đòi hỏi các header phản hồi sau trên mọi trang:

Cross-Origin-Embedder-Policy: require-corp
Cross-Origin-Opener-Policy: same-origin

Các tệp .wasm.gz và .data.gz đã nén sẵn cũng cần Content-Encoding: gzip để trình duyệt giải nén chúng.

Thêm các mục này vào vercel.json của bạn:

{
  "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" }
      ]
    }
  ]
}

Để kiểm tra, mở Console của DevTools và chạy console.log(window.crossOriginIsolated): kết quả phải là true.

4.0 KiB Raw Blame History