mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 20:02:47 +01:00
155 lines
4.6 KiB
Markdown
155 lines
4.6 KiB
Markdown
# Nasadenie na Cloudflare Pages
|
|
|
|
[Cloudflare Pages](https://pages.cloudflare.com) ponúka rýchly globálny hosting statických stránok s neobmedzeným prenosom dát.
|
|
|
|
## Rýchle nasadenie
|
|
|
|
1. Prejdite na [Cloudflare Pages](https://dash.cloudflare.com/?to=/:account/pages)
|
|
2. Kliknite na „Create a project“
|
|
3. Pripojte svoj GitHub repozitár
|
|
|
|
## Konfigurácia zostavenia
|
|
|
|
| Nastavenie | Hodnota |
|
|
| ---------------------- | --------------- |
|
|
| Framework preset | None |
|
|
| Build command | `npm run build` |
|
|
| Build output directory | `dist` |
|
|
| Root directory | `/` |
|
|
|
|
## Premenné prostredia
|
|
|
|
Pridajte ich v Settings → Environment variables:
|
|
|
|
| Premenná | Hodnota |
|
|
| ----------------------- | -------------------------------------------------- |
|
|
| `NODE_VERSION` | `18` |
|
|
| `SIMPLE_MODE` | `false` (voliteľné) |
|
|
| `VITE_BRAND_NAME` | Vlastný názov značky (voliteľné) |
|
|
| `VITE_BRAND_LOGO` | Cesta k logu relatívne k `public/` (voliteľné) |
|
|
| `VITE_FOOTER_TEXT` | Vlastný text päty/copyrightu (voliteľné) |
|
|
| `VITE_DEFAULT_LANGUAGE` | Predvolený jazyk rozhrania, napr. `fr` (voliteľné) |
|
|
|
|
## Konfiguračný súbor
|
|
|
|
Vytvorte `_headers` v priečinku `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 Dôležité
|
|
Hlavičky `Cross-Origin-Embedder-Policy` a `Cross-Origin-Opener-Policy` sú potrebné na prevody Word/ODT/Excel/PowerPoint do PDF. Bez nich nie je `SharedArrayBuffer` dostupný a engine LibreOffice WASM sa nepodarí inicializovať.
|
|
:::
|
|
|
|
Vytvorte `_redirects` pre smerovanie SPA:
|
|
|
|
```
|
|
/* /index.html 200
|
|
```
|
|
|
|
## Vlastná doména
|
|
|
|
1. Prejdite do svojho projektu Pages
|
|
2. Kliknite na „Custom domains“
|
|
3. Pridajte svoju doménu
|
|
4. Ak je doména na Cloudflare, Cloudflare automaticky nastaví DNS
|
|
|
|
## Výhody
|
|
|
|
- **Neobmedzený prenos dát zadarmo**
|
|
- **Globálne CDN** s viac ako 300 okrajovými lokalitami
|
|
- **Automatické HTTPS**
|
|
- **Náhľadové nasadenia** pre pull requesty
|
|
- **Rýchle zostavenia**
|
|
|
|
## Riešenie problémov
|
|
|
|
### Nahrávanie veľkých súborov
|
|
|
|
Cloudflare Pages podporuje súbory do 25 MB. WASM moduly by mali byť v poriadku, no ak narazíte na limity, zvážte:
|
|
|
|
```bash
|
|
# Split large files during build
|
|
npm run build
|
|
```
|
|
|
|
### Limity veľkosti Workera
|
|
|
|
Ak používate Cloudflare Workers na pokročilé smerovanie, myslite na limit 1 MB v bezplatných plánoch.
|
|
|
|
## CORS proxy Worker (pre digitálne podpisy)
|
|
|
|
Nástroj Digitálny podpis potrebuje CORS proxy na získanie reťazcov certifikátov. Nasaďte priložený worker:
|
|
|
|
```bash
|
|
cd cloudflare
|
|
npx wrangler login
|
|
npx wrangler deploy
|
|
```
|
|
|
|
### Bezpečnostné funkcie
|
|
|
|
| Funkcia | Popis |
|
|
| ---------------------------- | -------------------------------- |
|
|
| **Obmedzenia URL** | Povolené sú len URL certifikátov |
|
|
| **Limit veľkosti súboru** | Max. 10MB na požiadavku |
|
|
| **Obmedzenie frekvencie** | 60 pož./IP/min (vyžaduje KV) |
|
|
| **Blokovanie súkromných IP** | Blokuje localhost a interné IP |
|
|
|
|
### Zapnutie obmedzenia frekvencie
|
|
|
|
```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
|
|
```
|
|
|
|
### Zostavenie s URL proxy
|
|
|
|
```bash
|
|
VITE_CORS_PROXY_URL=https://your-worker.workers.dev npm run build
|
|
```
|
|
|
|
Alebo s 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 .
|
|
```
|
|
|
|
> **Poznámka:** Nastavenie HMAC podpisu nájdete v [README](https://github.com/alam00000/bentopdf#digital-signature-cors-proxy-required).
|