Установка CloudPanel на Linux VPS (Ubuntu/Debian)

CloudPanel — бесплатная лёгкая панель управления, которая через веб-интерфейс управляет Nginx, PHP-FPM, базами данных и SSL-сертификатами. Установленная на VPS Linux Infrawire, она за несколько минут превращает пустой сервер в платформу для хостинга нескольких сайтов. Руководство подходит для Ubuntu 24.04 и Debian 12.

📋 Требования

Новый KVM VPS с Ubuntu 24.04 или Debian 12, на котором больше ничего не установлено (ни Apache, ни Nginx, ни MySQL, ни другой панели).
Не менее 2 ГБ ОЗУ и SSH-доступ под root. IP-адрес и пароль root от VPS вы найдёте в личном кабинете.
Домен, у которого A-запись DNS (и AAAA, если вы используете IPv6) указывает на 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. Сертификат самоподписанный, поэтому браузер покажет предупреждение: примите его для первого входа.

Администратора создаёт первый посетитель, поэтому сделайте это сразу. Укажите имя пользователя, e-mail и длинный пароль, затем войдите. Не оставляйте панель открытой на несколько часов до создания учётной записи.

🌐 4. Добавление PHP-сайта

В панели нажмите Sites, затем Add Site и Create a PHP Site. Выберите шаблон приложения (Generic, WordPress, Laravel и т. д.), введите example.com в качестве домена, выберите версию PHP и задайте пользователя и пароль сайта. CloudPanel создаст vhost Nginx, пул 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.