mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 20:02:47 +01:00
155 lines
4.7 KiB
Markdown
155 lines
4.7 KiB
Markdown
# Driftsätt på Cloudflare Pages
|
|
|
|
[Cloudflare Pages](https://pages.cloudflare.com) erbjuder snabb, global hosting av statiska webbplatser med obegränsad bandbredd.
|
|
|
|
## Snabb driftsättning
|
|
|
|
1. Gå till [Cloudflare Pages](https://dash.cloudflare.com/?to=/:account/pages)
|
|
2. Klicka på "Create a project"
|
|
3. Anslut ditt GitHub-repository
|
|
|
|
## Byggkonfiguration
|
|
|
|
| Inställning | Värde |
|
|
| ---------------------- | --------------- |
|
|
| Framework preset | None |
|
|
| Build command | `npm run build` |
|
|
| Build output directory | `dist` |
|
|
| Root directory | `/` |
|
|
|
|
## Miljövariabler
|
|
|
|
Lägg till dessa under Settings → Environment variables:
|
|
|
|
| Variabel | Värde |
|
|
| ----------------------- | ----------------------------------------------------- |
|
|
| `NODE_VERSION` | `18` |
|
|
| `SIMPLE_MODE` | `false` (valfritt) |
|
|
| `VITE_BRAND_NAME` | Eget varumärkesnamn (valfritt) |
|
|
| `VITE_BRAND_LOGO` | Logotypens sökväg relativt `public/` (valfritt) |
|
|
| `VITE_FOOTER_TEXT` | Egen sidfots-/upphovsrättstext (valfritt) |
|
|
| `VITE_DEFAULT_LANGUAGE` | Standardspråk för gränssnittet, t.ex. `fr` (valfritt) |
|
|
|
|
## Konfigurationsfil
|
|
|
|
Skapa `_headers` i din `public`-mapp:
|
|
|
|
```
|
|
# 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 Viktigt
|
|
Rubrikerna `Cross-Origin-Embedder-Policy` och `Cross-Origin-Opener-Policy` krävs för konvertering av Word/ODT/Excel/PowerPoint till PDF. Utan dem är `SharedArrayBuffer` inte tillgängligt och LibreOffice WASM-motorn kan inte initieras.
|
|
:::
|
|
|
|
Skapa `_redirects` för SPA-routing:
|
|
|
|
```
|
|
/* /index.html 200
|
|
```
|
|
|
|
## Egen domän
|
|
|
|
1. Gå till ditt Pages-projekt
|
|
2. Klicka på "Custom domains"
|
|
3. Lägg till din domän
|
|
4. Cloudflare konfigurerar DNS automatiskt om domänen finns hos Cloudflare
|
|
|
|
## Fördelar
|
|
|
|
- **Gratis obegränsad bandbredd**
|
|
- **Globalt CDN** med över 300 edge-platser
|
|
- **Automatisk HTTPS**
|
|
- **Förhandsdriftsättningar** för pull requests
|
|
- **Snabba byggen**
|
|
|
|
## Felsökning
|
|
|
|
### Uppladdning av stora filer
|
|
|
|
Cloudflare Pages stöder filer upp till 25 MB. WASM-moduler bör fungera bra, men om du når gränserna kan du överväga:
|
|
|
|
```bash
|
|
# Split large files during build
|
|
npm run build
|
|
```
|
|
|
|
### Storleksgränser för Workers
|
|
|
|
Om du använder Cloudflare Workers för avancerad routing, notera gränsen på 1 MB för gratisplaner.
|
|
|
|
## CORS-proxy-Worker (för digitala signaturer)
|
|
|
|
Verktyget för digitala signaturer kräver en CORS-proxy för att hämta certifikatkedjor. Driftsätt den medföljande workern:
|
|
|
|
```bash
|
|
cd cloudflare
|
|
npx wrangler login
|
|
npx wrangler deploy
|
|
```
|
|
|
|
### Säkerhetsfunktioner
|
|
|
|
| Funktion | Beskrivning |
|
|
| ---------------------------- | ------------------------------------------- |
|
|
| **URL-begränsningar** | Endast certifikat-URL:er tillåts |
|
|
| **Filstorleksgräns** | Max 10MB per förfrågan |
|
|
| **Hastighetsbegränsning** | 60 förfr./IP/min (kräver KV) |
|
|
| **Blockering av privata IP** | Blockerar localhost och interna IP-adresser |
|
|
|
|
### Aktivera hastighetsbegränsning
|
|
|
|
```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
|
|
```
|
|
|
|
### Bygg med proxy-URL
|
|
|
|
```bash
|
|
VITE_CORS_PROXY_URL=https://your-worker.workers.dev npm run build
|
|
```
|
|
|
|
Eller med 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 .
|
|
```
|
|
|
|
> **Obs:** Se [README](https://github.com/alam00000/bentopdf#digital-signature-cors-proxy-required) för hur du ställer in HMAC-signaturer.
|