mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 11:52:48 +01:00
155 lines
4.9 KiB
Markdown
155 lines
4.9 KiB
Markdown
# Déployer sur Cloudflare Pages
|
|
|
|
[Cloudflare Pages](https://pages.cloudflare.com) propose un hébergement de sites statiques rapide et mondial, avec une bande passante illimitée.
|
|
|
|
## Déploiement rapide
|
|
|
|
1. Allez sur [Cloudflare Pages](https://dash.cloudflare.com/?to=/:account/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 :
|
|
|
|
```bash
|
|
# 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 :
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
VITE_CORS_PROXY_URL=https://your-worker.workers.dev npm run build
|
|
```
|
|
|
|
Ou avec Docker :
|
|
|
|
```bash
|
|
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](https://github.com/alam00000/bentopdf#digital-signature-cors-proxy-required) pour la configuration de la signature HMAC.
|