انتقل إلى المقال
Aniq-UI

SaaS Templateشغّل الموقع محليًا

شغّل الموقع محليًا

شغّل صفحة الهبوط SaaS على جهازك بأمرَي Docker.

قبل أن تبدأ: ثبّت Docker Desktop وافتحه، أو Docker Engine على Linux. لا تحتاج إلى أي شيء آخر.

اطّلع على المتطلبات
  1. نزّل قالبك

    افتح «قوالبي» في لوحة تحكم Aniq UI ونزّل ملف ZIP.

    النتيجة المتوقعة: يظهر في مجلد التنزيلات ملف باسم يشبه Nextjs-landing-page-template-2-main-….zip.

  2. فك الضغط وافتح المجلد

    فك ضغط ملف ZIP وافتح طرفية داخل المجلد Nextjs-landing-page-template-2. على Windows، فك الضغط في مستكشف الملفات، ثم افتح طرفية داخل المجلد.

    الطرفية
    unzip Nextjs-landing-page-template-2-*.zip
    cd Nextjs-landing-page-template-2

    النتيجة المتوقعة: يحتوي المجلد على Dockerfile وpackage.json وmessages وpublic وsrc.

    تواجه مشكلة؟
  3. ابنِ الصورة

    يثبّت Docker الاعتماديات ويبني الموقع داخل الصورة. يستغرق البناء الأول بضع دقائق ويحتاج إلى اتصال بالإنترنت؛ أما عمليات البناء اللاحقة فتعيد استخدام ما لم يتغير.

    الطرفيةفي Nextjs-landing-page-template-2
    docker build -t analytics-landing .

    النتيجة المتوقعة: ينتهي البناء بسطر يذكر اسم الصورة analytics-landing.

    تواجه مشكلة؟
  4. شغّله وافتح الموقع

    شغّل حاوية من الصورة، ثم افتح localhost:3030/enمحلي. اترك الطرفية مفتوحة ما دمت تستخدم الموقع.

    الطرفيةفي Nextjs-landing-page-template-2
    docker run -p 3030:3030 analytics-landing

    المنفذ مستخدم بالفعل؟

    إذا توقف التشغيل برسالة port is already allocated أو address already in use، فبرنامج آخر يستخدم المنفذ 3030. أوقفه، أو غيّر الرقم الذي على يسار -p وافتح ذلك المنفذ: docker run -p 3041:3030 analytics-landing، ثم localhost:3041/enمحلي.

    المنفذ مستخدم بالفعل

    النتيجة المتوقعة: تفتح الصفحة الرئيسية بالإنجليزية، وتحت العنوان الرئيسي معاينة لوحة التحكم. قائمة اللغة في الترويسة تنقلك إلى العربية.

    تواجه مشكلة؟

أوقف التطبيقات وأعد تشغيلها

اضغط Ctrl+C في الطرفية لإيقاف الموقع. إذا أغلقت تلك الطرفية، فابحث عن الحاوية وأوقفها:

الطرفية
docker ps
docker stop <container-id>

استخدم المعرّف الذي يعرضه الأمر docker ps للحاوية analytics-landing. لتشغيله من جديد، نفّذ أمر docker run نفسه، فالصورة مبنية بالفعل.

بعد أن تغيّر أي ملف، ابنِ الصورة مجددًا قبل تشغيلها. تحتوي الصورة على نسخة من الكود كما كان وقت بنائها.

إعداداتك الخاصة

تُضمَّن الإعدادات في الموقع عند بناء الصورة، فهي معاملات بناء وليست خيارات في docker run. الإعداد الذي عليك ضبطه قبل النشر هو عنوان موقعك:

الطرفيةفي Nextjs-landing-page-template-2
docker build -t analytics-landing --build-arg NEXT_PUBLIC_SITE_URL=https://www.your-domain.com .

التالي

توقفت عند خطوة؟

ابحث عن الحل قبل أن تبدأ من جديد.

حل المشكلات

تفضيلات ملفات تعريف الارتباط

نستخدم ملفات تعريف الارتباط لتعزيز تجربة التصفح الخاصة بك وتحليل حركة المرور على الموقع وتخصيص المحتوى. بالنقر على "قبول الكل"، فإنك توافق على استخدامنا لملفات تعريف الارتباط للتحليلات والإعلانات المخصصة.