bentopdf/docs/zh/self-hosting/cloudflare.md

部署到 Cloudflare Pages

Cloudflare Pages 提供快速的全球静态站点托管，带宽不限量。

快速部署

1. 前往 Cloudflare Pages
2. 点击 "Create a project"
3. 连接您的 GitHub 仓库

构建配置

设置	值
Framework preset	None
Build command	npm run build
Build output directory	dist
Root directory	/

环境变量

在 Settings → Environment variables 中添加以下变量：

变量	值
NODE_VERSION	18
SIMPLE_MODE	false（可选）
VITE_BRAND_NAME	自定义品牌名称（可选）
VITE_BRAND_LOGO	相对于 public/ 的 Logo 路径（可选）
VITE_FOOTER_TEXT	自定义页脚/版权文本（可选）
VITE_DEFAULT_LANGUAGE	默认界面语言，例如 fr（可选）

配置文件

在 public 文件夹中创建 _headers：

# Required security headers for SharedArrayBuffer (used by LibreOffice WASM)
/*
  Cross-Origin-Embedder-Policy: require-corp
  Cross-Origin-Opener-Policy: same-origin
  Cross-Origin-Resource-Policy: cross-origin

# Pre-compressed LibreOffice WASM binary
/libreoffice-wasm/soffice.wasm.gz
  Content-Type: application/wasm
  Content-Encoding: gzip
  Cache-Control: public, max-age=31536000, immutable

# Pre-compressed LibreOffice WASM data
/libreoffice-wasm/soffice.data.gz
  Content-Type: application/octet-stream
  Content-Encoding: gzip
  Cache-Control: public, max-age=31536000, immutable

# Cache WASM files aggressively
/*.wasm
  Cache-Control: public, max-age=31536000, immutable
  Content-Type: application/wasm

# Service worker
/sw.js
  Cache-Control: no-cache

::: warning 重要 Word/ODT/Excel/PowerPoint 转 PDF 需要 Cross-Origin-Embedder-Policy 和 Cross-Origin-Opener-Policy 响应头。没有它们，SharedArrayBuffer 将不可用，LibreOffice WASM 引擎将无法初始化。 :::

创建 _redirects 以支持 SPA 路由：

/*    /index.html   200

自定义域名

1. 前往您的 Pages 项目
2. 点击 "Custom domains"
3. 添加您的域名
4. 如果域名托管在 Cloudflare，Cloudflare 会自动配置 DNS

优势

• 免费且带宽不限量
• 全球 CDN，拥有 300+ 个边缘节点
• 自动 HTTPS
• 为拉取请求提供预览部署
• 构建速度快

故障排查

大文件上传

Cloudflare Pages 支持最大 25 MB 的文件。WASM 模块通常没有问题，但如果遇到限制，可以考虑：

# Split large files during build
npm run build

Worker 大小限制

如果使用 Cloudflare Workers 进行高级路由，请注意免费计划有 1 MB 的限制。

CORS 代理 Worker（用于数字签名）

数字签名工具需要 CORS 代理来获取证书链。请部署随附的 worker：

cd cloudflare
npx wrangler login
npx wrangler deploy

安全特性

特性	说明
URL 限制	仅允许证书 URL
文件大小限制	每个请求最大 10MB
速率限制	每个 IP 每分钟 60 次请求（需要 KV）
私有 IP 拦截	拦截 localhost 和内部 IP

启用速率限制

# Create KV namespace
npx wrangler kv namespace create "RATE_LIMIT_KV"

# Add to wrangler.toml with returned ID:
# [[kv_namespaces]]
# binding = "RATE_LIMIT_KV"
# id = "YOUR_ID"

npx wrangler deploy

使用代理 URL 构建

VITE_CORS_PROXY_URL=https://your-worker.workers.dev npm run build

或者使用 Docker：

export VITE_CORS_PROXY_URL="https://your-worker.workers.dev"
DOCKER_BUILDKIT=1 docker build \
  --secret id=VITE_CORS_PROXY_URL,env=VITE_CORS_PROXY_URL \
  -t your-bentopdf .

注意： HMAC 签名的设置请参阅 README。