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

Розгортання на Cloudflare Pages

Cloudflare Pages пропонує швидкий глобальний хостинг статичних сайтів з необмеженим трафіком.

Швидке розгортання

1. Перейдіть до Cloudflare 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 мають вміститися, але якщо ви впираєтеся в ліміти, розгляньте:

# Split large files during build
npm run build

Ліміти розміру Worker

Якщо ви використовуєте Cloudflare Workers для складної маршрутизації, зверніть увагу на ліміт 1 MB для безкоштовних планів.

Worker CORS-проксі (для цифрових підписів)

Інструмент цифрового підпису потребує CORS-проксі для отримання ланцюжків сертифікатів. Розгорніть вбудований worker:

cd cloudflare
npx wrangler login
npx wrangler deploy

Функції безпеки

Функція	Опис
Обмеження URL	Дозволено лише URL сертифікатів
Ліміт розміру файлу	Макс. 10MB на запит
Обмеження частоти	60 запитів/IP/хв (потрібен KV)
Блокування приватних IP	Блокує localhost і внутрішні IP

Увімкнення обмеження частоти

# 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 проксі

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

Або з Docker:

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.