mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 20:02:47 +01:00
155 lines
6.0 KiB
Markdown
155 lines
6.0 KiB
Markdown
# Разгортванне на Cloudflare Pages
|
||
|
||
[Cloudflare Pages](https://pages.cloudflare.com) прапануе хуткі глабальны хостынг статычных сайтаў з неабмежаванай прапускной здольнасцю.
|
||
|
||
## Хуткае разгортванне
|
||
|
||
1. Перайдзіце ў [Cloudflare Pages](https://dash.cloudflare.com/?to=/:account/pages)
|
||
2. Націсніце "Create a project"
|
||
3. Падключыце ваш рэпазіторый GitHub
|
||
|
||
## Канфігурацыя зборкі
|
||
|
||
| Параметр | Значэнне |
|
||
| --------------------- | --------------- |
|
||
| Framework preset | None |
|
||
| Каманда зборкі | `npm run build` |
|
||
| Каталог вываду зборкі | `dist` |
|
||
| Каранёвы каталог | `/` |
|
||
|
||
## Зменныя асяроддзя
|
||
|
||
Дадайце іх у Settings → Environment variables:
|
||
|
||
| Зменная | Значэнне |
|
||
| ----------------------- | ----------------------------------------------------------- |
|
||
| `NODE_VERSION` | `18` |
|
||
| `SIMPLE_MODE` | `false` (неабавязкова) |
|
||
| `VITE_BRAND_NAME` | Уласная назва брэнда (неабавязкова) |
|
||
| `VITE_BRAND_LOGO` | Шлях да лагатыпа адносна `public/` (неабавязкова) |
|
||
| `VITE_FOOTER_TEXT` | Уласны тэкст футэра/аўтарскіх правоў (неабавязкова) |
|
||
| `VITE_DEFAULT_LANGUAGE` | Мова інтэрфейсу па змаўчанні, напрыклад `fr` (неабавязкова) |
|
||
|
||
## Файл канфігурацыі
|
||
|
||
Стварыце `_headers` у тэчцы `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 Важна
|
||
Загалоўкі `Cross-Origin-Embedder-Policy` і `Cross-Origin-Opener-Policy` абавязковыя для канвертацыі Word/ODT/Excel/PowerPoint у PDF. Без іх `SharedArrayBuffer` недаступны, і рухавік LibreOffice WASM не здолее ініцыялізавацца.
|
||
:::
|
||
|
||
Стварыце `_redirects` для SPA-маршрутызацыі:
|
||
|
||
```
|
||
/* /index.html 200
|
||
```
|
||
|
||
## Уласны дамен
|
||
|
||
1. Перайдзіце ў ваш праект Pages
|
||
2. Націсніце "Custom domains"
|
||
3. Дадайце ваш дамен
|
||
4. Cloudflare аўтаматычна наладзіць DNS, калі дамен знаходзіцца ў Cloudflare
|
||
|
||
## Перавагі
|
||
|
||
- **Бясплатная неабмежаваная прапускная здольнасць**
|
||
- **Глабальны CDN** з 300+ пагранічнымі вузламі
|
||
- **Аўтаматычны HTTPS**
|
||
- **Папярэднія разгортванні** для pull request
|
||
- **Хуткія зборкі**
|
||
|
||
## Вырашэнне праблем
|
||
|
||
### Загрузка вялікіх файлаў
|
||
|
||
Cloudflare Pages падтрымлівае файлы да 25 MB. З модулямі WASM праблем быць не павінна, але калі вы ўпраецеся ў ліміты, паспрабуйце:
|
||
|
||
```bash
|
||
# Split large files during build
|
||
npm run build
|
||
```
|
||
|
||
### Ліміты памеру Worker
|
||
|
||
Калі вы выкарыстоўваеце Cloudflare Workers для пашыранай маршрутызацыі, улічвайце ліміт 1 MB на бясплатных планах.
|
||
|
||
## CORS-проксі Worker (для лічбавых подпісаў)
|
||
|
||
Інструменту лічбавага подпісу патрэбны CORS-проксі, каб атрымліваць ланцужкі сертыфікатаў. Разгарніце ўключаны worker:
|
||
|
||
```bash
|
||
cd cloudflare
|
||
npx wrangler login
|
||
npx wrangler deploy
|
||
```
|
||
|
||
### Функцыі бяспекі
|
||
|
||
| Функцыя | Апісанне |
|
||
| --------------------------- | --------------------------------- |
|
||
| **Абмежаванні URL** | Дазволены толькі URL сертыфікатаў |
|
||
| **Ліміт памеру файла** | Максімум 10MB на запыт |
|
||
| **Абмежаванне частаты** | 60 запытаў/IP/хв (патрабуе KV) |
|
||
| **Блакіроўка прыватных IP** | Блакіруе localhost і ўнутраныя IP |
|
||
|
||
### Уключэнне абмежавання частаты
|
||
|
||
```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
|
||
```
|
||
|
||
### Зборка з URL проксі
|
||
|
||
```bash
|
||
VITE_CORS_PROXY_URL=https://your-worker.workers.dev npm run build
|
||
```
|
||
|
||
Або з 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 .
|
||
```
|
||
|
||
> **Заўвага:** наладка подпісу HMAC апісана ў [README](https://github.com/alam00000/bentopdf#digital-signature-cors-proxy-required).
|