النطاقات الفرعية مثل blog.example.com أو app.example.com سهلة الإنشاء في cPanel لكن تفصيلين يسببان معظم المشاكل: إلى أين يشير document root وكيف تؤثر قواعد الموقع الرئيسي عليه. يشرح هذا الدليل بنية نظيفة وكيف تتأكدون من سلامة DNS والمجلد وأي الأخطاء تجعل النطاق الفرعي يعرض موقعاً خاطئاً أو 404. أسماء القوائم من معرفتي الخاصة وقد تختلف بحسب إصدار cPanel.
١. اختاروا document root عن قصد
عند إنشاء نطاق فرعي في قسم Domains يقترح cPanel مجلداً. يقبل كثيرون مجلداً داخل public_html وهو يعمل لكنه يخلط موقعين. والمجلد خارج public_html أنظف لأن قواعد الموقع الرئيسي وملفاته لا تمسه:
# Typical layout in a cPanel account
/home/USER/public_html # main domain
/home/USER/public_html/blog # subdomain folder inside the main site (not ideal)
/home/USER/blog.example.com # subdomain folder outside public_html (cleaner)
قرروا قبل رفع الملفات لأن النقل لاحقاً يعني تغيير الإعداد ومسارات التطبيق.
٢. افحصوا DNS أولاً
يحتاج النطاق الفرعي إلى سجل DNS يشير إلى خادمكم. وإن كان DNS مُدارًا لدى المسجّل أو CDN لا في cPanel فقد تحتاجون إلى إضافة السجل هناك. تحققوا مما يراه العالم:
dig +short blog.example.com A
dig +short blog.example.com CNAME
curl -sI http://blog.example.com | head -n 5
curl -sI https://blog.example.com | head -n 5
إن لم يجب DNS بعد فانتظروا الانتشار بدل تغيير الخادم. ولسلوك إعادة التوجيه العام راجعوا دليل إعادة التوجيه.
٣. افحصوا المجلد وملف index
في الطرفية أو مدير الملفات تأكدوا أن المجلد موجود وفيه ملف index. غياب index مع تعطيل عرض المجلدات يعطي 403 أو 404:
# Inside the subdomain document root
ls -la /home/USER/blog.example.com
find /home/USER/blog.example.com -maxdepth 1 -name 'index.*'
tail -n 20 /home/USER/logs/blog.example.com-error_log 2>/dev/null
غالباً يشرح سجل أخطاء النطاق الفرعي المشكلة في سطر واحد.
٤. تجنبوا تعارض القواعد مع الموقع الرئيسي
إن كان مجلد النطاق الفرعي داخل public_html فقد يؤثر عليه .htaccess الخاص بالموقع الرئيسي. وقد تُرسل قاعدة rewrite شاملة الطلبات إلى تطبيق خاطئ:
# .htaccess in public_html applies to subfolders too
RewriteEngine On
RewriteRule ^(.*)$ /index.php [L] # may capture subdomain folders placed inside public_html
ضعوا مجلد النطاق الفرعي خارج public_html أو أضيفوا الاستثناءات اللازمة إلى القواعد. وتذكروا أن لووردبريس داخل مجلد فرعي إعدادات URL خاصة به. وللنطاقات الإضافية راجعوا دليل النطاق الإضافي.
٥. SSL للاسم الجديد
يحتاج كل اسم مضيف إلى شهادة صالحة. يضيف AutoSSL عادة شهادة بعد وجود النطاق الفرعي وعمل DNS لكنه قد يستغرق بعض الوقت. اختبروا HTTP وHTTPS بـ curl وتأكدوا أن اسم الشهادة يطابق. وشهادة wildcard تغطي كل النطاقات الفرعية إن توفرت.
٦. مثال توضيحي وليس قياساً حقيقياً
افترضوا نطاقاً فرعياً (مختلقاً) يعرض الصفحة الرئيسية للموقع الرئيسي. سجل DNS صحيح لكن المجلد داخل public_html وقاعدة rewrite شاملة في .htaccess الرئيسي تعالج الطلب أولاً. نقل المجلد خارج public_html وتحديث document root في cPanel يجعل النطاق الفرعي يخدم ملفاته.
٧. أخطاء شائعة
- قبول المجلد الافتراضي دون تفكير.
- رفع الملفات قبل اختيار document root.
- نسيان سجل DNS حين يكون DNS خارج cPanel.
- ترك قواعد الموقع الرئيسي تلتقط النطاق الفرعي.
- غياب ملف index.
- اختبار HTTPS قبل وجود الشهادة.
٨. أسئلة شائعة
هل أغيّر document root لاحقاً؟ نعم في قسم Domains لكن يجب تحديث مسارات التطبيق ونقل الملفات.
لماذا يعرض نطاقي الفرعي الموقع الرئيسي؟ غالباً بسبب إشارة DNS أو document root خاطئ أو rewrite شامل.
هل أحتاج شهادة منفصلة؟ يجب تغطية كل اسم مضيف بـ AutoSSL أو شهادة wildcard.
هل المجلد داخل public_html مشكلة؟ يعمل لكن قواعد الموقع الرئيسي قد تتدخل. والمجلد المنفصل أنظف.
٩. قائمة تحقق سريعة
- خططوا للمجلد خارج public_html.
- أنشئوا النطاق الفرعي.
- افحصوا DNS بـ dig.
- ارفعوا الملفات مع index.
- راجعوا قواعد .htaccess.
- افحصوا سجل أخطاء النطاق الفرعي.
- اختبروا HTTPS واسم الشهادة.
إذا احتجتم إلى مساعدة في مراجعة الأداء أو صيانة الخادم، فراجعوا خدمات إدارة الخوادم.
تجدون المزيد من أدلة الخوادم وووردبريس في أرشيف المقالات.
المراجع الرسمية
cPanel docs: Domains interface · cPanel docs: Subdomains · cPanel docs: DNS knowledge base · Apache: mod_rewrite
