1. مقدمه
اگر پس از نصب cPanel & WHM با خطا یا مشکل مواجه شدید، این راهنما به شما کمک میکند رایجترین مشکلات نصب را شناسایی و برطرف کنید. این مشکلات شامل خطاهای امنیتی، لایسنس، بستهها، Perl، Resolver، نامسرور و موارد دیگر است.
نکته مهم: اگر تمام مراحل این راهنما را انجام دادید و همچنان مشکل دارید، با پشتیبانی cPanel تماس بگیرید. برای ارائه دسترسی، از بخش Grant cPanel Support Access استفاده کنید.
2. خطای گواهی امنیتی (SSL)
مشکل
هنگام ورود پیام زیر نمایش داده میشود:
There is a problem with this website's security certificate.
توضیح
در زمان نصب، cPanel & WHM ابتدا یک گواهی Self-Signed برای Hostname نصب میکند. اگر سرور شما از یک FQDN معتبر استفاده نکند یا نتواند گواهی رایگان Let’s Encrypt دریافت کند، فقط گواهی Self-Signed فعال میماند و مرورگرها آن را معتبر نمیدانند.
راهحل
- ابتدا مطمئن شوید که سرور شما از یک
FQDNمعتبر استفاده میکند. از مسیر زیر آن را تغییر دهید:
WHM » Home » Networking Setup » Change Hostname - اگر ارائهدهنده اجازه دهد، سرور بهصورت خودکار گواهی
Let’s Encryptنصب میکند. - در غیر این صورت، یک گواهی معتبر از مسیر زیر خریداری و نصب کنید:
WHM » Home » SSL/TLS » Purchase and Install an SSL Certificate
3. خطاهای لایسنس
مشکل
نمایش خطاهایی مانند License File Expired در هنگام یا پس از نصب.
توضیح
- لایسنس منقضی شده یا اشتباه تنظیم شده است.
- سرور نمیتواند به سرورهای لایسنس WebPros متصل شود.
Hostnameنامعتبر است.- تاریخ و ساعت سرور اشتباه است.
راهحل
برای رفع مشکل، مراحل موجود در مستند How to Fix License File Errors را دنبال کنید.
4. خطاهای نصب Perl
مشکل
نمایش خطا:
Fatal! Perl must be installed before proceeding!
توضیح
وجود Perl برای اجرای نصب ضروری است. اگر Perl نصب نباشد، نصبکننده تلاش میکند آن را نصب کند:
- در سیستمهای RHEL:
yum -y install perl - در Ubuntu:
apt -y install perl perl-base
اگر نصب موفق نشود، خطا نمایش داده میشود. توصیه میشود نصب Perl را به سیستمعامل بسپارید.
راهحل
- در AlmaLinux، CentOS یا CloudLinux دستور زیر را اجرا کنید:
yum install perl - در Ubuntu دستور زیر را اجرا کنید:
apt -y install perl-base
5. بار پردازنده بالا در Hyper-V
مشکل
سرور بار CPU بالایی گزارش میدهد و گزینه Dynamic Memory در Hyper‑V فعال است.
توضیح
این مشکل به دلیل یک باگ در سیستم sleep interruptibility در Hyper‑V رخ میدهد.
راهحل
برای دریافت پچ و اطلاعات بیشتر به وبسایت LKML مراجعه کنید.
6. خطا در نصب بستهها
مشکل
نصب یک یا چند بسته RPM یا .deb با خطا مواجه میشود.
توضیح
این مشکل میتواند به دلیل مخازن اشتباه، وابستگیهای ناقص یا مشکلات سیستم باشد.
راهحل
- برای رفع خطاهای
RPMبه مستندRPM Installation Failuresمراجعه کنید. - در حال حاضر برای خطاهای
.debدر Ubuntu مستند رسمی وجود ندارد.
7. خطاهای Resolver
مشکل
نمایش هشدار:
The system DNS resolvers went missing when cPanel adjusted the hostname.
توضیح
این خطا زمانی رخ میدهد که Hostname بهدرستی resolve نشود و سیستم مجبور به جایگزینی آن شود. همچنین ممکن است DNS Resolverها حذف شده باشند.
در AlmaLinux 9، Rocky Linux 9 و CloudLinux 9 نصبکننده:
- فایل
/etc/NetworkManager/conf.d/99-cpanel.confرا با محتوای زیر ایجاد میکند:
[main] dns = none - سرویس
NetworkManagerرا ریلود میکند.
سپس فایل قبلی /etc/resolv.conf بازیابی میشود.
راهحل
- Resolverها را از مسیر زیر اصلاح کنید:
WHM » Home » Networking Setup » Resolver Configuration - Hostname را از مسیر زیر بهروزرسانی کنید:
WHM » Home » Networking Setup » Change Hostname
8. مشکل عدم ذخیره Hostname در سرورهای ابری
مشکل
Hostname پس از ریبوت یا تغییرات شبکه ذخیره نمیشود.
توضیح
اسکریپت dhclient ارائهدهنده ابری ممکن است تنظیمات Hostname را بازنویسی کند.
راهحل
مراحل موجود در مستند Cloud-Hosted Hostname Solution را دنبال کنید.
9. مشکلات نصب با ESET
مشکل
برخی سرورها هنگام نصب با ESET File Security دچار خطا میشوند.
توضیح
این مشکل در نسخههای 88 و قبل از cPanel & WHM مشاهده شده است.
راهحل
ESET یک محصول شخصثالث است و cPanel پشتیبانی رسمی ارائه نمیدهد.
10. نصب آزمایشی روی سیستمعاملهای پشتیبانینشده
مقدمه
این روش امکان نصب cPanel & WHM روی سیستمعاملهای پشتیبانینشده را فراهم میکند. این قابلیت از نسخه 102 معرفی شده است.
هشدار: این روش آزمایشی است و ممکن است باعث رفتارهای غیرمنتظره شود. cPanel پشتیبانی رسمی ارائه نمیدهد.
دستور نصب
برای نصب روی سیستمعامل پشتیبانینشده، از دستور زیر استفاده کنید:
sh latest --experimental-os=operatingsystemمثال:
sh latest --experimental-os=almalinux-8.4نتیجهگیری
با اجرای مراحل این راهنما میتوانید اکثر مشکلات نصب cPanel & WHM را برطرف کنید. تنظیم صحیح Hostname، بررسی لایسنس، عملکرد درست yum یا apt و پیکربندی صحیح Resolver نقش مهمی در نصب موفق و پایدار دارند.