آموزش کامل نصب cPanel و WHM با SSH؛ پیشنیازها، مراحل نصب و رفع خطاهای رایج
آموزش کامل نصب cPanel و WHM روی سرور لینوکس
در این راهنما نصب cPanel و WHM را از مرحله انتخاب سرور خام تا ورود به WHM، تنظیم hostname، بررسی لایسنس، باز کردن پورتها و رفع خطاهای رایج نصب بررسی میکنیم.
خلاصه سریع: cPanel یک کنترلپنل تجاری و بسیار حرفهای برای فروش هاست، مدیریت اکانتهای میزبانی، ایمیل، DNS، دیتابیس، SSL و مهاجرت سایت است. نصب آن معمولاً با یک دستور SSH انجام میشود، اما موفقیت نصب به پیشنیازهایی مثل سیستمعامل پشتیبانیشده، IP ثابت عمومی، hostname درست، لایسنس معتبر، RAM کافی و فایروال درست وابسته است.
فهرست مطالب
آیا cPanel رایگان است؟
پیشنیازهای نصب
چکلیست قبل از نصب
دستور نصب با SSH
مراحل بعد از نصب در WHM
پورتهای مهم cPanel
خطاها و مشکلات رایج
سوالات متداول
cPanel و WHM چیست و چه تفاوتی دارند؟
WHM بخش مدیریتی سرور است؛ مدیر سرور در WHM میتواند پکیج بسازد، اکانت هاست ایجاد کند، DNS و SSL و سرویسها را مدیریت کند و تنظیمات امنیتی را انجام دهد. cPanel بخش کاربری است؛ مشتری یا صاحب سایت از داخل cPanel فایلها، دیتابیس، ایمیل، سابدامین، SSL و بکاپ سایت خودش را مدیریت میکند.
برای مدیر سرور، شرکت هاستینگ، ریسلر یا مدیر فنی است.
برای کاربر نهایی هر هاست است؛ یعنی کسی که سایتش روی سرور میزبانی میشود.
آیا 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 را انجام دهید:
- قبول شرایط و License Agreement
- ورود اطلاعات تماس مدیر سرور؛ ایمیل واقعی برای هشدارها مهم است
- بررسی hostname و IP اصلی سرور
- تنظیم nameserverها مثل ns1.example.com و ns2.example.com
- بررسی resolverها و DNS
- فعالسازی SSL برای سرویسهای WHM/cPanel/Webmail
- ساخت پکیج هاست و ایجاد اولین اکانت 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 تازه است.
چکلیست بعد از نصب برای یک سرور حرفهای
- ورود به WHM از پورت 2087 و تکمیل Setup Wizard
- تنظیم Contact Email و فعالسازی هشدارهای امنیتی
- تنظیم nameserverها و glue record در رجیسترار دامنه
- فعال کردن AutoSSL و بررسی SSL سرویسها
- ساخت Packages برای پلنهای هاست
- ساخت اولین cPanel account و تست ورود کاربر از پورت 2083
- بررسی ایمیل، SPF، DKIM و DMARC
- نصب و تنظیم CSF یا فایروال مناسب بعد از نصب
- برنامهریزی بکاپ روزانه یا هفتگی
- تست بروزرسانی 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 معمولاً بدون دردسر انجام میشود. در پروژههای تجاری، قبل از نصب باید هزینه لایسنس، تعداد اکانتها، سیاست بکاپ، ایمیل و امنیت را هم در نظر بگیرید.
شما میتوانید دیدگاه خود را در مورد این مطلب با ما به اشتراک بگذارید.