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

Desplega a Cloudflare Pages

Cloudflare Pages ofereix allotjament estàtic ràpid i global amb amplada de banda il·limitada.

Desplegament ràpid

1. Ves a Cloudflare Pages
2. Fes clic a "Create a project"
3. Connecta el teu repositori de GitHub

Configuració de la compilació

Paràmetre	Valor
Framework preset	None
Build command	npm run build
Build output directory	dist
Root directory	/

Variables d'entorn

Afegeix-les a Settings → Environment variables:

Variable	Valor
NODE_VERSION	18
SIMPLE_MODE	false (opcional)
VITE_BRAND_NAME	Nom de marca personalitzat (opcional)
VITE_BRAND_LOGO	Ruta del logotip relativa a public/ (opcional)
VITE_FOOTER_TEXT	Text personalitzat del peu de pàgina/copyright (opcional)
VITE_DEFAULT_LANGUAGE	Idioma per defecte de la interfície, p. ex. fr (opcional)

Fitxer de configuració

Crea _headers a la carpeta public:

# 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 Important Les capçaleres Cross-Origin-Embedder-Policy i Cross-Origin-Opener-Policy són obligatòries per a les conversions de Word/ODT/Excel/PowerPoint a PDF. Sense elles, SharedArrayBuffer no està disponible i el motor LibreOffice WASM no s'inicialitzarà. :::

Crea _redirects per a l'encaminament SPA:

/*    /index.html   200

Domini personalitzat

1. Ves al teu projecte de Pages
2. Fes clic a "Custom domains"
3. Afegeix el teu domini
4. Cloudflare configurarà el DNS automàticament si el domini és a Cloudflare

Avantatges

• Amplada de banda il·limitada i gratuïta
• CDN global amb més de 300 ubicacions de xarxa
• HTTPS automàtic
• Desplegaments de previsualització per a les pull requests
• Compilacions ràpides

Resolució de problemes

Càrrega de fitxers grans

Cloudflare Pages admet fitxers de fins a 25 MB. Els mòduls WASM haurien d'anar bé, però si arribes als límits, considera:

# Split large files during build
npm run build

Límits de mida dels Workers

Si utilitzes Cloudflare Workers per a un encaminament avançat, tingues en compte el límit d'1 MB dels plans gratuïts.

Worker de proxy CORS (per a signatures digitals)

L'eina de signatura digital requereix un proxy CORS per obtenir les cadenes de certificats. Desplega el worker inclòs:

cd cloudflare
npx wrangler login
npx wrangler deploy

Funcions de seguretat

Funció	Descripció
Restriccions d'URL	Només es permeten URL de certificats
Límit de mida	Màx. 10MB per petició
Límit de freqüència	60 peticions/IP/min (requereix KV)
Bloqueig d'IP privades	Bloqueja localhost i IP internes

Activa el límit de freqüència

# 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

Compila amb la URL del proxy

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

O amb 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 .

Nota: Consulta el README per a la configuració de la signatura HMAC.