راهنمای نصب و سفارشی‌سازی cPanel & WHM

در این مقاله نحوه سفارشی‌سازی تنظیمات قبل از نصب cPanel & WHM، آشنایی با روش‌های نصب، پارامترهای قابل تنظیم، نحوه پیکربندی فایل‌های مهم مانند wwwacct.conf، مدیریت نسخه MySQL/MariaDB، بازیابی خودکار حساب‌ها، تنظیم نسخه‌های انتشار و مدیریت فایل cpsources.conf را به‌صورت کامل و کاربردی بررسی می‌کنیم.

سفارشی‌سازی WHMcPanelDNS

~4 دقیقه مطالعه • بروزرسانی ۲۵ بهمن ۱۴۰۴

1. مقدمه


پیش از شروع فرآیند نصب cPanel & WHM، می‌توانید برخی از تنظیمات مهم را مطابق نیاز خود سفارشی‌سازی کنید. این سفارشی‌سازی‌ها باعث می‌شود نصب دقیق‌تر، سریع‌تر و مطابق با ساختار سرور شما انجام شود.


2. روش‌های نصب


نسخه‌های جدید cPanel & WHM به‌صورت پیش‌فرض از روش Fast Installation استفاده می‌کنند. این روش با استفاده از tarball‌ها و بسته‌های سیستمی مانند RPM یا .deb سرعت نصب را به‌طور چشمگیری افزایش می‌دهد.


  • در سیستم‌های مبتنی بر Red Hat مانند AlmaLinux، Rocky Linux و CloudLinux از بسته‌های RPM استفاده می‌شود.
  • در سیستم‌های مبتنی بر Debian مانند Ubuntu از بسته‌های .deb استفاده می‌شود.

3. گزینه‌های سفارشی‌سازی نصب


در زمان اجرای اسکریپت نصب، می‌توانید از گزینه‌های زیر برای کنترل بیشتر فرآیند استفاده کنید:


  • --confirm — نیاز به تأیید قبل از اجرای نصب
  • --force — اجبار نصب روی پیکربندی‌های غیرتوصیه‌شده
  • --keep — عدم حذف پوشه مقصد پس از نصب
  • --nochown — عدم تغییر مالکیت فایل‌های استخراج‌شده
  • --noexec — عدم اجرای اسکریپت نصب
  • --nox11 — جلوگیری از اجرای ترمینال X
  • --skip-cloudlinux — جلوگیری از تبدیل خودکار سرور به CloudLinux
  • --skip-wptoolkit — عدم نصب خودکار WP Toolkit
  • --skip-imunifyav — عدم نصب خودکار ImunifyAV
  • --target NewDirectory — استخراج فایل‌های نصب در مسیر دلخواه
  • --tar arg1 — دسترسی به محتوای آرشیو از طریق دستور tar

4. تنظیمات اولیه سرور


فایل /etc/wwwacct.conf شامل اطلاعات پایه‌ای پیکربندی cPanel & WHM است. پس از نصب، این تنظیمات از طریق بخش Basic WebHost Manager Setup قابل مدیریت هستند.


مراحل ایجاد فایل wwwacct.conf

  • به‌عنوان کاربر root فایل /etc/wwwacct.conf را ایجاد کنید.
  • پارامترها را به‌صورت یک مقدار در هر خط وارد کنید.

نمونه ساختار:


ADDR 192.0.2.0
NS2 ns2.domain.tld
CONTACTPAGER [email protected]
LOGSTYLE combined
CONTACTEMAIL [email protected]
HOMEMATCH home
TTL 14400
NSTTL 86400
NS ns1.domain.tld
ETHDEV eth0
ADDR6
HOST
NS4
DEFMOD jupiter
HOMEDIR /home
NS3
SCRIPTALIAS y

نکته مهم: مقادیر ADDR یا ADDR6، DEFMOD، HOMEDIR، LOGSTYLE، NS، NS2 و SCRIPTALIAS باید حتماً تعریف شوند.


5. مقادیر قابل تنظیم در wwwacct.conf


برخی از مهم‌ترین پارامترها:


  • ADDR — آی‌پی اشتراکی سرور
  • ADDR6 — آی‌پی نسخه ۶
  • CONTACTEMAIL — ایمیل مدیر سرور
  • DEFMOD — قالب پیش‌فرض cPanel
  • HOMEDIR — مسیر پوشه خانه
  • NS / NS2 / NS3 / NS4 — نیم‌سرورها
  • TTL / NSTTL — مقدار پیش‌فرض TTL
  • SCRIPTALIAS — فعال‌سازی مسیر /cgi-bin/

6. تنظیمات فایل cpanel.config


در زمان نصب، سیستم فایل /root/cpanel_profile/cpanel.config را می‌خواند. این فایل شامل تنظیمات بخش Tweak Settings و سایر پیکربندی‌های مهم است.


نحوه ایجاد فایل:

  • به‌عنوان root فایل /root/cpanel_profile/cpanel.config را ایجاد کنید.
  • پارامترها را به‌صورت key=value وارد کنید.

نمونه:


nobodyspam=1

تنظیم نسخه MySQL یا MariaDB

برای تعیین نسخه پایگاه‌داده، مقدار کلید mysql-version را مشخص کنید. این مقدار باید فقط شامل یک نقطه باشد (مثلاً 8.0).


نکته: استفاده از نسخه‌های پشتیبانی‌نشده باعث شکست نصب می‌شود.


7. بازیابی خودکار حساب‌ها


فایل /etc/cpanelacctrestore شامل لیست حساب‌هایی است که باید هنگام نصب به‌صورت خودکار بازیابی شوند.


مراحل:

  • فایل /etc/cpanelacctrestore را ایجاد کنید.
  • نام کاربران را خط‌به‌خط وارد کنید.
  • فایل‌های بکاپ را در مسیرهای /home، /home2، /root و ... آپلود کنید.

8. تنظیم نسخه انتشار (Release Tier)


فایل /etc/cpupdate.conf تعیین می‌کند که سرور از کدام نسخه cPanel & WHM استفاده کند.


نمونه تنظیم:


CPANEL=stable

9. فایل cpsources.conf


این فایل مشخص می‌کند که سرور آپدیت‌ها را از کدام مخازن دریافت کند. تغییرات اشتباه در این فایل می‌تواند باعث اختلال جدی در سیستم شود.


در صورت مشاهده خطای زیر، فایل دارای داده نامعتبر است:


FATAL: Unable to retrieve tier version info: timeout

برای رفع مشکل، فایل را جابه‌جا کرده و اسکریپت زیر را اجرا کنید:


/usr/local/cpanel/scripts/upcp

10. مدیریت بسته‌ها در RHEL و Ubuntu


مدیریت بسته‌ها با yum

در سیستم‌های مبتنی بر RHEL از ابزار yum استفاده می‌شود. هنگام نصب cPanel & WHM باید فقط از مخازن رسمی استفاده کنید.


مدیریت بسته‌ها با apt

در سیستم‌های مبتنی بر Ubuntu از ابزار apt استفاده می‌شود. نصب از مخازن غیررسمی ممکن است باعث اختلال در سیستم شود.


11. پیکربندی EasyApache 4


در صورت نیاز می‌توانید قبل از نصب، پروفایل EasyApache 4 را در فایل /etc/cpanel_initial_install_ea4_profile.json تعریف کنید.


نکته: این فایل باید یک پروفایل معتبر JSON باشد، در غیر این صورت نصب با پروفایل پیش‌فرض انجام می‌شود.


نتیجه‌گیری


با سفارشی‌سازی صحیح تنظیمات قبل از نصب cPanel & WHM، می‌توانید یک محیط پایدار، امن و کاملاً مطابق با نیازهای زیرساختی خود ایجاد کنید. این فرآیند به شما کمک می‌کند تا کنترل کامل‌تری بر نصب، نسخه‌ها، سرویس‌ها و پیکربندی‌های حیاتی سرور داشته باشید.


نوشته و پژوهش شده توسط دکتر شاهین صیامی