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

Déployer sur Cloudflare Pages

Cloudflare Pages propose un hébergement de sites statiques rapide et mondial, avec une bande passante illimitée.

Déploiement rapide

1. Allez sur Cloudflare Pages
2. Cliquez sur « Create a project »
3. Connectez votre dépôt GitHub

Configuration du build

Paramètre	Valeur
Framework preset	None
Build command	npm run build
Build output directory	dist
Root directory	/

Variables d'environnement

Ajoutez-les dans Settings → Environment variables :

Variable	Valeur
NODE_VERSION	18
SIMPLE_MODE	false (facultatif)
VITE_BRAND_NAME	Nom de marque personnalisé (facultatif)
VITE_BRAND_LOGO	Chemin du logo relatif à public/ (facultatif)
VITE_FOOTER_TEXT	Texte de pied de page/copyright personnalisé (facultatif)
VITE_DEFAULT_LANGUAGE	Langue par défaut de l'interface, p. ex. fr (facultatif)

Fichier de configuration

Créez _headers dans votre dossier 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 en-têtes Cross-Origin-Embedder-Policy et Cross-Origin-Opener-Policy sont requis pour les conversions Word/ODT/Excel/PowerPoint vers PDF. Sans eux, SharedArrayBuffer n'est pas disponible et le moteur LibreOffice WASM ne parviendra pas à s'initialiser. :::

Créez _redirects pour le routage SPA :

/*    /index.html   200

Domaine personnalisé

1. Ouvrez votre projet Pages
2. Cliquez sur « Custom domains »
3. Ajoutez votre domaine
4. Cloudflare configurera automatiquement le DNS si le domaine est chez Cloudflare

Avantages

• Bande passante illimitée et gratuite
• CDN mondial avec plus de 300 points de présence
• HTTPS automatique
• Déploiements de prévisualisation pour les pull requests
• Builds rapides

Dépannage

Téléversement de gros fichiers

Cloudflare Pages prend en charge les fichiers jusqu'à 25 Mo. Les modules WASM ne devraient pas poser de problème, mais si vous atteignez les limites, envisagez :

# Split large files during build
npm run build

Limites de taille des Workers

Si vous utilisez Cloudflare Workers pour un routage avancé, notez la limite de 1 Mo des offres gratuites.

Worker proxy CORS (pour les signatures numériques)

L'outil de signature numérique nécessite un proxy CORS pour récupérer les chaînes de certificats. Déployez le worker fourni :

cd cloudflare
npx wrangler login
npx wrangler deploy

Fonctionnalités de sécurité

Fonctionnalité	Description
Restrictions d'URL	Seules les URL de certificats sont autorisées
Limite de taille	10 Mo max par requête
Limitation de débit	60 req/IP/min (nécessite KV)
Blocage des IP privées	Bloque localhost et les IP internes

Activer la limitation de débit

# 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

Compiler avec l'URL du proxy

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

Ou avec 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 .

Remarque : Consultez le README pour la configuration de la signature HMAC.