mirror of
https://github.com/alam00000/bentopdf.git
synced 2026-11-05 11:52:48 +01:00
155 lines
5.7 KiB
Markdown
155 lines
5.7 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 باشد، Cloudflare به‌طور خودکار DNS را پیکربندی می‌کند
|
|
|
|
## مزایا
|
|
|
|
- **پهنای باند نامحدود رایگان**
|
|
- **CDN جهانی** با بیش از ۳۰۰ نقطهٔ لبه
|
|
- **HTTPS خودکار**
|
|
- **استقرارهای پیش‌نمایش** برای pull requestها
|
|
- **ساخت سریع**
|
|
|
|
## عیب‌یابی
|
|
|
|
### بارگذاری فایل‌های بزرگ
|
|
|
|
Cloudflare Pages از فایل‌هایی تا ۲۵ مگابایت پشتیبانی می‌کند. ماژول‌های WASM باید مشکلی نداشته باشند، اما اگر به محدودیت برخوردید، این را در نظر بگیرید:
|
|
|
|
```bash
|
|
# Split large files during build
|
|
npm run build
|
|
```
|
|
|
|
### محدودیت اندازهٔ Worker
|
|
|
|
اگر از Cloudflare Workers برای مسیریابی پیشرفته استفاده می‌کنید، به محدودیت ۱ مگابایت در طرح‌های رایگان توجه کنید.
|
|
|
|
## Worker پراکسی CORS (برای امضاهای دیجیتال)
|
|
|
|
ابزار امضای دیجیتال برای دریافت زنجیرهٔ گواهی‌ها به یک پراکسی CORS نیاز دارد. worker همراه را مستقر کنید:
|
|
|
|
```bash
|
|
cd cloudflare
|
|
npx wrangler login
|
|
npx wrangler deploy
|
|
```
|
|
|
|
### ویژگی‌های امنیتی
|
|
|
|
| ویژگی | توضیح |
|
|
| ------------------------ | ------------------------------------------- |
|
|
| **محدودیت URL** | فقط URLهای گواهی مجاز هستند |
|
|
| **محدودیت اندازهٔ فایل** | حداکثر 10MB برای هر درخواست |
|
|
| **محدودسازی نرخ** | ۶۰ درخواست برای هر 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) را ببینید.
|