إضافة موقعك الإلكتروني الأول

يعدّ إضافة موقع إلكتروني جديد في ServBay لبدء مشروعك المحلي أمرًا بسيطًا وبديهيًا. تقدم هذه الوثيقة شرحًا مفصلاً حول كيفية إضافة أول موقع إلكتروني في ServBay، بما في ذلك خطوات التنفيذ، الخيارات الأساسية للتهيئة، وبعض النصائح العملية.

سواء كنت تطوّر مشاريع PHP، Node.js، مواقع ثابتة، أو تحتاج لإعداد وكيل عكسي أو إعادة توجيه، يوفر لك ServBay دعمًا مرنًا لكل تلك الحالات.

نظرة عامة

يهدف ServBay إلى توفير بيئة تطوير محلية قوية وسهلة الإدارة لمطوري الويب. تمنحك واجهته الرسومية السهلة (GUI) القدرة على إضافة، تهيئة، وإدارة عدة مواقع محلية بكل سهولة. باتباع الخطوات التالية، يمكنك إنشاء أول موقع إلكتروني محلي في ServBay بسرعة وتخصيص إعداداته حسب متطلبات مشروعك.

المتطلبات الأساسية

قبل البدء في إضافة الموقع، يرجى التأكد من:

• أنك قمت بتثبيت تطبيق ServBay بنجاح وتشغيله على نظام macOS.

خطوات إضافة موقع إلكتروني

فيما يلي الخطوات التفصيلية لإضافة موقع جديد باستخدام واجهة ServBay الرسومية:

الخطوة 1: فتح تطبيق ServBay

أولاً، توجه إلى مجلد التطبيقات على macOS وابحث عن أيقونة ServBay، ثم قم بالنقر المزدوج لفتح التطبيق.

الخطوة 2: الانتقال إلى واجهة إدارة المواقع

بعد تشغيل تطبيق ServBay، ستظهر لك الواجهة الرئيسية. في القائمة الجانبية على اليسار، انقر على الخيار المسمى المواقع. سيقودك هذا إلى صفحة إدارة المواقع في ServBay.

الخطوة 3: البدء بإضافة موقع جديد

في صفحة إدارة المواقع، ابحث وانقر على زر + الموجود في الزاوية السفلية اليسرى من الصفحة. بعد النقر سيظهر على الجانب الأيمن من الواجهة نموذج جديد لإدخال تفاصيل تكوين الموقع الجديد.

الخطوة 4: تهيئة إعدادات الموقع

في نموذج إعداد الموقع الذي ظهر حديثاً، عليك تعبئة أو اختيار المعلومات الأساسية التالية:

1. الاسم: عَيِّن اسمًا سهل التعرّف لموقعك المحلي. هذا للاستخدام الداخلي في ServBay فقط، لتسهيل إدارة المواقع المختلفة.
2. اسم النطاق: أدخل اسم النطاق الذي تود استخدامه للوصول للموقع محليًا. لتجنّب التعارض مع النطاقات الحقيقية، يُنصح بشدة باستخدام لاحقة مثل .demo أو أحد النطاقات المحلية التي يوفرها ServBay مثل servbay.demo أو myproject.servbay.demo. سيتولى ServBay إعداد解析 DNS المحلي تلقائيًا، مما يتيح لك تصفح الموقع من المتصفح باستخدام هذا النطاق.
3. البروتوكول: اختر البروتوكول الذي سيدعمه الموقع. عادةً ما يكون الإعداد الافتراضي هو HTTP/HTTPS، حيث سيعتني ServBay تلقائيًا بتكوين HTTPS المحلي.
4. طريقة طلب شهادة SSL: ضبط تشفير SSL/TLS لموقعك المحلي.
   • ServBay CA: موصى به للتطوير المحلي. سيقوم ServBay تلقائيًا بإنشاء وإدارة شهادة SSL عبر سلطة الشهادات المدمجة (PKI). يكفي أن تثق بالجذر الخاص بـ ServBay (ServBay User CA أو ServBay Public CA) على نظامك لتستفيد من تصفح HTTPS من دون تحذيرات.
   • ACME: إذا كنت ترغب بمحاكاة بيئة الإنتاج، يمكنك استخدام بروتوكول ACME (مثل Let's Encrypt أو ZeroSSL أو Google Trust Services) لإصدار شهادات موثوقة لنطاقك المحلي (إذا كان النطاق قابلًا للوصول علنيًا ويشير إلى ServBay). يدعم ServBay التقديم التلقائي وتجديد الشهادات عبر ACME.
5. نوع الموقع: اختر النوع الملائم لمكدس مشروعك:
   • PHP: للمشاريع المبنية على PHP مثل WordPress, Laravel, Symfony. سيقوم ServBay بضبط خادم ويب (Nginx أو Apache) للعمل مع PHP-FPM وإدارة الطلبات.
   • Node.js: لمشاريع Node.js، غالبًا يتم إعداد وكيل عكسي ينقل الطلبات إلى منفذ App الخاص بك.
   • ثابت: للمواقع المبنية من ملفات HTML وCSS وJavaScript فقط. يتم تقديم الملفات مباشرة عبر خادم الويب.
   • وكيل عكسي: يسمح بتحويل الطلبات لنطاق أو مسار معين إلى عنوان أو منفذ آخر (محلي أو خارجي)، وهو مفيد جدًا مع تطبيقات أخرى وخدمات منفصلة.
   • إعادة توجيه: يعيد توجيه جميع الطلبات من هذا النطاق إلى عنوان URL آخر.
6. نسخة PHP: إذا كان نوع الموقع PHP، اختر النسخة المثبتة والنشطة من PHP لتنفيذ ملفات الموقع. تأكد أن النسخة المرغوبة مثبتة عبر مدير الحزم في ServBay.
7. قواعد إعادة كتابة الروابط (الروابط الصديقة): أغلب أطر العمل وأنظمة إدارة المحتوى الحديثة تحتاج إلى قواعد URL صديقة (مثال /about بدلًا من /index.php?page=about). يمنحك ServBay خيارات جاهزة للقواعد الخاصة بأنظمة شهيرة مثل Laravel, WordPress, Discuz!. إذا لم يكن إطارك مدرجًا أو لديك قواعد مخصصة، قد تحتاج لتحديث إعدادات خادم Nginx أو Apache يدويًا.
8. المسار الجذري: حدّد المسار الفعلي لملفات موقعك. هذا هو الدليل المبدوء منه لخادم الويب. يفضل الاحتفاظ بالمشاريع ضمن المسار الافتراضي www مثل /Applications/ServBay/www/servbay-demo. تأكد أن هذا المسار موجود ويمتلك ServBay صلاحية القراءة عليه.

WARNING

بالنسبة للمشاريع المعتمدة على الأطر (مثلاً Laravel)، تأكد من أن المسار الجذري يشير إلى مجلد public (المحتوي على index.php) وليس جذر المشروع مباشرة.

الخطوة 5: حفظ الموقع وتفعيله

بعد تعبئة والتحقق من جميع البيانات، انقر على زر إضافة الموجود أسفل النموذج. سيقوم ServBay بتوليد وتحميل إعداد الموقع الجديد إلى خوادم الويب (Nginx أو Apache)، وتحديث إعدادات DNS المحلي.

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

الخطوة 6: الاستفادة من أدوات الإدارة السريعة

يقدم ServBay مجموعة من الأزرار السريعة لكل موقع، لتسهيل إدارة سير عمل التطوير المحلي:

1. فتح في IDE: يفتح مجلد المشروع مباشرة في محرر الأكواد أو الـIDE المفضل لديك.
2. فتح في المتصفح: يفتح عنوان الموقع بسرعة في المتصفح الافتراضي.
3. عرض السجلات: يعرض بسهولة سجل دخول وخطأ خادم الويب الخاص بالموقع لمساعدتك في التصحيح.
4. إيقاف/تشغيل الموقع: لتعطيل مؤقت أو إعادة تفعيل الوصول للموقع.
5. حذف الموقع: لإزالة إعداد الموقع من ServBay (هذا لا يحذف ملفات الموقع من القرص).

حالة بسيطة: إنشاء موقع HTML ثابت

لتأكيد إعداد أول موقع لك بنجاح، يمكنك القيام بالاختبار التالي:

1. أضف موقعًا جديدًا بالطريقة السابقة، مثلاً اختر النطاق servbay.demo، نوع الموقع ثابت، ومسار الجذر /Applications/ServBay/www/servbay-demo-static.

2. أنشئ هذا الدليل /Applications/ServBay/www/servbay-demo-static على جهازك.

3. في هذا الدليل، أنشئ ملفًا باسم index.html.

4. افتح ملف index.html بمحرر نصوص وأضف شيفرة HTML التالية:

   <!DOCTYPE html>
   <html>
   <head>
       <title>ServBay Static Test</title>
   </head>
   <body>
       <h1>تهانينا! موقعك الأول على ServBay يعمل بنجاح!</h1>
       <p>إذا رأيت هذه الصفحة، فهذا يعني أن ServBay قد أتم تهيئة وتقديم موقعك الثابت بنجاح.</p>
   </body>
   </html>

5. احفظ ملف index.html.

6. عُد إلى واجهة إدارة المواقع في ServBay، وابحث عن الموقع servbay.demo الذي أضفته ثم انقر على رمز المتصفح السريع.

7. يجب أن يفتح المتصفح لديك على الرابط http://servbay.demo (أو https://servbay.demo حسب إعدادات SSL)، وتظهر صفحة index.html التي أنشأتها.

ملاحظات هامة

• تعارض اسم النطاق: تجنب استخدام نطاقات قد تتعارض مع شبكتك المحلية أو VPN. ينصح باستخدام .demo.
• صلاحيات المسار الجذري: تأكد أن المستخدم الذي يشغل ServBay (غالبًا هو المستخدم الحالي) يملك صلاحية القراءة على مسار الجذر وجميع ملفاته الفرعية.
• احتلال الميناء: يستخدم ServBay افتراضيًا المنافذ 80 (HTTP) و443 (HTTPS). إذا كانت هذه المنافذ مشغولة من تطبيق آخر، لن يعمل خادم الويب أو سيكون الوصول لموقعك غير متاح. تحقق من ذلك وأغلق أي تطبيق يستخدم هذه المنافذ.
• الثقة بـ ServBay CA: إذا استخدمت ServBay CA وتريد تصفح HTTPS من دون تحذيرات، عليك الوثوق بشهادة الجذر الخاصة بـ ServBay User CA أو ServBay Public CA في نظام macOS. راجع توثيقات ServBay لكيفية القيام بذلك.

الأسئلة الشائعة (FAQ)

• س: لماذا تظهر لي رسالة “HTTP Error 403 - Forbidden” أو “HTTP Error 404 - File not found” عند فتح موقعي؟
  • ج: هذا من أكثر الأخطاء شيوعاً للمطورين.
  • أولًا، تحقق من أن المسار الجذري للموقع مضبوط بشكل صحيح. في معظم أطر العمل الحديثة (مثل Laravel, Symfony, CakePHP)، وبسبب الجودة والأمان وإدارة المشروع، فإن جذر المشروع (حيث ملفات vendor وcomposer.json وpackage.json وغيرها) ليس هو مدخل الموقع الفعلي.
  • لذا يجب توجيه المسار الجذري للموقع إلى الدليل الذي يحوي ملف الدخول الفعلي (index.php, index.htm, index.html).
  • أدلة الدخول الشائعة: public، web، www، htdocs، wwwroot، webroot.
• س: أضفت موقعًا، لكن في المتصفح تظهر رسالة “الموقع غير متاح” أو “تم رفض الاتصال”？
  • ج: أولًا تحقق أن ServBay يعمل وأن حالة خادم الويب (Caddy/Nginx/Apache) سليمة (من الواجهة الرئيسية).
  • تأكد أن اسم النطاق المُدخل في المتصفح مطابق تمامًا للإعدادات في ServBay.
  • تحقق أن الموقع في قائمة المواقع نشط (غير متوقف مؤقتًا).
  • تأكد من صحة مسار الجذر ووجود ملف الدخول (مثل index.html أو index.php في المسار).
  • افحص إذا كان هناك أي تطبيق آخر يستخدم المنافذ 80 أو 443.
• س: موقع PHP الخاص بي لا يعمل كما توقعت، تظهر صفحة فارغة أو يبدأ المتصفح في تحميل الملف？
  • ج: تأكد من اختيار نسخة PHP الصحيحة في إعدادات الموقع، وأن النسخة مثبتة ومفعلة في ServBay.
  • تأكد أن صلاحيات ملفات ودلائل الموقع صحيحة.
  • تحقق من سجلات الموقع (عبر زر السجلات) لرسائل الخطأ الخاصة بـ PHP.
  • تأكد من وجود ملف index.php أو ملف مدخل آخر محدد في إعدادات ServBay.
• س: ضبطت HTTPS لكن تظهر رسالة تحذير حول الشهادة في المتصفح؟
  • ج: إذا كنت تستخدم ServBay CA، يجب عليك الوثوق بشهادة الجذر الخاصة بـ ServBay في النظام أو المتصفح. راجع دليل توثيق ServBay حول هذا الأمر.
  • إذا كنت تستخدم ACME، تحقق من أن نطاقك يشير بشكل صحيح إلى ServBay وأن الشهادة تم إصدارها وتثبيتها بنجاح. راجع السجلات لمزيد من التفاصيل.
• س: قواعد إعادة كتابة الروابط (الروابط الصديقة) لا تعمل وتسبب مشاكل في تصفح صفحات الموقع؟
  • ج: تأكد من اختيار القواعد المناسبة لإطار العمل أو التطبيق.
  • إذا كنت تستخدم Apache، تحقق من وجود ملف .htaccess في المسار الجذري أو المسارات الداخلية، وأن إعدادات ServBay تسمح بقراءة الملف.
  • في حال Nginx أو Caddy، عادة تُدرج القواعد في الملفات التي ينشئها ServBay تلقائيًا، تحقق من تحميلها بشكل صحيح.

الخلاصة

باتباعك الخطوات الواردة في هذا الدليل، ينبغي أن تكون قد أضفت وشغّلت بنجاح أول موقع إلكتروني في بيئة تطويرك المحلية بواسطة ServBay. تتيح لك ServBay إمكانيات متقدمة لإدارة المواقع، خيارات تهيئة مرنة (مثل شهادات SSL، نوع الموقع، نسخة PHP، وقواعد الروابط الصديقة)، بالإضافة إلى أدوات إدارية سريعة—وكل ذلك يعزز إنتاجيتك المحلية بشكل ملحوظ. واصل استكشاف باقي مزايا ServBay مثل إدارة الحزم وقواعد البيانات لتحقق بيئة تطوير متكاملة وسلسة.