5.7 KiB
استقرار روی Cloudflare Pages
Cloudflare Pages میزبانی سریع و جهانی سایت‌های ایستا با پهنای باند نامحدود ارائه می‌دهد.
استقرار سریع
- به Cloudflare Pages بروید
- روی "Create a project" کلیک کنید
- مخزن 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
دامنهٔ سفارشی
- به پروژهٔ Pages خود بروید
- روی "Custom domains" کلیک کنید
- دامنهٔ خود را اضافه کنید
- اگر دامنه روی Cloudflare باشد، Cloudflare به‌طور خودکار DNS را پیکربندی می‌کند
مزایا
- پهنای باند نامحدود رایگان
- CDN جهانی با بیش از ۳۰۰ نقطهٔ لبه
- HTTPS خودکار
- استقرارهای پیش‌نمایش برای pull requestها
- ساخت سریع
عیب‌یابی
بارگذاری فایل‌های بزرگ
Cloudflare Pages از فایل‌هایی تا ۲۵ مگابایت پشتیبانی می‌کند. ماژول‌های WASM باید مشکلی نداشته باشند، اما اگر به محدودیت برخوردید، این را در نظر بگیرید:
# Split large files during build
npm run build
محدودیت اندازهٔ Worker
اگر از Cloudflare Workers برای مسیریابی پیشرفته استفاده می‌کنید، به محدودیت ۱ مگابایت در طرح‌های رایگان توجه کنید.
Worker پراکسی CORS (برای امضاهای دیجیتال)
ابزار امضای دیجیتال برای دریافت زنجیرهٔ گواهی‌ها به یک پراکسی CORS نیاز دارد. worker همراه را مستقر کنید:
cd cloudflare
npx wrangler login
npx wrangler deploy
ویژگی‌های امنیتی
| ویژگی | توضیح |
|---|---|
| محدودیت URL | فقط URLهای گواهی مجاز هستند |
| محدودیت اندازهٔ فایل | حداکثر 10MB برای هر درخواست |
| محدودسازی نرخ | ۶۰ درخواست برای هر 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 را ببینید.