mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 11:52:48 +01:00
155 lines
4.7 KiB
Markdown
155 lines
4.7 KiB
Markdown
# Distribuzione su Cloudflare Pages
|
|
|
|
[Cloudflare Pages](https://pages.cloudflare.com) offre hosting di siti statici veloce e globale con banda illimitata.
|
|
|
|
## Distribuzione rapida
|
|
|
|
1. Vai su [Cloudflare Pages](https://dash.cloudflare.com/?to=/:account/pages)
|
|
2. Clicca su "Create a project"
|
|
3. Collega il tuo repository GitHub
|
|
|
|
## Configurazione della build
|
|
|
|
| Impostazione | Valore |
|
|
| ---------------------- | --------------- |
|
|
| Framework preset | None |
|
|
| Build command | `npm run build` |
|
|
| Build output directory | `dist` |
|
|
| Root directory | `/` |
|
|
|
|
## Variabili d'ambiente
|
|
|
|
Aggiungile in Settings → Environment variables:
|
|
|
|
| Variabile | Valore |
|
|
| ----------------------- | ----------------------------------------------------------- |
|
|
| `NODE_VERSION` | `18` |
|
|
| `SIMPLE_MODE` | `false` (facoltativo) |
|
|
| `VITE_BRAND_NAME` | Nome del marchio personalizzato (facoltativo) |
|
|
| `VITE_BRAND_LOGO` | Percorso del logo relativo a `public/` (facoltativo) |
|
|
| `VITE_FOOTER_TEXT` | Testo personalizzato del footer/copyright (facoltativo) |
|
|
| `VITE_DEFAULT_LANGUAGE` | Lingua predefinita dell'interfaccia, es. `fr` (facoltativo) |
|
|
|
|
## File di configurazione
|
|
|
|
Crea `_headers` nella tua cartella `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 Importante
|
|
Gli header `Cross-Origin-Embedder-Policy` e `Cross-Origin-Opener-Policy` sono necessari per le conversioni da Word/ODT/Excel/PowerPoint a PDF. Senza di essi, `SharedArrayBuffer` non è disponibile e il motore LibreOffice WASM non riesce a inizializzarsi.
|
|
:::
|
|
|
|
Crea `_redirects` per il routing SPA:
|
|
|
|
```
|
|
/* /index.html 200
|
|
```
|
|
|
|
## Dominio personalizzato
|
|
|
|
1. Vai al tuo progetto Pages
|
|
2. Clicca su "Custom domains"
|
|
3. Aggiungi il tuo dominio
|
|
4. Cloudflare configurerà automaticamente il DNS se il dominio è su Cloudflare
|
|
|
|
## Vantaggi
|
|
|
|
- **Banda illimitata gratuita**
|
|
- **CDN globale** con oltre 300 sedi edge
|
|
- **HTTPS automatico**
|
|
- **Anteprime di distribuzione** per le pull request
|
|
- **Build veloci**
|
|
|
|
## Risoluzione dei problemi
|
|
|
|
### Caricamento di file di grandi dimensioni
|
|
|
|
Cloudflare Pages supporta file fino a 25 MB. I moduli WASM dovrebbero andare bene, ma se raggiungi i limiti, valuta:
|
|
|
|
```bash
|
|
# Split large files during build
|
|
npm run build
|
|
```
|
|
|
|
### Limiti di dimensione dei Worker
|
|
|
|
Se usi Cloudflare Workers per un routing avanzato, tieni presente il limite di 1 MB dei piani gratuiti.
|
|
|
|
## Worker proxy CORS (per le firme digitali)
|
|
|
|
Lo strumento di firma digitale richiede un proxy CORS per recuperare le catene di certificati. Distribuisci il worker incluso:
|
|
|
|
```bash
|
|
cd cloudflare
|
|
npx wrangler login
|
|
npx wrangler deploy
|
|
```
|
|
|
|
### Funzionalità di sicurezza
|
|
|
|
| Funzionalità | Descrizione |
|
|
| ---------------------------- | ---------------------------------- |
|
|
| **Restrizioni sugli URL** | Consentiti solo URL di certificati |
|
|
| **Limite di dimensione** | Max 10MB per richiesta |
|
|
| **Limitazione di frequenza** | 60 richieste/IP/min (richiede KV) |
|
|
| **Blocco degli IP privati** | Blocca localhost e IP interni |
|
|
|
|
### Abilitare la limitazione di frequenza
|
|
|
|
```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
|
|
```
|
|
|
|
### Compilare con l'URL del proxy
|
|
|
|
```bash
|
|
VITE_CORS_PROXY_URL=https://your-worker.workers.dev npm run build
|
|
```
|
|
|
|
Oppure con 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 .
|
|
```
|
|
|
|
> **Nota:** consulta il [README](https://github.com/alam00000/bentopdf#digital-signature-cors-proxy-required) per la configurazione della firma HMAC.
|