إضافة موقع ملفات ثابتة
يُعد ServBay أداة تطوير ويب محلية قوية تدعم لغات وقواعد بيانات متعددة. إلى جانب المواقع الديناميكية، فإن ServBay مثالي أيضاً لاستضافة واختبار مواقع الملفات الثابتة، مثل صفحات الويب البسيطة أو تطبيقات الواجهة الأمامية المبنية باستخدام HTML وCSS وJavaScript.
سيرشدك هذا المقال إلى كيفية إضافة موقع ملفات ثابتة وتكوينه في ServBay.
نظرة عامة
تتكون مواقع الملفات الثابتة من ملفات يقدمها خادم الويب مباشرة، ولا يتم تنفيذ أي سكربتات على الخادم مثل PHP أو Node.js أو Python. عادةً ما تحتوي هذه المواقع على صفحات HTML وأوراق أنماط CSS وملفات JavaScript وصور وخطوط وغيرها من الموارد.
يوفر استخدام ServBay لاستضافة مواقع ثابتة محلية سهولة في التطوير وتصحيح الأخطاء والاختبار، خاصة عند الحاجة لمحاكاة الوصول عبر اسم نطاق (Domain) كما في بيئة الإنتاج، أو اختبار اتصال HTTPS أو إعدادات مشاركة الموارد عبر النطاقات (CORS).
سيناريوهات الاستخدام
- تطوير واختبار مشاريع الواجهة الأمامية النقية (HTML/CSS/JS).
- استضافة مواقع وثائق أو مدونات ثابتة.
- اختبار استجابة خوادم الويب المختلفة (Caddy/Nginx) مع الموارد الثابتة.
- محاكاة اسم نطاق الإنتاج والوصول عبر HTTPS محلياً.
- اختبار مخرجات بناء أطر العمل الأمامية مثل React وVue وAngular في بيئة محلية.
المتطلبات المسبقة
- تثبيت وتشغيل ServBay بنجاح على نظام macOS.
- توفر ملفات الموقع الثابت المراد نشره لديك.
خطوات العمل
اتبع هذه الخطوات لإضافة موقع ملفات ثابتة في ServBay:
الخطوة 1: تجهيز ملفات موقعك
بدايةً، تأكد من أن جميع ملفات موقعك الثابت مثل index.html
وstyle.css
وscript.js
محفوظة داخل مجلد منفصل.
ننصح بإنشاء مجلد موقعك ضمن جذر المواقع الافتراضي في ServBay وهو /Applications/ServBay/www
وذلك لتنظيم إدارة ملفاتك بسهولة. فعلى سبيل المثال، إذا رغبت في إنشاء موقع باسم my-static-site
يمكنك إنشاء مجلد بهذا الاسم داخل /Applications/ServBay/www/
ونقل جميع ملفات موقعك إليه.
# إنشاء مجلد نموذجي في الطرفية
mkdir -p /Applications/ServBay/www/servbay-static-demo
cd /Applications/ServBay/www/servbay-static-demo
# إنشاء ملف index.html بسيط
echo '<!DOCTYPE html>
<html lang="zh-Hans">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>مثال موقع ServBay الثابت</title>
<style>
body { font-family: sans-serif; text-align: center; margin-top: 50px; }
h1 { color: #333; }
</style>
</head>
<body>
<h1>تهانينا! تم تكوين موقع ServBay الثابت بنجاح!</h1>
<p>تقوم حالياً بالوصول إلى هذه الصفحة الثابتة محلياً عبر ServBay.</p>
</body>
</html>' > index.html
# وهكذا سيكون هيكل الملفات لديك:
# /Applications/ServBay/www/servbay-static-demo/index.html
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
الخطوة 2: إضافة الموقع ضمن ServBay
- افتح تطبيق ServBay.
- من شريط التنقل الأيسر، انقر على المواقع (ملاحظة: الإصدارات القديمة قد تعرضها باسم "مضيف"، أما الإصدارات الجديدة فهي "المواقع").
- في الجزء السفلي من واجهة قائمة المواقع، انقر على زر إضافة لفتح نافذة الإعدادات.
الخطوة 3: تكوين إعدادات الموقع
في نافذة الإعدادات، قم بتعبئة المعلومات التالية أو اختيارها:
- اسم النطاق (Domain): أدخل اسم النطاق الذي ترغب بالوصول إلى موقعك عبره محلياً. يُنصح باستخدام نطاق ينتهي بـ
.servbay.demo
مثلstatic.servbay.demo
أوmy-static-site.servbay.demo
. يتولى ServBay تلقائياً إعداد解析 هذا النطاق محلياً، ولا تحتاج لتعديل ملف hosts يدوياً.- توضيح: يساعدك استخدام نطاق ذي لاحقة
.servbay.demo
على تجنب تعارض الأسماء مع النطاقات الحقيقية على الإنترنت، كما أن نظام DNS المدمج في ServBay يضمن توجيه هذه النطاقات إلى جهازك المحلي.
- توضيح: يساعدك استخدام نطاق ذي لاحقة
- المسار (Path): انقر على أيقونة المجلد بجوار الحقل لاختيار مجلد الموقع الذي أعددته في الخطوة الأولى، مثل
/Applications/ServBay/www/servbay-static-demo/
.- توضيح: يحدد المسار جذر المستند (Document Root) الذي يبحث فيه خادم الويب (Caddy أو Nginx) عن ملفات الموقع. عند فتح
http://static.servbay.demo/
مثلاً، سيبحث الخادم أولاً في هذا المجلد عن صفحة رئيسية مثلindex.html
. احرص على أن يشير المسار إلى المجلد نفسه لا إلى ملف محدد.
- توضيح: يحدد المسار جذر المستند (Document Root) الذي يبحث فيه خادم الويب (Caddy أو Nginx) عن ملفات الموقع. عند فتح
- المنفذ (Port): عادة ما يُترك المنفذ على الإعداد الافتراضي. المنفذ القياسي لـ HTTP هو 80 و HTTPS هو 443. إذا رغبت في تخصيص منفذ مختلف، يمكنك تعديله هنا.
- خادم الويب (Web Server): اختر الخادم الذي ترغب في استخدامه. لمواقع الملفات الثابتة، Caddy وNginx كلاهما خيارات ممتازة.
- Caddy: سهل الإعداد ويدعم HTTP/2 وضبط HTTPS تلقائياً (مع ServBay User CA)، وهو الخيار الافتراضي في ServBay.
- Nginx: أداء عالي ومرونة في الإعداد، ويستخدم بكثرة في البيئات الإنتاجية.
- يكفي اختيار أحدهما فقط.
- إصدار PHP: غير مطلوب لمواقع الملفات الثابتة، احرص على اختيار None.
- إصدار Node.js: غير مطلوب للمواقع الثابتة، اختر None.
- إصدار Python: غير مطلوب للمواقع الثابتة، اختر None.
- إصدار Go: غير مطلوب للمواقع الثابتة، اختر None.
- إصدار Java: غير مطلوب للمواقع الثابتة، اختر None.
- SSL: إذا رغبت في تفعيل الوصول لموقعك الثابت عبر HTTPS محلياً، حدد هذا الخيار. سيقوم ServBay تلقائياً بإعداد شهادة SSL موثوقة محلياً عبر ServBay User CA، لسهولة اختبار ميزات HTTPS.
- CORS: إذا كان موقعك الثابت بحاجة لمشاركة موارد مع نطاقات أخرى (مثلاً تحميل ملفات خطوط أو بيانات API من نطاق آخر)، فعّل هذا الخيار وقم بضبطه حسب الحاجة. يدعم ServBay إعداد رؤوس CORS للمواقع.
الخطوة 4: الحفظ وتطبيق التغييرات
- بعد الانتهاء من إدخال جميع الإعدادات، انقر على زر حفظ أسفل النافذة.
- عد إلى واجهة قائمة المواقع في ServBay. ستلاحظ ظهور الموقع الجديد الذي أضفته.
- انقر على زر تطبيق التغييرات الموجود أعلى قائمة المواقع.
- توضيح: الضغط على تطبيق التغييرات سيؤدي إلى إعادة تحميل ملفات إعداد خادم الويب (Caddy أو Nginx) لتفعيل الإعدادات الجديدة؛ هذه خطوة ضرورية جداً، وإلا فلن يكون موقعك الجديد متاحاً.
التحقق من الإعداد
بعد حفظ الإعدادات وتطبيقها، افتح متصفح الويب واكتب اسم النطاق الذي أعددته (مثلاً http://static.servbay.demo
أو https://static.servbay.demo
إذا فعّلت SSL).
إذا كان كل شيء صحيحاً، ينبغي أن ترى محتوى موقعك الثابت مثل صفحة index.html
التي أعددناها في المثال.
ملاحظات هامة
- تأكد من أن المسار الذي اخترته هو جذر ملفات موقعك الفعلي.
- بعد كل إضافة أو تعديل أو حذف في إعدادات المواقع، يجب الضغط على زر تطبيق التغييرات ليتم تفعيلها.
- من الأفضل تعيين جميع لغات البرمجة على None عند العمل مع موقع ثابت لتفادي استهلاك الموارد والمخاطر الأمنية غير الضرورية.
- في حال واجهت مشاكل في الوصول للموقع، تحقق من أن ServBay يعمل بشكل صحيح، وتأكد من حالة خادم الويب (Caddy/Nginx)، وكذلك من تطابق اسم النطاق بين إعدادات ServBay وما تكتبه في متصفحك.
الأسئلة الشائعة (FAQ)
س: تظهر لي رسالة "لا يمكن الوصول إلى الموقع" أو "الخادم غير موجود" عند زيارة اسم النطاق. ماذا أفعل؟
ج:
- تأكد من أن تطبيق ServBay قيد التشغيل.
- تأكد من أنك ضغطت على زر تطبيق التغييرات في ServBay.
- تحقق من تطابق اسم النطاق في المتصفح مع الاسم الذي أعددته في ServBay (وانتبه لاستخدام
http://
أوhttps://
). - افحص أن المسار يشير فعلاً إلى مجلد ملفات موقعك.
- راجع سجل سجلات ServBay لمعرفة تفاصيل الخطأ إن وجدت.
س: لماذا تظهر لي قائمة المجلد بدلاً من صفحة index.html
عند الدخول إلى الموقع؟
ج: غالباً السبب أن ملف الصفحة الرئيسية (index.html
) غير موجود في جذر الموقع. تأكد أن هناك ملفاً باسم index.html
(أو أي ملف تعينه كصفحة رئيسية في إعدادات الخادم)، واحرص على صحة اسم الملف وامتداده (حساسية لحالة الأحرف).
س: هل يمكن تفعيل HTTPS لمواقع الملفات الثابتة؟
ج: نعم، يمكنك تفعيل خيار SSL ضمن إعدادات الموقع في ServBay. سيعمل ServBay على توليد شهادة SSL وربطها تلقائياً بنطاقك المحلي بفضل ServBay User CA، مما يسمح لك بالوصول للموقع عبر HTTPS محلياً.
الخلاصة
يتيح لك ServBay إضافة وإدارة مواقع الملفات الثابتة على جهازك بكل سهولة، سواء كانت صفحات HTML بسيطة أو تطبيقات واجهة أمامية معقدة. بفضل نظام إدارة المواقع، ودعم أسماء النطاقات المحلية، وميزات الأمان مثل SSL، يُمكنك تعزيز إنتاجيتك في تطوير واختبار المشاريع الأمامية بفعالية عالية.