النشر على Cloudflare Pages: انشر بالسحب والإفلات حتى لو كنت لا تعرف Git
هذا هو الدرس رقم 3 في المسار A (صناعة المواقع)، وهو أيضًا أكثر دليل لـ Cloudflare Pages «صداقةً للمبتدئين» على الموقع كله: بلا إنشاء مستودع، بلا تثبيت أدوات، بلا لمس سطر الأوامر؛ اسحب المجلد الذي أنجزته في A1 إلى المتصفح فتحصل على عنوان عام على الإنترنت بصيغة 项目名.pages.dev. تستغرق العملية كلها حوالي 12 دقيقة، والخطة المجانية كافية تمامًا.
- لم يجهز مجلدك بعد؟ عد أولًا إلى A1 اصنع موقعًا بالذكاء الاصطناعي وأنشئ الصفحات
- ما زلت مترددًا بين عدة منصات؟ اطّلع أولًا على A5 مقارنة منصات النشر ثم عد إلى هنا
ماذا ستستطيع أن تفعل بعد التعلم
- سحب مجلد الموقع الذي أنجزته في A1 إلى Cloudflare Pages، دون إنشاء مستودع Git ودون لمس سطر الأوامر، والحصول على عنوان عام على الإنترنت بصيغة
项目名.pages.dev - أن تعرف طرق النشر الثلاث في Cloudflare Pages (السحب والإفلات / سطر أوامر Wrangler / تكامل Git) ولمن يناسب كل منها، وأي طريقتين لا يمكن التحويل بينهما
- التحقق من العنوان بنفسك بعد النشر؛ وعند التعديل تعيد السحب مرة أخرى داخل المشروع نفسه فتنشر إصدارًا جديدًا
- معرفة حدود الخطة المجانية: الملف الواحد 25 ميبيبايت (MiB)، والسحب والإفلات حتى 1,000 ملف في المرة الواحدة، و500 عملية نشر شهريًا
مشكلتك الحالية
- «جرّبت طريقة A2 في إنشاء المستودعات وتوقفت في منتصف الطريق، ألا يمكنني أن أرمي المجلد مباشرة وينتهي الأمر؟»
- «أريد فقط أن أرسل رابط ملف أعمالي إلى دائرة أصدقائي، ولا أريد أن أفهم ما هو Git أولًا من أجل النشر»
- «سمعت أن Cloudflare يتيح استضافة المواقع مجانًا، لكن لوحة التحكم كلها أزرار بالإنجليزية ولا أعرف من أين أبدأ»
متى تستخدم هذه الطريقة
عندما تحتاج إلى:
- نشر الموقع الثابت الذي أنجزته في A1 على الإنترنت والحصول على رابط يمكنك مشاركته
- العمل عبر المتصفح طوال الوقت: نقر + سحب وإفلات، دون تثبيت أي شيء
- النشر مجانًا — تذكر الصفحة الرسمية أن Pages «Available on all plans» (متاح في جميع الخطط)، والخطة المجانية كافية للمواقع الشخصية
ولا تريد:
- أن تتعلم المستودعات وGit أولًا من أجل النشر — فهذا مسار A2 النشر على GitHub Pages
- تشغيل الأوامر داخل مجلد المشروع — فهذا مسار A4 النشر على Vercel
- شراء خادم أو إعداد بيئة أو دراسة سكربتات النشر
🎒 التحضير قبل البدء
- إكمال A1 اصنع موقعًا بالذكاء الاصطناعي: من جملة واحدة إلى صفحة قابلة للنشر، بحيث يكون لديك مجلد صفحات ثابتة
- بريد إلكتروني قادر على استقبال الرسائل لتسجيل حساب Cloudflare
- مجلد الموقع (أو ملف zip الخاص به) في مكان سهل الوصول — السحب والإفلات يدعم كليهما
- كوب من الماء ☕
الفكرة الأساسية
Cloudflare Pages هي خدمة استضافة مواقع من Cloudflare: تسلّمها ملفات موقعك فتنشر الموقع على شبكة Cloudflare العالمية. المواقع الثابتة البحتة (وهي ناتج A1) يمكن نشرها بمجرد رفع الملفات.
هناك ثلاث طرق لتسليم الملفات، وهذا الدرس يسلك الطريقة الأولى:
| طريقة الرفع | ماذا يجب أن تعرف | الميزة | لمن يناسب |
|---|---|---|---|
| السحب والإفلات (Direct Upload، محور هذا الدرس) | سحب الملفات في المتصفح | تحصل على العنوان فورًا 项目名.pages.dev | أنت الذي لا يريد إطلاقًا لمس سطر الأوامر وGit |
| سطر أوامر Wrangler | أمرا npm اثنان | العنوان نفسه مع حد أعلى لعدد الملفات | من يستعد لفتح الطرفية لكنه لا يريد تعلم Git |
| تكامل Git | GitHub/GitLab + push | بناء ونشر تلقائيان مع كل push | من يعرف Git بالفعل ويحتاج إلى تعديلات متكررة |
جملة واحدة لتذكر Direct Upload: ما يُرفع هو «ملفات جاهزة». المنصة لا تبني مشروعك — ما ترفعه هو ما يُنشر، لذا يجب أن تكون الملفات في شكلها النهائي قبل الرفع. والصفحات الثابتة البحتة التي كتبها الذكاء الاصطناعي في A1 هي كذلك تمامًا.
⚠️ فكّر جيدًا قبل اختيار الطريق: الطريقان متعارضان
- المشاريع التي استخدمت تكامل Git لا يمكن تحويلها لاحقًا إلى Direct Upload — الوثائق الرسمية تنص على هذا القيد صراحة
- والمشاريع التي اخترت Direct Upload لا يمكن تحويلها لاحقًا إلى تكامل Git أيضًا؛ وإذا أردت يومًا النشر التلقائي عبر push فلا مفر من إنشاء مشروع جديد
- الخبر الجيد: داخل مشروع Direct Upload نفسه يمكنك التبديل بحرية بين طريقتي الرفع: السحب والإفلات وWrangler
💡 الشركة الرسمية تروّج لـ Workers، ولا داعي لأن تشغل بالك بها الآن
تذكر وثائق Cloudflare الرسمية حاليًا في أعلى صفحة Pages أن Workers يدعم معظم حالات استخدام Pages وأن ميزاته أكمل، وتنصح بأن تبدأ المشاريع الجديدة من Workers. Workers هي منصة التطوير الرئيسية لدى Cloudflare وتناسب التطبيقات المتكاملة (full-stack) ذات الواجهة الخلفية؛ لكن لنشر موقع ثابت دون أي خبرة سابقة، يظل الرفع بالسحب والإفلات في Pages هو المسار الأكثر مباشرة — فلا تحتاج إلى تثبيت أي شيء. وعندما تريد لاحقًا بناء تطبيق متكامل، لن يكون الوقت متأخرًا لتتعرف على Workers.
اتبع خطواتي
بخمس خطوات سيصبح لموقعك عنوان على الإنترنت. يستخدم المثال «ملف أعمال التصوير» من A1، ويمكنك استبداله بموضوعك الخاص وتنفيذ الخطوات نفسها.
الخطوة 1: تحقق من مجلد الموقع وتأكد من سحب «الطبقة الصحيحة»
لماذا: Direct Upload لا يقوم بالبناء نيابة عنك، ومحتوى مجلد الرفع هو محتوى الجذر للموقع — إضافة طبقة مجلد إضافية تعني أن الصفحة الرئيسية لن تكون في الطبقة الأولى من العنوان.
افتح مجلد مشروع A1 وألقِ نظرة: يجب أن تكون هذه الملفات مباشرة في الطبقة الأولى:
index.html ← الصفحة الرئيسية، يجب أن تكون في الطبقة الأولى
style.css
script.js
images/يجب أن ترى: index.html موجود مباشرة في الطبقة الأولى من المجلد، والنقر المزدوج عليه يفتح صفحتك في المتصفح.
يمكنك سحب ملف zip أيضًا — الوثائق الرسمية تنص على أن السحب يدعم «ملف zip واحد» أو «مجلد واحد». إذا أردت الضغط فاضغط هذه الطبقة، ولا تضم المجلد الأعلى منها معها.
- ترى
index.htmlمباشرة في الطبقة الأولى من المجلد (أو ملف zip)
الخطوة 2: سجّل حساب Cloudflare وادخل إلى Workers & Pages
لماذا: تُنشأ مشاريع Pages وتُدار جميعها من صفحة Workers & Pages في لوحة التحكم.
الخطوات: افتح dash.cloudflare.com في المتصفح وسجّل ثم سجّل الدخول (الخطة المجانية تكفي، فـ Pages متاح في جميع الخطط)، وابحث في لوحة التحكم عن صفحة Workers & Pages وادخل إليها.
يجب أن ترى: صفحة Workers & Pages، وزر Create application (إنشاء تطبيق).
- ترى زر Create application
الخطوة 3: أنشئ التطبيق واسحب المجلد إليه — الخطوة الجوهرية في درس Cloudflare Pages
لماذا: اسم المشروع يحدد بادئة عنوان موقعك، فبمجرد إدخاله هنا يُثبّت العنوان.
اتبع المسار الرسمي: Workers & Pages ← Create application ← Get started ← Drag and drop your files.
أدخل اسمًا في حقل اسم المشروع (مثل my-photo-site)، ثم اسحب المجلد أو ملف zip إلى مربع الرفع.
يجب أن ترى: بدء رفع الملفات، وظهور أسماء الملفات مثل index.html في القائمة دون أي تحذير أحمر.
💡 اسم المشروع = بادئة العنوان
عنوان موقعك هو 项目名.pages.dev. توضح الوثائق الرسمية: إذا كان اسم المشروع محجوزًا، فستضيف Cloudflare تلقائيًا بعض الأحرف العشوائية — للحفاظ على عنوان نظيف، أدخل اسمًا يصعب تكراره من البداية.
- أُنشئ المشروع، ولا توجد تحذيرات حمراء في قائمة الرفع
الخطوة 4: اضغط Deploy site واحصل على عنوان pages.dev
لماذا: بعد الرفع تبقى خطوة «النشر»، فبعد اكتمال النشر فقط يصبح لديك عنوان عام على الإنترنت.
الخطوات: بعد اكتمال الرفع اختر Deploy site (قد تظهر هذه الخطوة في الواجهة أيضًا باسم Save and Deploy، والضغط عليها هو الصحيح)، وانتظر حتى ينتهي التقدم.
يجب أن ترى: اكتمال النشر وظهور عنوان موقعك https://项目名.pages.dev؛ وبالمتابعة إلى لوحة المشروع (continue to your newly deployed project) يمكنك رؤية حالة النشر والعنوان.
- ظهر
https://项目名.pages.dev
الخطوة 5: افتح العنوان للفحص وتعلّم تحديث النسخة الجديدة
لماذا: قبل الإطلاق يجب أن تتفحصه بنفسك أولًا — انضباط 3.4 فحص القبول ينطبق أيضًا على الموقع الذي أُطلق للتو.
الخطوات: افتح https://项目名.pages.dev في متصفح الحاسوب، وراجع كل جزء مقابل قائمة هيكل A1؛ ثم أرسل الرابط إلى هاتفك وافتحه هناك.
يجب أن ترى: صفحتك تُفتح بشكل سليم على الهاتف والحاسوب، ولا تتشوه على الشاشات الضيقة.
ماذا تفعل عند التعديل لاحقًا؟ اجعل الذكاء الاصطناعي يعدّل الملفات، ثم ارجع إلى صفحة Workers & Pages لهذا المشروع واختر Create a new deployment، واختر بيئة الإنتاج (production)، واسحب المجلد الجديد مرة أخرى — فتصبح النسخة الجديدة على الإنترنت. ولن تُفقد النسخة القديمة: يدعم Pages التراجع (Rollbacks) للعودة بنقرة واحدة إلى نسخة الإنتاج السابقة.
يجب أن ترى: النسخة الجديدة تحل محل القديمة، والعنوان لا يتغير.
- فتحت عنوانك على الهاتف والحاسوب
نقاط الفحص ✅
- الطبقة الأولى من المجلد (أو ملف zip) هي مباشرة
index.html - أنشأت المشروع من خلال Workers & Pages ← Create application → Get started → Drag and drop your files
- اكتمل النشر، و
https://项目名.pages.devيفتح صفحتك الرئيسية - يُفتح بشكل سليم على الهاتف أيضًا
- تعرف أنه بعد التعديل يمكن التحديث بسحب المجلد مرة أخرى عبر Create a new deployment
تنبيهات للمزالق
❌ سحبت طبقة المجلد الخاطئة
العَرَض: نجح النشر، لكنك لا ترى صفحتك الرئيسية عند فتح العنوان.
السبب: محتوى مجلد الرفع هو محتوى الجذر للموقع — إذا وضعت مجلد الموقع داخل مجلد جديد إضافي ثم سحبته (أو ضمّ ملف zip طبقة زائدة)، فلن يكون index.html في الجذر.
الطريقة الصحيحة: افتح المجلد وتحقق قبل الضغط أو السحب — يجب أن تكون الطبقة الأولى مباشرة index.html. وإذا رفعت الخطأ فلا داعي لحذف المشروع، استخدم Create a new deployment وأعد السحب بالمجلد الصحيح.
❌ تجاوز حدود الملفات: ملف واحد 25 MiB، وسحب حتى 1,000 ملف في المرة
العَرَض: أثناء الرفع يظهر رمز تحذير أحمر بجانب بعض الملفات، ولم يُرفع ذلك الملف.
السبب: تجاوز حدود الرفع المباشر — الوثائق الرسمية تنص على أن الملف الذي يتجاوز 25 MiB يظهر له تحذير أحمر؛ والسحب يقبل حتى 1,000 ملف في المرة؛ أما Wrangler فحدوده أوسع (20,000 ملف، وبحد 25 MiB للملف الواحد كذلك).
الطريقة الصحيحة: تنص الوثائق الرسمية على أنه يمكن حذف الأصول ذات التحذير الأحمر، لكن لا يمكن استبدالها في مكانها، وإنما يجب إعادة رفع الموقع كاملًا. لذا: اضغط الصور قبل رفعها؛ وإذا تجاوز عدد الملفات 1,000 فاستخدم Wrangler (انظر نصائح متقدمة أدناه). الخطة المجانية تتيح 500 عملية نشر شهريًا، فنظّف الملفات قبل إعادة الرفع.
❌ نجح النشر، لكن فتح العنوان يعطي خطأ DNS
العَرَض: اكتمل النشر بالفعل، لكن المتصفح لا يفتح العنوان ويظهر خطأ DNS.
السبب: تذكر الوثائق الرسمية أنه بعد النشر الأول قد لا يكون DNS قد سري بعد (الانتشار يحتاج وقتًا).
الطريقة الصحيحة: انتظر بضع دقائق ثم حدّث الصفحة، أو جرّب جهازًا آخر أو شبكة أخرى (مثل بيانات الهاتف) ثم افتح.
❌ أنشأت عدة مشاريع متتالية فور التسجيل فتم إيقافك
الظاهرة: بعد إنشاء المشروع الأول للتو، يتم تقييدك فورًا عند محاولة إنشاء مشروع جديد.
السبب: لدى Cloudflare قيود ضد إساءة الاستخدام للحسابات الجديدة — خلال أول 48 ساعة من استخدام الخدمة يُقيد عدد مشاريع Pages الجديدة التي يمكن إنشاؤها، ثم يُرفع القيد تلقائيًا؛ كما أن الحد الأقصى لكل حساب هو 100 مشروعًا.
الطريقة الصحيحة: أكمل مشروعًا واحدًا بنجاح اليوم؛ وإذا احتجت فعلًا إلى عدة مشاريع فعُد بعد 48 ساعة.
نصائح متقدمة (اختياري)
🔧 الإطلاق بأمرين من Wrangler (اختياري)
مستعد لفتح الطرفية لكن لا تريد تعلم Git؟ أداة سطر الأوامر الرسمية Wrangler تستخدم Direct Upload أيضًا، وهي من نفس مسار السحب ويمكن المزج بينهما في أي وقت:
npx wrangler pages project create
npx wrangler pages deploy <BUILD_OUTPUT_DIRECTORY>- الأمر الأول سيطلب منك اسم المشروع وفرع الإنتاج، ثم يُخزّن في
node_modules/.cache/wrangler، فلا تحتاج لإدخالهما في عمليات النشر اللاحقة - استبدل
<BUILD_OUTPUT_DIRECTORY>بمسار مجلدك؛ فموقع A1 الثابت تمامًا يُرفع فيه مجلد المشروع نفسه - يدعم Wrangler المجلدات فقط، ولا يدعم ملفات zip (السحب والإفلات يدعم كليهما)
- لإرسال بيئة معاينة: أضف
--branch=<分支名>، فتحصل على分支名.项目名.pages.dev - الحد الأقصى لعدد الملفات 20,000 (السحب والإفلات 1,000)؛ مجلد
functionsلا يمكن تجميعه ورفعه إلا عبر Wrangler، والسحب والإفلات لا يدعمه (ملف_worker.jsالمنفرد مدعوم بالطريقتين) - المتطلب الأساسي: تثبيت npm على جهازك (توصي الوثائق الرسمية بتثبيت npm أولًا ثم Wrangler)؛ عند الاستخدام الأول شغّل
npx wrangler loginلتسجيل الدخول، ثم نفّذ الأوامر التالية
🔧 تعرفت على Git؟ اجعل كل push ينشر تلقائيًا (اختياري)
هذا هو تكامل Git المتعارض مع السحب والإفلات، اضغط حتى النهاية: Workers & Pages ← Create application ← Pages ← Connect to Git، وافترض GitHub أو GitLab ← اختر المستودع (الخاص والعام كلاهما مدعوم) ← اضبط البناء: اسم المشروع (افتراضيًا نفس اسم المستودع)، فرع الإنتاج (عادة main)، إذا لم يكن هناك إطار عمل فاترك Build command فارغًا، مجلد مخرجات البناء ← Save and Deploy.
بعد ذلك كل push يبني وينشر تلقائيًا؛ الفروع غير الإنتاجية تولّد نشرات معاينة تلقائيًا (分支名.项目名.pages.dev). تنبيه: إذا أنشأت مشروع رفع مباشر من قبل وتريد التحول إلى هذه الطريقة، فالخيار الوحيد هو إنشاء مشروع جديد — قاعدة التعارض موضحة في الفكرة الأساسية أعلاه.
🔧 تريد نطاقك الخاص؟ (اختياري)
pages.dev هو نطاق فرعي تقدمه المنصة مجانًا، ولمظهر أكثر رسمية يمكنك ربط نطاق اشتريته بنفسك: الخطة المجانية تسمح لكل مشروع بربط 100 نطاق مخصص. للطريقة العامة لتحليل النطاق وربطه، راجع 5.3 النطاقات المخصصة.
نقطة انتباه خاصة بـ Cloudflare: تنبه الوثائق الرسمية إلى أنه قبل حذف مشروع يحمل نطاقًا مخصصًا، يجب أولًا حذف سجل CNAME المقابل، وإلا سيشير النطاق إلى مشروع لم يعد موجودًا.
خلاصة هذا الدرس
✅ أكملت مسار النشر بالسحب والإفلات في هذا الدرس عن Cloudflare Pages:
- تحقق من المجلد: الطبقة الأولى تحتوي مباشرة على
index.html، ويمكن سحب مجلد أو ملف zip - أنشئ المشروع: Workers & Pages ← Create application ← Get started ← Drag and drop your files، واسم المشروع هو بادئة الرابط
- انشر: Deploy site ← تحصل على
https://项目名.pages.dev - تحقق: افتح الموقع على الهاتف والكمبيوتر معًا
- حدّث: Create a new deployment واسحب مرة أخرى؛ داخل نفس مشروع الرفع المباشر يمكنك التبديل بحرية بين السحب والإفلات وWrangler، لكنه يتعارض مع تكامل Git
| المرحلة | العمليات الأساسية | ما يجب تذكره |
|---|---|---|
| التحضير | تحقق من الطبقة الأولى للمجلد | محتوى مجلد الرفع = المجلد الجذري للموقع |
| الإنشاء | Create application ← مدخل السحب والإفلات | اسم المشروع يحدد بادئة pages.dev |
| النشر | Deploy site | الملف المنفرد ≤ 25 MiB، والسحب والإفلات ≤ 1,000 ملف في المرة |
| التحقق | الفتح على الهاتف + الكمبيوتر | عند أول ظهور لخطأ DNS، انتظر بضع دقائق |
| التحديث | Create a new deployment | الخطة المجانية 500 نشر شهريًا، ويمكن التراجع إلى الإصدارات السابقة |
للمقارنة الكاملة بين الحصص والقيود المجانية لـ GitHub Pages وCloudflare Pages وVercel، راجع A5 مقارنة منصات النشر في صفحة واحدة.
الدرس التالي
في الدرس التالي A4 النشر عبر Vercel: نشر بأمر واحد لوكلاء البرمجة بالذكاء الاصطناعي، سننتقل إلى فلسفة نشر مختلفة: اكتب أمرًا واحدًا داخل مجلد المشروع، ومن البناء إلى النشر كل شيء تلقائي. ستتعلم:
- تثبيت Node.js 18+ وVercel CLI، و
vercel loginتسجيل دخول واحد vercel --prodأمر واحد يُنجز نشر الإنتاج- ماذا يعني «التعرف التلقائي على الإطار من CLI»، وماذا يعني لموقعك الثابت
- الخطة المجانية Vercel Hobby تحظر الاستخدام التجاري، اعرف ذلك قبل اختيارها
عندما تكون جاهزًا أبقِ المجلد في متناول يدك، وانتقل إلى A4 ←