المدونة

دروس وأدلة وأخبار المنتج.

المطورون

كيف تنشر مشروع Bolt.new على خادمك

2 نوفمبر 2026 5 د للقراءة
مشاركة هذه المقالة

لنشر مشروع Bolt.new على خادمك، اربط المشروع بـ GitHub أو نزّله بصيغة zip، وسلّم الشيفرة إلى لوحة Coolify على خادمك، واضبط متغيرات البيئة ووجّه نطاقك إليه. وثائق Bolt تقول الشيء نفسه: متى صارت الشيفرة على GitHub يمكنك النشر عبر أي خدمة أخرى تختارها. وإذا سلكت طريق GitHub فيمكنك مواصلة العمل في Bolt وتصل تغييراتك إلى المستودع من تلقاء نفسها.

يتركز Bolt على JavaScript. والحزمة التقنية المدعومة لديه هي Node.js في الخلفية وأطر العمل القائمة على المتصفح في الواجهة، بلا خلفيات Python أو PHP. فمشروعك على الأرجح مشروع Node عادي فيه package.json، ولا يحتاج إلى شيء خاص بـ Bolt ليعمل.

كيف تُخرج الشيفرة من Bolt؟

عبر GitHub

  1. افتح المشروع وانقر أيقونة GitHub في أعلى اليمين، وسجّل الدخول بحساب GitHub لديك وامنح الصلاحية التي يطلبها.
  2. سمِّ المستودع واضغط Create repository.
  3. يبدأ المستودع خاصًا على فرع main. ومن ذلك الحين يرسل Bolt إليه كل تغيير.

بصيغة zip

انقر اسم المشروع في أعلى اليسار ثم Download. ملف zip نسخة لمرة واحدة ولا يلتقط التغييرات اللاحقة في Bolt. وينشر الخادم من مستودع Git، فسيبقى عليك أن تضعه في مستودع. وفك ضغطه وتنفيذ npm install && npm run dev طريقة سريعة لرؤية الشيفرة تعمل خارج Bolt.

أي نوع من المشاريع هو؟

المشروع هو الذي يحدد الإعدادات، فتحقق من الاعتماديات في package.json. وصفوف Next.js وVite وAstro هي إعدادات جرّبناها مع Coolify على خادم حقيقي.

الاعتماديةالمشروعإعدادات Coolify
nextNext.jsالمنفذ 3000، ولا شيء آخر يلزم إدخاله
viteموقع ثابتOutput type ‏Static site، وPublish directory ‏/dist
astroتطبيق Astro على الخادمالمنفذ 4321، وStart command ‏HOST=0.0.0.0 node dist/server/entry.mjs
express أو ما شابههخادم Node.jsالمنفذ الذي يستمع عليه التطبيق، والعنوان 0.0.0.0، وسكربت start في package.json

إذا كان مشروع Vite يوجّه الصفحات في المتصفح فاضبط Site type على SPA في صفحة General. وإغفال ذلك هو السبب المعتاد لإعادة صفحة متداخلة خطأ 404 عند التحديث.

خطوة بخطوة

  1. اطلب خادمًا من صفحة Next.js VPS. يأتي هذا الخيار مع Coolify، فتنشر من اللوحة نفسها حتى لو لم يكن مشروعك Next.js.
  2. انسخ المستودع (clone) ونفّذ npm run build. الشيفرة التي تعمل في معاينة Bolt قد تفشل في بناء الإنتاج، والأفضل أن تعرف ذلك قبل أن يعرفه الخادم.
  3. افتح المجلد في أداة برمجة مثل Claude Code أو Cursor. انسخ صف الصقه في أداة الذكاء الاصطناعي من تبويب نظرة عامة في لوحة Seturack والصقه. تقرأ الأداة التعليمات وتنشر، وتضيف مفتاح نشر للقراءة فقط للمستودع الخاص.
  4. أعطِها متغيرات البيئة التي تتوقعها شيفرتك، وأبقِ القيم خارج الشيفرة.
  5. حين يصل عنوان HTTPS جرّب الصفحات وتسجيل الدخول وكتابة البيانات.
  6. وجّه سجل A إلى عنوان IP للخادم وأخبر الأداة باسم النطاق. وتصدر الشهادة تلقائيًا.

يمكنك فعل هذا كله يدويًا في Coolify أيضًا، كما يشرح دليل Next.js لدينا. صلاحية root لك، ويمكنك إدارة كل شيء من اللوحة إن فضّلت.

امنع كل تغيير من أن يصل إلى الموقع الحي

إليك تفصيلًا خاصًا بـ Bolt. فلأنه يرسل كل تغيير إلى المستودع، يعني webhook على main أن كل prompt يبدأ بناءً جديدًا، وتصل التجارب غير المكتملة إلى الموقع الحي. ولتجنب ذلك انقر أيقونة GitHub واستخدم Create new branch للعمل على فرع منفصل، ثم ادمجه في main عند الانتهاء. لا يراقب الخادم إلا main، فيرى الزوار النسخة المكتملة.

ماذا يحدث لـ Bolt Database؟

يحتفظ Bolt Database ببياناتك وتسجيل الدخول وتخزين الملفات ودوال الخادم في Bolt Cloud. ونقل الشيفرة يترك ذلك كله حيث هو، فتختار ما يلي.

الخيارما تفعلهاحذر من
ابقَ على Bolt Databaseاضبط العنوان والمفاتيح التي تتصل بها شيفرتك، ثم جرّب القراءة والكتابة على العنوان المؤقتقد يوقف Bolt قاعدة بيانات قليلة الاستخدام في مشروع غير منشور
انقلها إلى Supabase (Claim)من أيقونة قاعدة البيانات انتقل إلى Advanced واضغط Claimتحتاج إلى خطة Pro أو Teams وملكية مؤسسة Supabase
شغّل Supabase على خادمكانقلها أولًا، ثم جهّز Supabase VPS واتبع دليل الاستعادةتنتقل الملفات ودوال الخادم على حدة، ويسجّل المستخدمون الدخول من جديد
صدّر الصفوف فقطحدّد صفوفًا في جدول وصدّر CSV أو JSONيناسب كميات البيانات الصغيرة

المفاتيح الموجودة في صفحة Secrets في Bolt مخصصة لدوال الخادم لديه. والشيفرة التي تعمل على خادمك تقرؤها من متغيرات البيئة، فتدخلها هناك بنفسك.

الأسئلة الشائعة

ما قوة الخادم التي يحتاجها مشروع Bolt.new؟

توصي صفحة البيع بـ 4 GB من RAM على الأقل و2 vCore و40 GB من القرص. تضغط عمليات بناء Next.js الذاكرة كلما كبر المشروع: فشل مشروع فيه 85 حزمة عند 2 GB وبُني عند 4 GB، بينما نجح مشروع صغير عند 2 GB. وإن لم يكفِ فـ ارفع الحجم من لوحتك.

كم ستكلف شهريًا؟

سعر الحجم الأدنى الموصى به نحو $6 شهريًا (شاملًا ضريبة القيمة المضافة)، ومن خارج تركيا تدفع بالدولار الأمريكي. النسخ الاحتياطية اليومية مشمولة في السعر والترافيك غير محدود. واشتراك Bolt لديك منفصل، ويستمر إن واصلت التطوير هناك.

كيف أربط نطاقي؟

وجّه سجل A إلى عنوان IP للخادم وأضف النطاق إلى التطبيق وانشر من جديد. وتصدر الشهادة تلقائيًا. ويغطي مقال المساعدة لدينا السجل.

كيف يصل تغيير في Bolt إلى الخادم؟

يرسله Bolt إلى GitHub، ومع webhook يعيد الخادم البناء عند كل push إلى الفرع الذي يراقبه. وبدونه اضغط Redeploy في Coolify.

هل أستطيع نقل قاعدة البيانات إلى PostgreSQL في Coolify؟

إذا كانت شيفرتك تخاطب قاعدة البيانات مباشرة عبر SQL فنعم. أما Bolt Database فيغطي أيضًا تسجيل الدخول والملفات ودوال الخادم، ولن يحل PostgreSQL العادي محلها إن كانت شيفرتك تعتمد عليها. في هذه الحالة يتطلب طريق Supabase تغييرات أقل في الشيفرة.

جاهز على Seturack: Next.js, Coolify, Supabase.

التعليقات0

لا توجد تعليقات بعد

كن أول من يشارك رأيه.

الانضمام إلى النقاش

يرجى تسجيل الدخول أو إنشاء حساب لترك تعليق.

لا تفوت أي مقالة

تلق أحدث الشروحات والأدلة وأخبار منتجاتنا في بريدك الوارد.

تم اشتراكك في نشرتنا البريدية.