نصب CloudPanel روی VPS لینوکس (Ubuntu/Debian)

CloudPanel یک کنترل پنل رایگان و سبک است که Nginx، PHP-FPM، پایگاه‌های داده و گواهی‌های SSL را از طریق رابط وب مدیریت می‌کند. وقتی روی یک VPS لینوکس Infrawire نصب شود، سرور خالی را در چند دقیقه به پلتفرم میزبانی چندسایتی تبدیل می‌کند. این راهنما Ubuntu 24.04 و Debian 12 را پوشش می‌دهد.

📋 پیش‌نیازها

• یک VPS از نوع KVM کاملاً تازه با Ubuntu 24.04 یا Debian 12 که هیچ نرم‌افزار دیگری روی آن نصب نیست (نه Apache، نه Nginx، نه MySQL و نه پنل دیگر).
• دست‌کم ۲ گیگابایت رم و دسترسی SSH با کاربر root. در بخش مشتریان، IP و رمز root سرور را پیدا می‌کنید.
• یک نام دامنه که رکورد DNS از نوع A آن (و در صورت استفاده از IPv6، رکورد AAAA) به VPS_IP اشاره کند.
• پورت‌های 22، 80، 443 و 8443 از اینترنت در دسترس باشند.

🔄 1. آماده‌سازی سیستم

با کاربر root وصل شوید و بسته‌ها را به‌روزرسانی کنید. CloudPanel به curl، wget و sudo نیاز دارد.

Bash
1ssh root@VPS_IP
2apt update && apt -y upgrade && apt -y install curl wget sudo

اگر هسته به‌روزرسانی شده است، پیش از ادامه با reboot سرور را راه‌اندازی مجدد کنید و دوباره وصل شوید.

⬇️ 2. اجرای نصب‌کننده رسمی

ابتدا نصب‌کننده دانلود می‌شود و پیش از اجرا، چک‌سام SHA-256 آن بررسی می‌شود. این چک‌سام با هر نسخه نصب‌کننده تغییر می‌کند: مقدار فعلی و فهرست به‌روز موتورهای پایگاه داده را از صفحه رسمی https://www.cloudpanel.io/docs/v2/getting-started/other/ کپی کنید (به‌جای SHA256_FROM_DOCS در زیر).

Bash
1curl -sS https://installer.cloudpanel.io/ce/v2/install.sh -o install.sh
2echo "SHA256_FROM_DOCS install.sh" | sha256sum -c
3sudo CLOUD_PANEL_DB_ENGINE=MARIADB_11.4 bash install.sh

متغیر CLOUD_PANEL_DB_ENGINE سرور پایگاه داده را انتخاب می‌کند. مقادیر مستند‌شده MYSQL_8.4، MYSQL_8.0، MARIADB_11.4 و MARIADB_10.11 هستند. اگر آن را ندهید، نصب‌کننده مقدار پیش‌فرض خود را به کار می‌برد. دستور sha256sum -c باید install.sh: OK چاپ کند؛ اگر FAILED دیدید، متوقف شوید و فایل را دوباره دانلود کنید. نصب چند دقیقه طول می‌کشد.

🔑 3. ساخت نخستین حساب مدیر

آدرس https://VPS_IP:8443 را در مرورگر باز کنید. گواهی خودامضا است و مرورگر هشدار می‌دهد: برای این ورود نخست آن را بپذیرید.

نخستین بازدیدکننده مدیر را می‌سازد، پس همین الان این کار را انجام دهید. نام کاربری، ایمیل و یک رمز بلند وارد کنید و وارد شوید. پنل را پیش از ساخت حساب ساعت‌ها در معرض دید رها نکنید.

🌐 4. افزودن سایت PHP

در پنل روی Sites و سپس Add Site و Create a PHP Site کلیک کنید. یک قالب برنامه (Generic، WordPress، Laravel و غیره) انتخاب کنید، example.com را به‌عنوان دامنه بنویسید، نسخه PHP را برگزینید و کاربر و رمز سایت را تعیین کنید. CloudPanel یک vhost برای Nginx، یک pool برای PHP-FPM و یک کاربر سیستمی اختصاصی برای سایت می‌سازد.

فایل‌ها را با SFTP و با کاربر سایت (نه root) در مسیر /home/USER/htdocs/example.com بارگذاری کنید. می‌توانید از بخش Databases برای سایت پایگاه داده هم بسازید.

🔒 5. صدور گواهی Let's Encrypt

بررسی کنید که example.com از قبل به VPS_IP اشاره می‌کند:

Bash
1dig +short example.com

سپس سایت را باز کنید، به زبانه SSL/TLS بروید، روی Actions کلیک کنید و New Let's Encrypt Certificate را انتخاب کنید. نام‌های دامنه مورد نظر را انتخاب و تأیید کنید. تمدید به‌طور خودکار توسط CloudPanel انجام می‌شود.

🛡️ 6. امن‌سازی پنل

• در Admin Area > Security > Firewall پورت 8443 را فقط به IP خودتان محدود کنید و قاعده‌ای را که دسترسی از همه‌جا را مجاز می‌کند حذف کنید. پورت‌های 22، 80 و 443 را بسته به نیاز باز نگه دارید.
• در Admin Area > Security قابلیت Basic Auth را برای پنل به‌عنوان لایه دوم فعال کنید.
• در پروفایل کاربری خود احراز هویت دومرحله‌ای را فعال کنید.
• از رمز بلند و منحصربه‌فرد استفاده کنید و سیستم را به‌روز نگه دارید:

Bash
1apt update && apt -y upgrade

✅ 7. بررسی نصب

Bash
1ss -tlnp | grep -E ':(80|443|8443)\b'
2systemctl is-active nginx clp-agent
3curl -I https://example.com

پورت‌های 80، 443 و 8443 باید در حال گوش دادن باشند، هر دو سرویس باید active پاسخ دهند و دستور آخر باید HTTP 200 یا یک ریدایرکت با گواهی معتبر برگرداند.

🧰 عیب‌یابی

• نصب‌کننده اجرا نمی‌شود یا وسط کار شکست می‌خورد: CloudPanel باید روی سیستم تمیز نصب شود. اگر وب‌سرور یا پایگاه داده دیگری از قبل بوده، سیستم‌عامل را از بخش مشتریان دوباره نصب کنید و از اول شروع کنید.
• پورت 8443 پاسخ نمی‌دهد: بررسی کنید فایروال (قواعد پنل و هر فایروال دیگر) آن را مجاز کرده و IP شما از فهرست مجاز حذف نشده باشد. روی سرور ss -tlnp | grep 8443 را اجرا کنید.
• Let's Encrypt شکست می‌خورد: دامنه هنوز به VPS اشاره نمی‌کند یا یک پراکسی IP واقعی را پنهان کرده است. رکورد DNS را اصلاح کنید، منتظر انتشار بمانید و دوباره تلاش کنید. پورت 80 باید باز باشد.
• رمز مدیر فراموش شده: آن را از شل با clpctl user:reset:password --userName='admin' --password='NEW_PASSWORD' بازنشانی کنید.

---

🎉 CloudPanel در حال اجراست: سایت‌هایتان را اضافه کنید، پورت 8443 را امن کنید و از یک محیط میزبانی تمیز روی VPS خود لذت ببرید.