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

Cloudflare Pages'e Dağıtım

Cloudflare Pages, sınırsız bant genişliğiyle hızlı, küresel statik site barındırma sunar.

Hızlı Dağıtım

1. Cloudflare Pages sayfasına gidin
2. "Create a project" düğmesine tıklayın
3. GitHub deponuzu bağlayın

Derleme Yapılandırması

Ayar	Değer
Framework preset	None
Build command	npm run build
Build output directory	dist
Root directory	/

Ortam Değişkenleri

Bunları Settings → Environment variables bölümüne ekleyin:

Değişken	Değer
NODE_VERSION	18
SIMPLE_MODE	false (isteğe bağlı)
VITE_BRAND_NAME	Özel marka adı (isteğe bağlı)
VITE_BRAND_LOGO	public/ klasörüne göre logo yolu (isteğe bağlı)
VITE_FOOTER_TEXT	Özel alt bilgi/telif hakkı metni (isteğe bağlı)
VITE_DEFAULT_LANGUAGE	Varsayılan arayüz dili, örn. fr (isteğe bağlı)

Yapılandırma Dosyası

public klasörünüzde _headers dosyasını oluşturun:

# 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 Önemli Cross-Origin-Embedder-Policy ve Cross-Origin-Opener-Policy başlıkları Word/ODT/Excel/PowerPoint'ten PDF'e dönüştürmeler için gereklidir. Bunlar olmadan SharedArrayBuffer kullanılamaz ve LibreOffice WASM motoru başlatılamaz. :::

SPA yönlendirmesi için _redirects dosyasını oluşturun:

/*    /index.html   200

Özel Alan Adı

1. Pages projenize gidin
2. "Custom domains" düğmesine tıklayın
3. Alan adınızı ekleyin
4. Alan adı Cloudflare'deyse Cloudflare DNS'i otomatik yapılandırır

Avantajlar

• Ücretsiz sınırsız bant genişliği
• 300'den fazla uç noktası olan küresel CDN
• Otomatik HTTPS
• Pull request'ler için önizleme dağıtımları
• Hızlı derlemeler

Sorun Giderme

Büyük Dosya Yüklemeleri

Cloudflare Pages 25 MB'a kadar dosyaları destekler. WASM modüllerinde sorun olmaması gerekir, ancak sınırlara takılırsanız şunu düşünün:

# Split large files during build
npm run build

Worker Boyut Sınırları

Gelişmiş yönlendirme için Cloudflare Workers kullanıyorsanız, ücretsiz planlardaki 1 MB sınırını göz önünde bulundurun.

CORS Proxy Worker (Dijital İmzalar için)

Dijital İmza aracı, sertifika zincirlerini almak için bir CORS proxy gerektirir. Pakete dahil worker'ı dağıtın:

cd cloudflare
npx wrangler login
npx wrangler deploy

Güvenlik Özellikleri

Özellik	Açıklama
URL Kısıtlamaları	Yalnızca sertifika URL'lerine izin verilir
Dosya Boyutu Sınırı	İstek başına en fazla 10MB
Hız Sınırlama	60 istek/IP/dk (KV gerekir)
Özel IP Engelleme	localhost ve dahili IP'leri engeller

Hız Sınırlamayı Etkinleştirme

# 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

Proxy URL ile Derleme

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

Veya Docker ile:

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 .

Not: HMAC imza kurulumu için README dosyasına bakın.