ملف العمل الأصلي
reference/run-locally.txt
تحتفظ الشيفرة وصفحات الأمثلة القابلة للتشغيل بمعرّفاتها ونصوصها التجريبية الأصلية. يشرحها الدرس وإرشادات الملفات بلغتك.
تشغيل مشروع التدريب المنفصل هذا
1. أبقِ public/ وnetlify/functions/ وpackage.json في جذر الورشة هذا. استخدم إصدار Node LTS مدعومًا حاليًا يلبي package.json engines، أي >=22.13.0 وهو الحد الأدنى لأداة CLI المثبتة بإصدار محدد. افحص node --version. لدعم الإصدارات الحالي: https://nodejs.org/en/about/previous-releases
2. شغّل npm install في جذر الورشة هذا. يثبّت Netlify CLI المحلية المحددة الإصدار وينشئ package-lock.json. احتفظ بملف القفل مع مشروعك. لا يلزم تثبيت CLI عالميًا.
3. شغّل npx netlify login ثم npx netlify link. اختر مشروع تدريبك القابل للاستغناء عنه فقط. يحدد الربط مشروعًا؛ ولا ينشر نسخة.
4. أنشئ .env خاصة في الجذر باستخدام الأسماء في server-env.example.txt. لا تضعها في public/ أبدًا. تأكد من تجاهل Git لها، واستخدم خدمات وصناديق اختبار خاصة بك فقط.
5. شغّل npm run dev. افتح الرابط المحلي الذي يطبعه الوكيل، عادة http://localhost:8888. لا تستطيع صفحة file:// أو خادم HTTP ثابت عادي تشغيل هذه الدوال.
6. اختبر الميزة والحالات السلبية في الدرس. يظل الوكيل المحلي يستدعي الخدمة البعيدة المعدّة؛ تنطبق إتاحة حسابك وحصته ورسومه المحتملة. فتح الصفحة وحده لا يثبت تسليم المزوّد. أوقف التشغيل باستخدام Ctrl+C.
ولّد LAB_TOKEN باستخدام مولّد عشوائي آمن: openssl rand -hex 24
ينتج ذلك 24 بايتًا عشوائيًا على هيئة 48 محرفًا سداسيًا عشريًا. خزّنه بشكل خاص وأدخل الرمز في النموذج. الحد الأدنى للطول حاجز إدخال فقط، لا دليل على العشوائية؛ لا تستخدم عبارة سهلة التذكر أو مفتاح API لمزوّد.
وثائق CLI: https://docs.netlify.com/api-and-cli-guides/cli-guides/local-development/