راهنمای رفع مشکلات نصب cPanel & WHM

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 نقش مهمی در نصب موفق و پایدار دارند.