bentopdf/docs/ar/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 تلقائي
• عمليات نشر معاينة لطلبات السحب
• بناء سريع

استكشاف الأخطاء وإصلاحها

رفع الملفات الكبيرة

يدعم 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

ميزات الأمان

الميزة	الوصف
قيود الروابط	يُسمح بروابط الشهادات فقط
حد حجم الملف	حتى 10MB لكل طلب
تحديد المعدل	60 طلبًا/IP/دقيقة (يتطلب KV)
حظر عناوين IP الخاصة	يحظر localhost والعناوين الداخلية

تفعيل تحديد المعدل

# 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

البناء مع رابط الوكيل

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 .

ملاحظة: راجع README لإعداد توقيع HMAC.