CyberPanel + OpenLiteSpeed

آموزش نصب کامل CyberPanel از طریق SSH؛ از انتخاب گزینه‌ها تا رفع خطاهای رایج

در این راهنما نصب CyberPanel را از لحظه ورود به SSH تا باز شدن پنل روی پورت 8090 توضیح می‌دهیم. برخلاف آموزش‌های کوتاه، این متن فقط یک دستور نصب نیست؛ در هر مرحله می‌گوییم نصب‌کننده چه سوالی می‌پرسد، جواب پیشنهادی چیست و اگر نصب با خطا روبه‌رو شد از کجا باید مشکل را پیدا کنید.

سطح: متوسطمناسب VPS خامOpenLiteSpeed رایگانرفع خطا و FAQ

CyberPanel چیست و چه زمانی انتخاب خوبی است؟

CyberPanel یک کنترل‌پنل میزبانی وب است که معمولاً همراه OpenLiteSpeed نصب می‌شود. اگر می‌خواهید روی یک سرور مجازی تازه، سایت وردپرسی، فروشگاه اینترنتی، چند دامنه، دیتابیس، ایمیل و SSL را مدیریت کنید، CyberPanel می‌تواند انتخاب سبکی باشد. نسخه OpenLiteSpeed برای تعداد نامحدود دامنه و worker رایگان است، اما نسخه Enterprise با LiteSpeed Enterprise کار می‌کند و برای استفاده جدی به لایسنس نیاز دارد.

پیشنهاد سلام‌سرور: برای شروع، تست، سایت‌های شخصی و پروژه‌های معمولی، گزینه OpenLiteSpeed را انتخاب کنید. اگر پروژه پرترافیک دارید یا دقیقاً به قابلیت‌های LiteSpeed Enterprise نیاز دارید، قبل از نصب درباره لایسنس تصمیم بگیرید.

پیش‌نیازهای مهم قبل از نصب

سرور باید تازه نصب شده باشد

بهتر است هیچ پنل دیگری، Apache، MySQL، PHP دستی یا سرویس میزبانی قبلی روی سرور نصب نباشد. نصب روی سرور آلوده یا قبلاً کانفیگ‌شده معمولاً باعث خطاهای عجیب می‌شود.

ورود با root

نصب CyberPanel باید با کاربر root انجام شود. اگر با کاربر معمولی وارد شده‌اید، از دستور sudo su – استفاده کنید.

سیستم‌عامل مناسب

Ubuntu 20.04/22.04، AlmaLinux 8/9 و CloudLinux از گزینه‌های رایج هستند. برای سرورهای جدید معمولاً Ubuntu 22.04 یا AlmaLinux 9 انتخاب مناسبی است.

حداقل منابع

برای نصب سبک حداقل 1GB RAM و 10GB فضای خالی لازم است، اما برای سایت واقعی بهتر است حداقل 2GB RAM داشته باشید.

مرحله ۱: اتصال به سرور از طریق SSH

از ویندوز می‌توانید با PowerShell، Bitvise، PuTTY یا Windows Terminal وارد سرور شوید. IP سرور را جایگزین کنید:

ssh root@SERVER_IP

اگر اولین بار است وصل می‌شوید، سوال تایید fingerprint نمایش داده می‌شود. عبارت yes را وارد کنید و سپس رمز root را بزنید.

مرحله ۲: آماده‌سازی سیستم‌عامل

Ubuntu / Debian

apt update && apt upgrade -y
apt install curl wget sudo -y
hostnamectl set-hostname panel.example.com
reboot

AlmaLinux / Rocky / CentOS Stream

dnf update -y
dnf install curl wget sudo -y
hostnamectl set-hostname panel.example.com
reboot
بعد از reboot دوباره با SSH وارد شوید و نصب را ادامه دهید. خیلی از خطاهای نصب به‌خاطر آپدیت نبودن سیستم، DNS کند یا نصب روی سیستم‌عامل نیمه‌آماده اتفاق می‌افتد.

مرحله ۳: اجرای دستور نصب CyberPanel

sh <(curl https://cyberpanel.net/install.sh || wget -O - https://cyberpanel.net/install.sh)

اگر به root مستقیم دسترسی ندارید:

sudo su - -c "sh <(curl https://cyberpanel.net/install.sh || wget -O - https://cyberpanel.net/install.sh)"

نصب‌کننده چه سوالاتی می‌پرسد و چه جوابی بدهیم؟

سوال نصب‌کننده جواب پیشنهادی توضیح
Install CyberPanel with OpenLiteSpeed یا LiteSpeed Enterprise؟ برای اکثر کاربران: 1 گزینه 1 نسخه رایگان OpenLiteSpeed است. گزینه 2 برای LiteSpeed Enterprise است و به serial/trial نیاز دارد.
Full Service? Y یا Enter با این گزینه DNS، Mail و FTP هم نصب می‌شوند. اگر فقط وب‌سرور می‌خواهید می‌توانید N بزنید، اما برای کاربران عادی Y بهتر است.
Remote MySQL? N یا Enter برای نصب معمولی دیتابیس روی همان سرور باشد. فقط اگر دیتابیس جداگانه دارید Y بزنید.
CyberPanel Version? Enter آخرین نسخه پایدار نصب می‌شود. فقط برای سازگاری خاص نسخه قدیمی وارد کنید.
Password? s بهتر است خودتان رمز قوی بگذارید، نه رمز پیش‌فرض.
Install Memcached? Y برای کش و بهبود عملکرد سایت‌ها مفید است.
Install Redis? Y برای کش آبجکت وردپرس و پروژه‌های پرترافیک کاربردی است.
Install WatchDog? Y برای مانیتور کردن و ریکاوری سرویس‌ها مفید است، ولی روی سرورهای خیلی ضعیف می‌توان N زد.
Restart server now? Y بعد از نصب، ریبوت باعث بالا آمدن تمیز سرویس‌ها می‌شود.

باز کردن پورت‌های لازم CyberPanel

اگر فایروال دیتاسنتر، Cloud Firewall یا UFW فعال است، پورت‌های اصلی را باز کنید. مهم‌ترین پورت پنل 8090 است.

ufw allow 22/tcp
ufw allow 8090/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw allow 443/udp
ufw allow 21/tcp
ufw allow 40110:40210/tcp
ufw allow 25/tcp
ufw allow 465/tcp
ufw allow 587/tcp
ufw allow 110/tcp
ufw allow 143/tcp
ufw allow 993/tcp
ufw allow 53/tcp
ufw allow 53/udp
ufw reload
اگر ایمیل ارسال نمی‌شود، ممکن است دیتاسنتر پورت 25 را بسته باشد. در این حالت بهتر است برای ارسال ایمیل از SMTP معتبر استفاده کنید.

ورود به پنل بعد از نصب

بعد از نصب موفق، آدرس ورود معمولاً به شکل زیر است:

https://SERVER_IP:8090
Username: admin
Password: رمزی که هنگام نصب تعیین کردید

اگر مرورگر هشدار SSL نشان داد، طبیعی است؛ چون هنوز SSL معتبر برای hostname پنل تنظیم نشده است.

چک‌لیست بعد از نصب

رمز admin را امن نگه دارید

رمز را در جای امن ذخیره کنید و از رمزهای ساده استفاده نکنید.

hostname واقعی تنظیم کنید

مثلاً panel.domain.com و برای آن رکورد A بسازید.

SSL پنل را فعال کنید

بعد از ست شدن DNS، برای پنل SSL معتبر بگیرید تا هشدار مرورگر حذف شود.

بکاپ را جدی بگیرید

قبل از میزبانی سایت واقعی، مسیر بکاپ و سیاست نگهداری را مشخص کنید.

خطاها و مشکلات رایج نصب CyberPanel

خطای 503 بعد از نصب

اول وضعیت سرویس LSCPD را بررسی کنید:

systemctl status lscpd
systemctl start lscpd
systemctl restart lscpd

اگر درست نشد، لاگ نصب را ببینید:

cat /var/log/installLogs.txt | tail -n 100

پورت 8090 باز نمی‌شود

سه احتمال اصلی وجود دارد: فایروال سرور، فایروال دیتاسنتر، یا بالا نبودن سرویس پنل.

ss -tulpn | grep 8090
systemctl status lscpd
ufw status

خطای Unable to fetch Branch name

این خطا معمولاً به ارتباط سرور با مخازن/سرورهای CyberPanel، DNS یا اختلال موقت شبکه مربوط است. DNS سرور را تست کنید و چند دقیقه بعد دوباره نصب را اجرا کنید.

ping -c 4 cyberpanel.net
curl -I https://cyberpanel.net/install.sh
cat /etc/resolv.conf

خطاهای repository در AlmaLinux/CentOS

اگر خطای 404 یا repository گرفتید، سیستم‌عامل را آپدیت کنید، از نسخه‌های EOL استفاده نکنید و نصب را روی OS تازه تکرار کنید.

نصب روی سروری که قبلاً Apache/MySQL داشته

این کار توصیه نمی‌شود. اگر سرور قبلاً پنل یا سرویس میزبانی داشته، بهترین راه rebuild سرور و نصب از صفر است.

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

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

نسخه OpenLiteSpeed رایگان است. نسخه Enterprise با LiteSpeed Enterprise کار می‌کند و برای استفاده بیشتر از محدودیت رایگان نیاز به لایسنس دارد.

آیا روی سرور 1GB RAM نصب کنم؟

برای تست امکان‌پذیر است، اما برای سایت واقعی 2GB RAM یا بیشتر پیشنهاد می‌شود.

اگر رمز admin را فراموش کنم چه کنم؟

از ابزارهای CyberPanel و مستندات رسمی برای reset password استفاده کنید. بهتر است رمز اولیه را همان لحظه نصب در جای امن ذخیره کنید.

آیا CyberPanel برای وردپرس خوب است؟

بله، مخصوصاً همراه OpenLiteSpeed و کش مناسب می‌تواند برای وردپرس عملکرد خوبی داشته باشد، اما کانفیگ امنیتی و بکاپ را نباید نادیده گرفت.

جدول عیب‌یابی سریع CyberPanel هنگام نصب

این بخش برای کاربری نوشته شده که وسط نصب گیر کرده و نمی‌داند مشکل از سرور، فایروال، DNS یا خود سرویس پنل است.

نشانه مشکل علت‌های احتمالی دستور بررسی / راه‌حل
نصب وسط راه متوقف می‌شود آپدیت نبودن OS، DNS ضعیف، mirror خراب، قطع ارتباط با مخزن 
cat /var/log/installLogs.txt | tail -n 150
curl -I https://cyberpanel.net/install.sh
ping -c 4 1.1.1.1
پنل روی 8090 باز نمی‌شود فایروال سرور/دیتاسنتر، اجرا نبودن lscpd، کش مرورگر 
systemctl status lscpd
ss -tulpn | grep 8090
ufw allow 8090/tcp
بعد از ورود، بعضی بخش‌ها خطا می‌دهند نصب ناقص Python/virtualenv یا توقف سرویس‌ها 
systemctl restart lscpd
journalctl -u lscpd -n 100 --no-pager
وب‌سایت ساخته می‌شود ولی باز نمی‌شود DNS دامنه ست نشده، پورت 80/443 بسته است، رکورد A اشتباه است 
dig A example.com +short
curl -I http://example.com
ufw allow 80,443/tcp
SSL صادر نمی‌شود دامنه به IP سرور اشاره نمی‌کند، پورت 80 بسته است، Cloudflare proxy فعال است اول DNS و باز بودن HTTP را چک کنید، سپس مجدداً Issue SSL بزنید.
ایمیل ارسال نمی‌شود پورت 25 دیتاسنتر بسته است یا reverse DNS تنظیم نیست از SMTP Relay معتبر استفاده کنید یا از دیتاسنتر درخواست باز شدن پورت/تنظیم PTR بدهید.

اشتباهات خطرناک در نصب CyberPanel

  • نصب روی سرور production: اگر روی سرور سایت فعال دارید، نصب پنل می‌تواند سرویس‌های قبلی را تغییر دهد. قبل از نصب بکاپ کامل بگیرید.
  • استفاده از رمز ساده admin: پنل 8090 روی اینترنت دیده می‌شود. رمز ضعیف خطر brute force را بالا می‌برد.
  • باز گذاشتن همه پورت‌ها: فقط پورت‌های لازم را باز کنید. باز کردن کل TCP/UDP برای راحتی، ریسک امنیتی دارد.
  • نادیده گرفتن بکاپ: قبل از میزبانی سایت مشتری، مقصد بکاپ خارجی بسازید.
  • استفاده از OS قدیمی: نسخه‌های پایان‌عمر یا mirrorهای خراب، نصب را با خطاهای repository متوقف می‌کنند.

منابع و یادداشت سلام‌سرور

این راهنما بر اساس تجربه عملی نصب روی سرورهای لینوکسی و مستندات نصب CyberPanel نوشته شده است. منبع رسمی: CyberPanel Installation Guide

نیاز به نصب آماده CyberPanel دارید؟

سلام‌سرور می‌تواند سرور مناسب، نصب پنل، تنظیم اولیه فایروال و آماده‌سازی سایت را برای شما انجام دهد.

درخواست مشاوره