همه مقالات تخصصی

ساب‌دامین‌ها و Document Root در cPanel: تمیز بسازید و از تداخل دوری کنید

ساب‌دامین cPanel را با document root درست بسازید، DNS و SSL را بررسی کنید و از تداخل .htaccess با سایت اصلی دوری کنید.

ساب‌دامین‌ها و Document Root در cPanel: تمیز بسازید و از تداخل دوری کنید

ساب‌دامین‌هایی مثل blog.example.com یا app.example.com در cPanel آسان ساخته می‌شوند، اما دو نکته بیشتر مشکل‌ها را می‌سازند: document root به کجا اشاره می‌کند و قاعده‌های سایت اصلی چطور روی آن اثر می‌گذارند. این راهنما یک چیدمان تمیز را توضیح می‌دهد، نشان می‌دهد چطور درستی DNS و پوشه را بسنجید و اشتباه‌هایی را می‌گوید که باعث می‌شوند ساب‌دامین سایت اشتباه یا ۴۰۴ نشان دهد. نام منوها از دانش خودم است و بسته به نسخهٔ 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 با غیرفعال‌بودن فهرست‌کردن پوشه ۴۰۳ یا ۴۰۴ می‌دهد:

# 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 تست کنید و مطمئن شوید نام گواهی می‌خواند. اگر گواهی وایلدکارت دارید همهٔ ساب‌دامین‌ها را پوشش می‌دهد.

۶. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید ساب‌دامینی (ساختگی) صفحهٔ اصلی سایت اصلی را نشان می‌دهد. رکورد DNS درست است اما پوشه داخل public_html است و یک rewrite فراگیر در .htaccess اصلی زودتر درخواست را می‌گیرد. جابه‌جایی پوشه به بیرون public_html و به‌روزکردن document root در cPanel باعث می‌شود ساب‌دامین فایل‌های خودش را سرو کند.

۷. اشتباه‌های رایج

  • پذیرفتن پوشهٔ پیش‌فرض بدون فکر.
  • آپلود فایل پیش از انتخاب document root.
  • فراموشی رکورد DNS وقتی DNS بیرون cPanel است.
  • گرفتن ساب‌دامین توسط rewrite سایت اصلی.
  • نبود فایل index.
  • تست HTTPS پیش از وجود گواهی.

۸. پرسش‌های متداول

بعداً می‌توانم document root را عوض کنم؟ بله، در بخش Domains، ولی باید مسیرهای اپلیکیشن را هم به‌روز و فایل‌ها را جابه‌جا کنید.

چرا ساب‌دامین من سایت اصلی را نشان می‌دهد؟ اغلب به‌خاطر اشارهٔ DNS، document root اشتباه یا rewrite فراگیر.

گواهی جدا لازم است؟ هر نام میزبان باید پوشش داده شود، با AutoSSL یا گواهی وایلدکارت.

پوشه داخل public_html مشکل است؟ کار می‌کند ولی قاعده‌های سایت اصلی ممکن است مداخله کنند. پوشهٔ جدا تمیزتر است.

۹. چک‌لیست سریع

  1. پوشه را بیرون public_html برنامه‌ریزی کنید.
  2. ساب‌دامین را بسازید.
  3. DNS را با dig بررسی کنید.
  4. فایل‌ها را با index آپلود کنید.
  5. قاعده‌های .htaccess را مرور کنید.
  6. لاگ خطای ساب‌دامین را ببینید.
  7. HTTPS و نام گواهی را تست کنید.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

cPanel docs: Domains interface · cPanel docs: Subdomains · cPanel docs: DNS knowledge base · Apache: mod_rewrite