آموزش نصب cPanel & WHM با SSH

آموزش کامل نصب cPanel و WHM روی سرور لینوکس

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

SSHWHM :2087مناسب VPS و Dedicated

خلاصه سریع: cPanel یک کنترل‌پنل تجاری و بسیار حرفه‌ای برای فروش هاست، مدیریت اکانت‌های میزبانی، ایمیل، DNS، دیتابیس، SSL و مهاجرت سایت است. نصب آن معمولاً با یک دستور SSH انجام می‌شود، اما موفقیت نصب به پیش‌نیازهایی مثل سیستم‌عامل پشتیبانی‌شده، IP ثابت عمومی، hostname درست، لایسنس معتبر، RAM کافی و فایروال درست وابسته است.

cPanelWHMSSHAlmaLinuxUbuntu 24.04Hosting Panel

فهرست مطالب

cPanel و WHM چیست و چه تفاوتی دارند؟

WHM بخش مدیریتی سرور است؛ مدیر سرور در WHM می‌تواند پکیج بسازد، اکانت هاست ایجاد کند، DNS و SSL و سرویس‌ها را مدیریت کند و تنظیمات امنیتی را انجام دهد. cPanel بخش کاربری است؛ مشتری یا صاحب سایت از داخل cPanel فایل‌ها، دیتابیس، ایمیل، ساب‌دامین، SSL و بکاپ سایت خودش را مدیریت می‌کند.

WHM

برای مدیر سرور، شرکت هاستینگ، ریسلر یا مدیر فنی است.

cPanel

برای کاربر نهایی هر هاست است؛ یعنی کسی که سایتش روی سرور میزبانی می‌شود.

آیا cPanel رایگان است؟

cPanel رایگان دائمی نیست. cPanel یک نرم‌افزار تجاری است و برای استفاده واقعی روی سرور نیاز به لایسنس دارد. برای نصب‌های جدید معمولاً امکان فعال‌سازی Trial محدود وجود دارد، اما برای استفاده دائمی باید لایسنس خریداری شود.

هزینه لایسنس بر اساس نوع پلن و تعداد اکانت‌های cPanel محاسبه می‌شود. برای سایت‌های کم‌تعداد، پلن‌های کوچک‌تر مناسب‌تر هستند و برای شرکت‌های هاستینگ یا سرورهای پرتعداد باید به پلن‌های بالاتر یا مدل‌های شریک/نمایندگی توجه کرد. قبل از فروش سرویس به مشتری، قیمت روز لایسنس را بررسی کنید؛ چون هزینه لایسنس روی قیمت نهایی هاست اثر مستقیم دارد.

پیش‌نیازهای نصب cPanel

مورد پیشنهاد عملی چرا مهم است؟
سیستم‌عامل AlmaLinux / Rocky Linux / CloudLinux یا Ubuntu 24.04 LTS طبق نسخه‌های پشتیبانی‌شده نصب روی OS ناسازگار باعث خطای package، repo یا توقف installer می‌شود.
وضعیت سرور سرور تازه و خام نصب روی سروری که قبلاً Apache، MySQL، PHP، پنل دیگر یا تنظیمات سنگین دارد مشکل‌ساز می‌شود.
دسترسی ورود با root نصب cPanel نیاز به دسترسی کامل root دارد.
IP IPv4 عمومی و ثابت لایسنس و سرویس‌ها به IP عمومی ثابت وابسته هستند؛ IP داینامیک یا داخلی مناسب نیست.
Hostname نام کامل مثل server.example.com hostname باید FQDN باشد و بهتر است با دامنه سایت مشتری یکی نباشد.
RAM حداقل 2GB، بهتر 4GB یا بیشتر برای میزبانی واقعی، ایمیل، آنتی‌ویروس و چند سایت، منابع حداقلی کافی نیستند.
Disk حداقل 20GB، بهتر 40GB یا بیشتر خود cPanel و آپدیت‌ها، لاگ‌ها، ایمیل‌ها و بکاپ‌ها فضا مصرف می‌کنند.
SELinux / Firewall SELinux غیرفعال؛ فایروال قبل نصب کنترل شود SELinux و فایروال بسته می‌توانند نصب یا دسترسی به WHM را خراب کنند.

چک‌لیست حرفه‌ای قبل از نصب

قبل از اینکه installer را اجرا کنید، این دستورات را بزنید تا وسط نصب با خطاهای ساده ولی زمان‌بر روبه‌رو نشوید.

# بررسی نسخه سیستم‌عامل
cat /etc/os-release

# بررسی hostname
hostnamectl
hostname -f

# بررسی منابع
free -h
df -h
nproc

# بررسی IPهای سرور
ip -4 addr show
curl -4 ifconfig.me ; echo

# بررسی زمان و NTP
timedatectl

# بررسی DNS resolver
cat /etc/resolv.conf

تنظیم hostname قبل از نصب

یک hostname خوب باید کامل، قابل resolve و جدا از دامنه‌های میزبانی‌شده باشد. مثلاً اگر دامنه شما example.com است، hostname می‌تواند server1.example.com یا host.example.com باشد.

hostnamectl set-hostname server1.example.com
hostname -f

آماده‌سازی AlmaLinux / Rocky Linux

dnf update -y
dnf install -y perl curl wget nano tar

# اگر firewalld فعال است، قبل از توقف، قوانین را بکاپ بگیر
iptables-save > /root/firewall-before-cpanel.rules 2>/dev/null || true
systemctl stop firewalld 2>/dev/null || true
systemctl disable firewalld 2>/dev/null || true

# SELinux باید disabled باشد
sestatus 2>/dev/null || true
sed -i 's/^SELINUX=.*/SELINUX=disabled/' /etc/selinux/config 2>/dev/null || true
reboot

آماده‌سازی Ubuntu 24.04 LTS

apt update
apt upgrade -y
apt install -y perl-base curl wget nano tar

# قبل از نصب، فایروال OS را کنترل کن
iptables-save > /root/firewall-before-cpanel.rules 2>/dev/null || true
systemctl stop ufw.service 2>/dev/null || true
systemctl disable ufw.service 2>/dev/null || true

# بررسی حالت سیستم
systemctl get-default

هشدار مهم: cPanel uninstaller رسمی ندارد. اگر نصب خراب شود یا بخواهید حذفش کنید، مسیر استاندارد معمولاً نصب مجدد سیستم‌عامل یا reformat سرور است. پس cPanel را فقط روی سرور خام نصب کنید.

دستور کامل نصب cPanel با SSH

بعد از آماده‌سازی، با کاربر root وارد SSH شوید و دستور رسمی نصب را اجرا کنید:

cd /home && curl -o latest -L https://securedownloads.cpanel.net/latest && sh latest

این دستور فایل نصب آخرین نسخه cPanel & WHM را دانلود می‌کند و اسکریپت نصب را اجرا می‌کند. زمان نصب بسته به سرعت سرور و mirrorهای سیستم‌عامل ممکن است طولانی شود. در این زمان پنجره SSH را نبندید.

آیا نصب cPanel وسط SSH سوال می‌پرسد؟

برخلاف بعضی پنل‌ها مثل CyberPanel، نصب cPanel معمولاً interactive و سوال‌محور نیست. بیشتر تنظیمات اصلی بعد از نصب، داخل WHM انجام می‌شود. یعنی در SSH بیشتر منتظر نصب پکیج‌ها، کامپایل و تنظیم سرویس‌ها هستید؛ اما تصمیم‌های مهم بعد از نصب در صفحه WHM گرفته می‌شود.

بعد از نصب: ورود به WHM و تنظیمات اولیه

بعد از پایان نصب، پنل WHM را با این آدرس باز کنید:

https://SERVER-IP:2087
# یا اگر hostname درست DNS شده است:
https://server1.example.com:2087

با یوزر root و پسورد root وارد شوید. سپس مراحل اولیه WHM را انجام دهید:

  1. قبول شرایط و License Agreement
  2. ورود اطلاعات تماس مدیر سرور؛ ایمیل واقعی برای هشدارها مهم است
  3. بررسی hostname و IP اصلی سرور
  4. تنظیم nameserverها مثل ns1.example.com و ns2.example.com
  5. بررسی resolverها و DNS
  6. فعال‌سازی SSL برای سرویس‌های WHM/cPanel/Webmail
  7. ساخت پکیج هاست و ایجاد اولین اکانت cPanel

پورت‌های مهم cPanel و WHM

پورت کاربرد نکته
22 SSH برای مدیریت سرور؛ بهتر است فقط برای IPهای مدیر باز باشد.
80 / 443 HTTP / HTTPS برای سایت‌ها، AutoSSL و دسترسی وب.
2087 WHM SSL ورود امن مدیر سرور.
2083 cPanel SSL ورود امن کاربران هاست.
2096 Webmail SSL ورود امن وب‌میل.
2089 License برای ارتباط با سرورهای لایسنس cPanel مهم است.
25 / 465 / 587 SMTP برای ارسال ایمیل؛ در بعضی دیتاسنترها پورت 25 بسته است.
110 / 143 / 993 / 995 POP3 / IMAP برای دریافت ایمیل.
53 DNS اگر خود سرور nameserver عمومی ارائه می‌دهد باید بررسی شود.
20 / 21 FTP در صورت امکان SFTP از طریق SSH امن‌تر است.

مشکلات رایج نصب cPanel و راه‌حل‌ها

۱) خطای License File Expired یا مشکل لایسنس

این خطا معمولاً به خاطر فعال نبودن لایسنس، اشتباه بودن IP لایسنس، بسته بودن ارتباط سرور با License Server، اشتباه بودن زمان سرور یا hostname نامعتبر رخ می‌دهد.

date
timedatectl
/usr/local/cpanel/cpkeyclt 2>/dev/null || true

اگر IP سرور NAT یا داینامیک باشد، لایسنس دردسرساز می‌شود. برای cPanel بهتر است IP عمومی و ثابت داشته باشید.

۲) خطای Fatal! Perl must be installed before proceeding

اگر Perl نصب نباشد یا package manager مشکل داشته باشد، نصب ادامه پیدا نمی‌کند. روی AlmaLinux/Rocky این دستور را بزنید:

dnf install -y perl
# یا در برخی سیستم‌ها:
yum install -y perl

روی Ubuntu:

apt update
apt -y install perl-base

۳) خطاهای RPM یا DEB هنگام نصب پکیج‌ها

این خطاها معمولاً به repo خراب، mirror کند، DNS resolver اشتباه، سیستم‌عامل ناسازگار، یا نصب نبودن dependencyها مربوط است. قبل از نصب cPanel مطمئن شوید دستورهای زیر بدون خطا اجرا می‌شوند:

# AlmaLinux/Rocky
dnf clean all
dnf makecache
dnf update -y

# Ubuntu
apt update
apt upgrade -y

۴) بعد از نصب، WHM با پورت 2087 باز نمی‌شود

اول بررسی کنید سرویس cPanel اجراست:

systemctl status cpanel --no-pager
/usr/local/cpanel/scripts/restartsrv_cpsrvd --status 2>/dev/null || true

سپس از داخل سرور تست کنید پورت گوش می‌دهد یا نه:

ss -tulpn | grep -E ':2087|:2083|:2086'

اگر از داخل سرور باز است اما از بیرون نه، فایروال سرور یا فایروال دیتاسنتر پورت را بسته است.

۵) هشدار SSL یا پیام امنیتی مرورگر هنگام ورود

بعد از نصب، ممکن است WHM ابتدا با certificate خودامضا بالا بیاید. اگر hostname به درستی resolve شود، امکان دریافت SSL رایگان برای hostname وجود دارد؛ در غیر این صورت باید hostname را درست کنید یا SSL را دستی نصب کنید.

۶) مشکل hostname در سرورهای ابری

گاهی cloud-init یا DHCP hostname را بعد از reboot تغییر می‌دهد. hostname باید دائمی و FQDN باشد. بررسی کنید:

hostnamectl
cat /etc/hostname
cat /etc/hosts

اگر دیتاسنتر hostname را بازنویسی می‌کند، باید تنظیمات cloud-init یا template سرور را اصلاح کنید.

۷) DNS resolver از بین رفته یا نام‌ها resolve نمی‌شوند

اگر نصب‌کننده در مرحله تنظیم hostname یا DNS warning بدهد، فایل resolver را بررسی کنید:

cat /etc/resolv.conf
ping -c 3 google.com
curl -I https://securedownloads.cpanel.net/latest

می‌توانید resolverهای پایدار مثل resolverهای دیتاسنتر یا 1.1.1.1 و 8.8.8.8 را تنظیم کنید، اما بهتر است با سیاست شبکه سرورتان هماهنگ باشد.

۸) نصب روی سرور غیرخام یا پنل قبلی

اگر قبلاً CyberPanel، DirectAdmin، Plesk، Apache/Nginx دستی، MySQL یا Postfix سنگین نصب شده باشد، احتمال تداخل زیاد است. بهترین راه برای cPanel، نصب روی OS تازه است.

چک‌لیست بعد از نصب برای یک سرور حرفه‌ای

  1. ورود به WHM از پورت 2087 و تکمیل Setup Wizard
  2. تنظیم Contact Email و فعال‌سازی هشدارهای امنیتی
  3. تنظیم nameserverها و glue record در رجیسترار دامنه
  4. فعال کردن AutoSSL و بررسی SSL سرویس‌ها
  5. ساخت Packages برای پلن‌های هاست
  6. ساخت اولین cPanel account و تست ورود کاربر از پورت 2083
  7. بررسی ایمیل، SPF، DKIM و DMARC
  8. نصب و تنظیم CSF یا فایروال مناسب بعد از نصب
  9. برنامه‌ریزی بکاپ روزانه یا هفتگی
  10. تست بروزرسانی cPanel و مانیتور منابع سرور

سوالات متداول نصب cPanel

آیا cPanel روی سرور ایران نصب می‌شود؟

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

آیا cPanel روی Ubuntu نصب می‌شود؟

نسخه‌های جدید cPanel از Ubuntu 24.04 LTS پشتیبانی می‌کنند. با این حال بسیاری از مدیران سرور هنوز AlmaLinux/Rocky/CloudLinux را برای هاستینگ کلاسیک ترجیح می‌دهند.

آیا cPanel با IP داینامیک کار می‌کند؟

برای استفاده واقعی توصیه نمی‌شود. cPanel برای لایسنس به IP عمومی و ثابت نیاز دارد و IP داینامیک باعث خطای لایسنس و قطعی سرویس می‌شود.

اگر نصب خراب شد، چطور cPanel را حذف کنیم؟

cPanel حذف‌کننده رسمی ندارد. راه تمیز، نصب مجدد سیستم‌عامل و شروع از سرور خام است.

برای فروش هاست با cPanel چه منابعی مناسب است؟

برای چند سایت سبک، 2 تا 4 گیگابایت RAM ممکن است کافی باشد، اما برای هاستینگ واقعی، ایمیل، بکاپ و چندین کاربر، بهتر است RAM، CPU و دیسک را با تعداد اکانت‌ها و حجم ایمیل‌ها انتخاب کنید.

جمع‌بندی

نصب cPanel از نظر دستور SSH ساده است، اما کیفیت نصب به آماده‌سازی درست سرور وابسته است. اگر سرور خام، hostname درست، IP ثابت، DNS سالم، لایسنس معتبر و فایروال کنترل‌شده داشته باشید، نصب cPanel معمولاً بدون دردسر انجام می‌شود. در پروژه‌های تجاری، قبل از نصب باید هزینه لایسنس، تعداد اکانت‌ها، سیاست بکاپ، ایمیل و امنیت را هم در نظر بگیرید.

منابع رسمی برای بررسی بیشتر