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

Auf Cloudflare Pages bereitstellen

Cloudflare Pages bietet schnelles, globales Hosting für statische Websites mit unbegrenzter Bandbreite.

Schnelle Bereitstellung

1. Gehen Sie zu Cloudflare Pages
2. Klicken Sie auf "Create a project"
3. Verbinden Sie Ihr GitHub-Repository

Build-Konfiguration

Einstellung	Wert
Framework preset	None
Build command	npm run build
Build output directory	dist
Root directory	/

Umgebungsvariablen

Fügen Sie diese unter Settings → Environment variables hinzu:

Variable	Wert
NODE_VERSION	18
SIMPLE_MODE	false (optional)
VITE_BRAND_NAME	Eigener Markenname (optional)
VITE_BRAND_LOGO	Logo-Pfad relativ zu public/ (optional)
VITE_FOOTER_TEXT	Eigener Footer-/Copyright-Text (optional)
VITE_DEFAULT_LANGUAGE	Standard-Oberflächensprache, z. B. fr (optional)

Konfigurationsdatei

Erstellen Sie _headers in Ihrem Ordner 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 Wichtig Die Header Cross-Origin-Embedder-Policy und Cross-Origin-Opener-Policy sind für Konvertierungen von Word/ODT/Excel/PowerPoint zu PDF erforderlich. Ohne sie ist SharedArrayBuffer nicht verfügbar, und die LibreOffice-WASM-Engine kann nicht initialisiert werden. :::

Erstellen Sie _redirects für das SPA-Routing:

/*    /index.html   200

Eigene Domain

1. Öffnen Sie Ihr Pages-Projekt
2. Klicken Sie auf "Custom domains"
3. Fügen Sie Ihre Domain hinzu
4. Cloudflare konfiguriert das DNS automatisch, wenn die Domain bei Cloudflare liegt

Vorteile

• Kostenlose, unbegrenzte Bandbreite
• Globales CDN mit über 300 Edge-Standorten
• Automatisches HTTPS
• Vorschau-Bereitstellungen für Pull Requests
• Schnelle Builds

Fehlerbehebung

Upload großer Dateien

Cloudflare Pages unterstützt Dateien bis 25 MB. WASM-Module sollten kein Problem sein, aber wenn Sie an Grenzen stoßen, sollten Sie Folgendes überlegen:

# Split large files during build
npm run build

Größenlimits für Worker

Wenn Sie Cloudflare Workers für erweitertes Routing nutzen, beachten Sie das Limit von 1 MB in kostenlosen Tarifen.

CORS-Proxy-Worker (für digitale Signaturen)

Das Werkzeug für digitale Signaturen benötigt einen CORS-Proxy, um Zertifikatsketten abzurufen. Stellen Sie den mitgelieferten Worker bereit:

cd cloudflare
npx wrangler login
npx wrangler deploy

Sicherheitsfunktionen

Funktion	Beschreibung
URL-Beschränkungen	Nur Zertifikat-URLs erlaubt
Dateigrößenlimit	Max. 10MB pro Anfrage
Ratenbegrenzung	60 Anfr./IP/Min. (erfordert KV)
Blockierung privater IPs	Blockiert localhost und interne IPs

Ratenbegrenzung aktivieren

# 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

Mit Proxy-URL bauen

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

Oder mit 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 .

Hinweis: Die Einrichtung der HMAC-Signatur finden Sie in der README.