Skip to content

النشر على Vercel: النشر بأمر واحد عبر وكيل برمجة بالذكاء الاصطناعي ​

💡 الخلاصة في جملة واحدة: أقصر طريق للنشر على Vercel — npm i -g vercel تثبيت مرة واحدة، vercel login تسجيل دخول مرة واحدة، وبعدها كل إصدار جديد لا يتعدى أمرًا واحدًا؛ بل يمكن تسليم هذه الأوامر كلها ككتلة واحدة إلى وكيل البرمجة بالذكاء الاصطناعي لتشغيلها نيابة عنك.

عند البحث عن «درس النشر على Vercel» تكون النتائج غالبًا وثائق إنجليزية أصلية، تشرح من التسجيل إلى إنشاء المشروع إلى ربط المستودع، وكثرة الخطوات تجعل التعثر في منتصف الطريق سهلًا. يختصر هذا الدرس بالصينية المسار: مجلد محلي + بضعة أوامر، وفي نحو عشر دقائق ترفع الصفحة التي أنجزها الذكاء الاصطناعي إلى الإنترنت — بل إنك، إن كنت تستخدم وكيل برمجة بالذكاء الاصطناعي، يمكنك أن تدع الوكيل يشغّل هذه الأوامر كلها نيابة عنك.

هذا هو الدرس 4 من المسار A في السيناريوهات التطبيقية (إنشاء المواقع)، وهو أيضًا آخر مسارات الرفع الثلاثة: A2 GitHub Pages عبر معالج الويب، وA3 Cloudflare Pages عبر السحب والإفلات، بينما Vercel في هذا الدرس يعتمد على سطر الأوامر — وهو عادةً الأنسب لمن يكتب الشيفرة بواسطة وكيل ذكاء اصطناعي.

ماذا ستستطيع فعله بعد إتمام الدرس ​

  • تثبيت Vercel CLI وتسجيل الدخول: npm i -g vercel + vercel login (بشرط Node.js 18+)
  • تشغيل أمر vercel واحد في مجلد المشروع لإتمام النشر، ثم استخدام vercel --prod لإصدار النسخة الرسمية التي يراها الجميع
  • تسليم عملية النشر كاملة إلى وكيل البرمجة بالذكاء الاصطناعي: أرسل موجزًا واحدًا، فيشغّل الأوامر عنك ويعيد لك الرابط الإلكتروني
  • معرفة حدود خطة Hobby المجانية: 100 غيغابايت نقل بيانات شهريًا، و100 عملية نشر يوميًا، و200 مشروعًا، وباستخدام شخصي غير تجاري فقط

المأزق الذي أنت فيه الآن ​

  • «أعد الذكاء الاصطناعي ملفات الصفحة كلها عني، لكن عند البحث عن النشر لا أجد إلا وثائق إنجليزية، ومصطلحات مثل CLI وbuild وdeploy كثيرة تسبب الصداع بمجرد رؤيتها»
  • «GitHub Pages يتطلب إنشاء مستودع، وCloudflare يتطلب الدخول إلى لوحة التحكم للبحث عن المدخل، ألا توجد طريقة رفع أسهل؟»
  • «وكيل الذكاء الاصطناعي يجيد تشغيل أوامر الطرفية أصلًا، فلماذا يجب أن أنفذ خطوة الرفع يدويًا أمرًا بعد أمر؟»

متى تستخدم هذه الطريقة ​

عندما تحتاج إلى:

  • أسرع طريقة لرفع الصفحات الثابتة في ذلك المجلد المحلي إلى الإنترنت والحصول على رابط قابل للمشاركة
  • أن تكون كل عملية إعادة نشر بعد أي تعديل لاحق مجرد أمر واحد
  • أن يتولى وكيل البرمجة بالذكاء الاصطناعي كل شيء — فتشغيل أوامر الطرفية هو نقطة قوته أصلًا

ولا تريد:

  • إنشاء مستودع Git أو إدارة الفروع (سير العمل الرسمي لـ Vercel CLI لا يمر عبر المستودع)
  • تعبئة إعدادات البناء بندًا بندًا في نماذج لوحة التحكم

🎒 التحضيرات قبل البدء ​

  • إكمال A1 إنشاء موقع بالذكاء الاصطناعي: وجود مجلد محلي يحتوي صفحات ثابتة (مخرجات A1، والمدخل عادةً index.html)
  • التسجيل في حساب Vercel (التسجيل مجاني على الموقع الرسمي، والخطة الافتراضية للاستخدام الشخصي هي خطة Hobby المجانية)
  • تثبيت Node.js 18 أو أحدث على الحاسوب (تشترط Vercel رسميًا Node.js 18+، ويمكن تنزيله وتثبيته من nodejs.org)

المتطلبات الأساسية للنظام ​

العنصرالمتطلب
Node.js18 أو أحدث
مدير الحزمnpm / pnpm / yarn / bun أي منها
الحسابحساب Vercel (خطة Hobby مجانية)
المشروعمجلد المشروع المحلي (الصفحات الثابتة الناتجة عن A1)

الفكرة الأساسية ​

سير العمل الرسمي لدى Vercel يبدأ من CLI: تثبيت مرة واحدة، وتسجيل دخول مرة واحدة، وبعدها كل نشر لا يتعدى أمرًا واحدًا. يكتشف CLI تلقائيًا إطار العمل الذي يستخدمه مشروعك، ثم يبني وينشر — فلا تحتاج إلى تعبئة أمر البناء ولا إلى اختيار مجلد المخرجات.

ينقسم النشر إلى مستويين، والفرق بين الأمرين معامل واحد فقط:

  • vercel: نشر معاين، يعطيك بعد الانتهاء رابط معاينة لتطّلع على النتيجة بنفسك أولًا
  • vercel --prod: نشر إنتاجي، النسخة الرسمية التي تُعرض على الجميع

طريقتان للرفع، اختر واحدة ​

المقارنةالطريقة A: أمر واحد عبر CLI (المسار الرئيسي لهذا الدرس)الطريقة B: ربط Git من لوحة التحكم
مكان التنفيذالطرفيةلوحة التحكم في المتصفح
هل يلزم مستودعسير العمل الرسمي لا يمر عبر مستودع Git، النشر مباشرة من المجلد المحلييجب أن تكون الشيفرة في مستودع GitHub / GitLab / Bitbucket
أول رفعvercel + vercel --prod أمراناختيار المستودع في صفحة New Project والنقر على Deploy
التحديثات اللاحقةتشغيل vercel --prod مرة أخرىكل عملية push تُطلق نشرًا جديدًا تلقائيًا
لمن يصلح هذاتستخدم وكلاء برمجة بالذكاء الاصطناعي وتريد أسرع طريق للنشرتعرف Git بالفعل وتريد «النشر بمجرد الدفع»

كم حصة يمنحك خطة Hobby المجانية ​

التسجيل المجاني يستخدم خطة Hobby، وحصة vercel المجانية تعتمد أساسًا على هذه البنود:

البندالحصة المجانية في Hobby
عدد المشاريع200 مشروعًا
عدد عمليات النشر100 عملية يوميًا
حركة البيانات (Fast Data Transfer)100 GB شهريًا
النطاقات المخصصة لكل مشروع50 نطاقًا
استدعاءات الدوال (Function Invocations)1,000,000 استدعاء شهريًا
تحويلات الصور (Image Transformations)5,000 تحويلًا شهريًا
عواقب تجاوز الحصةيجب انتظار 30 يومًا لاستعادة معظم الميزات (يتوقف Web Analytics ويمكن استعادته بعد 7 أيام)

لمواقع مثل الصفحة الشخصية ومعرض الأعمال، حصة 100 GB/شهر أكثر من كافية.

⚠️ لا يجوز استخدام خطة Hobby لأغراض تجارية

تنص شروط الاستخدام العادل لخطة Hobby على: مقتصرة على الاستخدام غير التجاري والشخصي. للمواقع الرسمية للشركات ومشاريع العملاء، يُرجى الترقية إلى Pro (بمقعد $20/مستخدم/شهر للمطورين)، أو الاطلاع على A5 مقارنة منصات النشر لتغيير المنصة.

اتبع خطواتي ​

الخطوة 1: تثبيت Vercel CLI (أمر عام واحد) ​

لماذا: تقول Vercel رسميًا إن «كل سير عمل يبدأ من CLI» — حتى وكلاء الذكاء الاصطناعي ينشرون المشاريع باستخدامه.

الطريقة الموصى بها (npm مضمّن تلقائيًا إذا كان Node مثبتًا لديك):

bash
npm i -g vercel

للقراء الذين يستخدمون بالفعل pnpm / yarn / bun، اختر واحدًا من الأربعة:

bash
pnpm i -g vercel
yarn global add vercel
bun add -g vercel

يجب أن ترى: اكتمال سجل التثبيت وعودة الطرفية إلى موجه الأوامر، دون أي أخطاء حمراء.

  • فحص صغير: لا أخطاء أثناء التثبيت (خطوة تسجيل الدخول التالية ستكشف فورًا ما إذا كان التثبيت نجح)

الخطوة 2: تسجيل الدخول إلى حسابك في Vercel (vercel login) ​

لماذا: قبل النشر يجب ربط CLI بحسابك في Vercel حتى تُسجَّل عمليات النشر اللاحقة ضمن مشروعك.

bash
vercel login

يجب أن ترى: يعرض CLI تعليمات المصادقة، اتبعها لإكمال المصادقة مع حساب Vercel، ثم تعود الطرفية لتعرض نجاح تسجيل الدخول.

  • فحص صغير: تؤكد الطرفية تسجيل الدخول إلى حسابك

الخطوة 3: تشغيل الأمر الأساسي في درس النشر على Vercel (vercel) ​

لماذا: هذا الأمر الواحد هو بطل درس النشر على Vercel بأكمله — يكتشف CLI الإطار تلقائيًا، ويبني المشروع، ويكمل النشر، كل ذلك في أمر واحد.

الخطوات: ادخل أولًا إلى مجلد مشروعك (الدليل الذي أنشأ فيه الذكاء الاصطناعي الصفحات في A1)، ثم شغّل:

bash
vercel

يجب أن ترى: يكتشف CLI الإطار ← البناء ← النشر في سلسلة واحدة، ويعطيك في النهاية رابط معاينة؛ افتحه بالمتصفح وستجد صفحتك متاحة على الإنترنت.

  • فحص صغير: رابط المعاينة يفتح صفحتك في المتصفح

الخطوة 4: نشر النسخة الإنتاجية (vercel --prod) ​

لماذا: ما نتج عن vercel في الخطوة 3 هو نشر معاينة؛ أما النسخة الرسمية للزوار فتتطلب تشغيل أمر إضافي.

bash
vercel --prod

يجب أن ترى: اكتمال عملية بناء ونشر أخرى، وهذه المرة تحصل على رابط الإنتاج — استخدمه للمشاركة مع الأصدقاء أو طباعته على بطاقة العمل (عنوان على الإنترنت ضمن نطاق vercel.app).

  • فحص صغير: رابط الإنتاج يعمل ومحتوى الصفحة مطابق للمعاينة

الخطوة 5: تسليم عملية النشر بأكملها إلى وكيل برمجة بالذكاء الاصطناعي (موصى به) ​

لماذا: الخطوات الأربع السابقة كلها أوامر طرفية، وتشغيل أوامر الطرفية هو بالضبط ما يبرع فيه وكيل البرمجة بالذكاء الاصطناعي. تقدم Vercel رسميًا في وثائق Getting started مقطع «Agent prompt» — يُطلب من الوكيل تثبيت CLI وتسجيل الدخول والنشر وإرجاع الرابط كلها في تشغيلة واحدة.

الخطوات: افتح وكيل البرمجة بالذكاء الاصطناعي في مجلد مشروعك، وأرسل له النص التالي:

text
ساعدني في النشر على Vercel:
1. ثبّت Vercel CLI عالميًا (npm i -g vercel)، وسجّل الدخول باستخدام vercel login.
2. شغّل vercel في مجلد المشروع الحالي لإكمال النشر، وأرسل لي رابط المعاينة.
3. اقترح الخطوة التالية بناءً على مشروعي، مثل ربط نطاق مخصص أو إعداد متغيرات البيئة.

يجب أن ترى: يشغّل الوكيل نيابةً عنك أوامر الخطوات 1–4، وأخيرًا يلصق الرابط المباشر في المحادثة.

لم تثبّت وكيل برمجة بالذكاء الاصطناعي بعد؟ ارجع إلى 1.5 تثبيت Claude Code؛ وإن أردت نسخة سطح المكتب، راجع 1.5b طرق التثبيت البديلة.

💡 هناك أيضًا «ثلاثية» رسمية

جهّزت Vercel لوكلاء الذكاء الاصطناعي ثلاثية Plugin / Skills / MCP، تمكّن الوكيل من الاطلاع مباشرة على الوثائق الرسمية وإدارة المشاريع والنشر — هذه الاستخدامات المتقدمة تُشرح بالتفصيل في 5.2 Vercel × سلسلة أدوات الذكاء الاصطناعي.

الطريقة B: بدون سطر الأوامر، النشر عبر ربط Git من لوحة التحكم ​

المتطلب المسبق: دُفعت ملفات الصفحات بالفعل إلى مستودع GitHub / GitLab / Bitbucket (إذا أنشأت مستودعًا في A2 GitHub Pages فأعد استخدامه مباشرة).

  1. افتح صفحة New Project في لوحة تحكم Vercel
  2. اربط حسابك في GitHub / GitLab / Bitbucket
  3. اختر مستودعًا واضغط Deploy

يجب أن ترى: الحصول على العنوان المباشر بعد اكتمال النشر؛ وبعد ذلك كل دفعة (push) إلى الفرع المرتبط تُطلق تلقائيًا نشرًا جديدًا.

نقاط تحقق ✅ ​

  • npm i -g vercel التثبيت بلا أخطاء، وvercel login يعرض تسجيل الدخول
  • تشغيل vercel في مجلد المشروع يمنحك رابط معاينة يفتح في المتصفح
  • vercel --prod بعدها يعمل رابط الإنتاج
  • تستطيع ذكر حدود خطة Hobby الثلاثة: 100 عملية نشر يوميًا، و100 GB حركة بيانات شهريًا، ومقتصرة على الاستخدام الشخصي غير التجاري
  • تعرف عواقب تجاوز الحصة: يجب انتظار 30 يومًا لاستعادة معظم الميزات

تنبيهات للمزالق ​

❌ المزلق 1: إصدار Node.js أقل من 18 ​

الظاهرة: ظهور أخطاء عند تثبيت CLI أو تشغيله. السبب: تشترط Vercel CLI رسميًا إصدار Node.js 18 أو أحدث. الحل الصحيح: تأكد أولًا أن إصدار Node لا يقل عن 18 (وإن كان أقدم فثبّت الإصدار الجديد من nodejs.org)، ثم أعد تشغيل npm i -g vercel.

❌ المزلق 2: إرسال الرابط كعنوان رسمي فور تشغيل vercel ​

الظاهرة: الرابط المُرسل هو نشر معاينة، وليس النسخة الرسمية. السبب: ينشئ vercel نشر معاينة، أما النشر للعامة فيتطلب نشر الإنتاج عبر vercel --prod. الحل الصحيح: استخدم رابط المعاينة لمراجعة عملك بنفسك، واستخدم رابط الإنتاج من vercel --prod للمشاركة مع الآخرين.

❌ المزلق 3: نشر مشروع تجاري على خطة Hobby المجانية ​

الظاهرة: إطلاق موقع شركة أو عمل لعميل على خطة Hobby لا يتوافق مع قواعد المنصة. السبب: تنص شروط الاستخدام العادل لخطة Hobby على «الاقتصار على الاستخدام غير التجاري والشخصي». الطريقة الصحيحة: للمشاريع التجارية، قم بالترقية إلى Pro (مقعد المطور $20/مستخدم/شهر)، أو راجع A5 مقارنة منصات النشر لتغيير المنصة.

❌ فخ 4: الظن بأن تجاوز الحد سيُستعاد في اليوم التالي ​

الظاهرة: تجاوز حركة المرور أو عدد مرات النشر، فتُعلَّق الوظائف ذات الصلة. السبب: بعد تجاوز الحد في خطة Hobby، تحتاج معظم الوظائف إلى الانتظار 30 يومًا قبل إعادة استخدامها (Web Analytics استثناء، إذ يمكن استعادتها بعد التعليق لمدة 7 أيام). الطريقة الصحيحة: راقب الاستخدام بعد الإطلاق؛ المواقع الشخصية عادةً لا تصل إلى الحد الأقصى، أما المشاريع ذات الحركة المرتفعة فخطط مسبقًا لـ Pro أو منصة أخرى.

نصائح متقدمة ​

  • إضافة قاعدة بيانات بنقرة واحدة: مشروعك يحتاج إلى تخزين البيانات؟ vercel install neon (أو upstash، supabase) يمكنه تثبيت تكاملات Marketplace مباشرة من CLI، وسيكتب Vercel بيانات الاعتماد تلقائيًا في .env.local الخاص بمشروعك.
  • ربط نطاقك الخاص: لا تريد لاحقة vercel.app؟ توثيق Vercel الرسمي يتضمن دليل "Add a custom domain"، وللطريقة العامة راجع 5.3 النطاق المخصص.
  • جعل الوكيل يتولى الأمور بعمق: بتثبيت Plugin / Skills / MCP الخاص بـ Vercel، يستطيع وكيل الذكاء الاصطناعي الاطلاع على التوثيق الرسمي وإدارة المشاريع والنشر، راجع 5.2 Vercel × سلسلة أدوات الذكاء الاصطناعي.

خلاصة هذا الدرس ​

✅ أقصر مسار في هذا الدرس حول النشر على Vercel:

  • npm i -g vercel → vercel login → vercel → vercel --prod، أربعة أوامر تأخذك من التثبيت إلى الإطلاق
  • vercel ينتج معاينة، وvercel --prod ينتج نسخة الإنتاج، استخدم الأخير للمشاركة الخارجية
  • يمكنك تجنب سطر الأوامر: اربط مستودع Git عبر صفحة New Project في لوحة التحكم، وبعدها يُنشر تلقائيًا مع كل push
  • خطة Hobby المجانية: 200 مشروعًا / 100 عملية نشر يوميًا / 100 GB حركة مرور شهريًا / 50 نطاقًا لكل مشروع، للاستخدام الشخصي غير التجاري فقط
  • يمكن حزم العملية بأكملها في موجه واحد يُسلَّم لوكيل برمجة بالذكاء الاصطناعي لتنفيذه
الأمرالوظيفةمتى يُستخدم
npm i -g vercelتثبيت Vercel CLI عالميًامرة واحدة فقط
vercel loginتسجيل الدخول إلى حساب Vercelمرة واحدة فقط (أعدها عند تغيير الحساب)
vercelنشر معاينة، ينتج URL معاينةفي كل مرة تريد رؤية النتيجة أولًا
vercel --prodنشر الإنتاج، ينتج URL رسميًاللنشر الخارجي وتحديث النسخة الرسمية
vercel install neonتثبيت تكاملات قواعد البيانات بنقرة واحدةعندما يحتاج المشروع إلى تخزين

استعراض الدرس التالي ​

اكتملت مسارات الإطلاق الثلاثة — فـ GitHub Pages وCloudflare Pages وVercel لكل منها حصتها المجانية وطابعها الخاص. الدرس التالي A5 مقارنة منصات النشر: الحصص المجانية والقيود وكيفية الاختيار يضع المنصات الثلاث في جدول واحد.

ستتعلم:

  • كم تبلغ الحصة المجانية لكل منصة، وماذا يحدث عند تجاوزها
  • أي منصة يختار كل فئة (من لا يستخدم سطر الأوامر / من يعرف Git / من يستخدم وكيل ذكاء اصطناعي)
  • عند التردد، بأي ترتيب تتخذ القرار
gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.