mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 11:52:48 +01:00
155 lines
5.8 KiB
Markdown
155 lines
5.8 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 |
|
||
| Build command | `npm run build` |
|
||
| Build output directory | `dist` |
|
||
| Root directory | `/` |
|
||
|
||
## Змінні середовища
|
||
|
||
Додайте їх у 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 для безкоштовних планів.
|
||
|
||
## Worker CORS-проксі (для цифрових підписів)
|
||
|
||
Інструмент цифрового підпису потребує 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).
|