راهنمای نصب و سفارشی‌سازی 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، می‌توانید یک محیط پایدار، امن و کاملاً مطابق با نیازهای زیرساختی خود ایجاد کنید. این فرآیند به شما کمک می‌کند تا کنترل کامل‌تری بر نصب، نسخه‌ها، سرویس‌ها و پیکربندی‌های حیاتی سرور داشته باشید.


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

مقالات مرتبط

راهنمای کامل بازیابی اکانت cPanel و انتقال حساب‌ها و تنظیمات برای مدیران سیستم تازه‌کار

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

ادامه

How to Move All cPanel Accounts from One Server to Another

This guide explains how to migrate all cPanel accounts, service configurations, SSL certificates, and the main server IP address from an old source server to a new target server. It covers installation requirements, configuration transfers, account migration, IP reassignment, DNS adjustments, and SSL restoration.

ادامه

آموزش کامل مهاجرت یک وب‌سایت وردپرس از macOS به سرور cPanel & WHM

این مقاله نحوه انتقال یک وب‌سایت وردپرس که روی macOS میزبانی شده است را به یک سرور cPanel & WHM توضیح می‌دهد. شامل خروجی گرفتن از دیتابیس، آپلود فایل‌ها، ایجاد دیتابیس جدید، تنظیم wp-config.php، تغییر URL سایت، و رفع لینک‌ها و تصاویر خراب است.

ادامه

آموزش کامل انتقال دستی یک اکانت بین سرورها در cPanel & WHM

این مقاله نحوه انتقال دستی یک اکانت بین دو سرور را زمانی که حجم اکانت برای ابزارهای انتقال WHM بسیار بزرگ است توضیح می‌دهد. شامل ایجاد دایرکتوری موقت، فشرده‌سازی public_html و لاگ‌ها، انتقال امن با scp، و بازیابی فایل‌ها در سرور جدید است.

ادامه

آموزش کامل مهاجرت دستی داده‌های Horde به Roundcube در cPanel & WHM

این مقاله نحوه مهاجرت دستی تقویم‌ها و مخاطبین Horde به Roundcube را در نسخه‌های 108 تا 118 cPanel & WHM توضیح می‌دهد. شامل مراحل خروجی گرفتن از Horde، انتقال فایل‌ها به مسیرهای صحیح، و وارد کردن داده‌ها در Roundcube با استفاده از افزونه‌های داخلی یا ابزارهای واردسازی است.

ادامه

آموزش کامل مهاجرت دستی اکانت‌ها از کنترل‌پنل‌های غیرپشتیبانی‌شده به cPanel & WHM

این مقاله نحوه مهاجرت دستی اکانت‌ها از کنترل‌پنل‌های غیرپشتیبانی‌شده به cPanel & WHM را توضیح می‌دهد. شامل اقدامات قبل از مهاجرت، نصب سرور جدید، انتقال فایل‌ها و دایرکتوری‌ها، بازیابی دیتابیس‌ها، انتقال SSL، و اقدامات پس از مهاجرت است.

ادامه