mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 20:02:47 +01:00
155 lines
4.8 KiB
Markdown
155 lines
4.8 KiB
Markdown
# Cloudflare Pages'e Dağıtım
|
||
|
||
[Cloudflare Pages](https://pages.cloudflare.com), 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](https://dash.cloudflare.com/?to=/:account/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:
|
||
|
||
```bash
|
||
# 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:
|
||
|
||
```bash
|
||
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
|
||
|
||
```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
|
||
```
|
||
|
||
### Proxy URL ile Derleme
|
||
|
||
```bash
|
||
VITE_CORS_PROXY_URL=https://your-worker.workers.dev npm run build
|
||
```
|
||
|
||
Veya Docker ile:
|
||
|
||
```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 .
|
||
```
|
||
|
||
> **Not:** HMAC imza kurulumu için [README](https://github.com/alam00000/bentopdf#digital-signature-cors-proxy-required) dosyasına bakın.
|