Next.js Deploy نشر Next.js
آخر تحديث: 2026-11-03
Next.js Deploy نشر Next.js
Vercel هو الخيار الأول لنشر Next.js — بلا أي إعداد، مع دعم ISR وتحسين الصور والدوال الحافية (edge) — لكن يمكنك أيضًا الاستضافة الذاتية على Node أو تصدير موقع ثابت. وقائمة الفحص العامة قبل الإطلاق واحدة في كل مكان: متغيّرات البيئة، وبناء إنتاجي، وبيانات SEO، و HTTPS على النطاق؛ وتخطّي خطوة قد يتركك بصفحة فارغة في الإنتاج.
| المجموعة | المنظومة والتقدّم |
|---|---|
| النوع | أدوات |
| منذ الإصدار | Next.js 14 / 15 مستضاف على Vercel (موصى به)؛ والاستضافة الذاتية تحتاج Node 18+ |
ℹ️ ملاحظة يحوّل المحرّر JSX إلى JavaScript ويعرض الواجهة الحقيقية داخل بيئة معزولة؛ تُركَّب المكوّنات تلقائياً دون استدعاء render يدوي.
📝 الصيغة
# Verify the production build locally first
npm run build && npm start
# Deploy with the Vercel CLI (or push to GitHub for automatic deploys)
npx vercel # preview environment
npx vercel --prod # production environment
# Configure environment variables in the platform dashboard, never commit .env
NEXT_PUBLIC_API_BASE=https://api.example.com # ends up in the client bundle
DATABASE_URL=... # server only (no NEXT_PUBLIC_ prefix)⚙️ المعاملات
| vercel --prod | ينشر المجلد الحالي إلى الإنتاج؛ وبلا --prod يُنتج رابط معاينة للمراجعة. |
|---|---|
| NEXT_PUBLIC_ prefix | لا تُحزَّم في كود العميل سوى المتغيّرات الحاملة لهذه البادئة؛ ويبقى كل متغيّر آخر في جهة الخادم، ما يحفظ أسرارك. |
القيمة المرجعة：لا قيمة مرتجعة — مسار النشر موصوف في بناء الجملة والمثال.
▶ مثال
المثال يعمل مباشرة: يُعرض تلقائياً عند التوسيع وتظهر التعديلات فوراً.
الناتج：
محاكاة: قائمة فحص نشر تفاعلية تغطّي صناديقها الأربعة متغيّرات البيئة والبناء الإنتاجي وبيانات SEO و HTTPS للنطاق. ومع تحديدك لها ينمو عدّاد الجاهزية بالأسفل من 0/4، وبمجرد تحديد الكل يتحوّل الوضع إلى الأخضر مع «جاهز للإطلاق»؛ وإلغاء أي عنصر يُعيد رسالة الانتظار فورًا.💡 النقاط الأساسية
⚠️ تحذير لا تسري متغيّرات البيئة إلا في لوحة منصّة النشر أو في بيئة البناء، ولا يدخل .env.local المستودع قط؛ وبعد تغيير متغيّر يجب إعادة النشر لحقنه.
💡 نصيحة اقبل التغييرات عبر عمليات نشر المعاينة: يحصل كل PR تلقائيًا على رابط معاينة خاص، فتأكّده قبل الدمج والإطلاق بدل الاختبار في الإنتاج.
ℹ️ ملاحظة لا يدعم التصدير الثابت (output: 'export') ISR ولا مسارات API الخادمية، فتحقّق ما إذا كان المشروع يعتمد على هذه المزايا قبل اختياره.
🏷️ المزيد من المنظومة
💡 حالات ذات صلة
المزيد من الحالات قريباً.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
س هل يمكن نشر Next.js بلا Vercel؟
ج نعم. يمكنك الاستضافة الذاتية على Node (npm start / Docker)، أو النشر على VPS مع PM2، أو تصدير موقع ثابت بحت إلى أي استضافة ثابتة — عندئذٍ فقط تحتاج مزايا مثل ISR وتحسين الصور إلى إعدادك الخاص، أو يجب التخلي عنها.
س لماذا تذهب صفحة الإنتاج فارغة أو تشتكي من متغيّر بيئة مفقود؟
ج في معظم الحالات لم يُضبَط متغيّر NEXT_PUBLIC_ في لوحة المنصّة قط، أو ضُبِط بلا إعادة بناء — فهذه المتغيّرات تُحقَن وقت البناء، فيلزم نشر جديد بعد التغيير.
س هل يجب تشغيل الأوامر يدويًا في كل نشر؟
ج لا. اربط مستودع GitHub فيؤدّي الدفع إلى تشغيل نشر: يحصل PR على رابط معاينة ويدمج في الفرع الرئيسي فيُطلَق تلقائيًا؛ ويمكنك أيضًا تخصيص مسار CI/CD عبر GitHub Actions.
