Типичные ошибки установки панелей управления

Краткий ответ: Девять из десяти неудачных установок панелей сводятся к пяти причинам: нечистая ОС (существующие веб/БД-пакеты), неподдерживаемая версия ОС, мало RAM, hostname, не являющийся валидным FQDN, или порт панели, закрытый фаерволом. Начните с чистой ОС, соответствующей требованиям панели, — и инсталляторы «просто работают».

Обзор

Инсталляторы панелей настраивают целые программные стеки, поэтому они строги к стартовым условиям. Эта статья — чек-лист диагностики неудачной или наполовину завершённой установки CloudPanel, CyberPanel, aaPanel, HestiaCP или cPanel на сервере Cloud2Y.

Что нужно иметь

• Экранную ошибку инсталлятора или его лог-файл (при сбое инсталляторы печатают путь к логу).
• Характеристики сервера и версию ОС: cat /etc/os-release, free -h, df -h.

Пошаговая инструкция

1. Проверьте чистоту ОС: если ss -tlnp показывает что-то на :80/:443/:3306 — есть остатки; переустановите ОС вместо ручного удаления.
2. Проверьте поддержку ОС: CloudPanel = Debian/Ubuntu; HestiaCP = Debian/Ubuntu; cPanel/CWP = AlmaLinux/Rocky; CyberPanel/aaPanel = оба семейства. Сверяйте и версию (напр. Ubuntu 22.04/24.04, не 20.04 для новых установок).
3. Проверьте ресурсы: 2 GB+ RAM и 10–20 GB свободного диска; на тесных серверах добавьте swap.
4. Проверьте hostname: hostname -f должен возвращать FQDN (cPanel и панели с почтой этого требуют):

   hostnamectl set-hostname srv1.example.com

5. Проверьте сеть/фаервол: инсталлятору нужен исходящий HTTPS; вам — входящий порт панели (8443 CloudPanel, 8090 CyberPanel, 8888 aaPanel, 8083 HestiaCP, 2087 WHM) — см. гайд по UFW.
6. Исправьте найденное, переустановите ОС, если неудачный запуск оставил частичные пакеты, и запустите инсталлятор снова.

Типичные проблемы

• «Port already in use»: уже работает другой веб-сервер — нужна чистая ОС.
• Инсталлятор убивается в случайных местах: OOM на серверах с малым RAM — смотрите сообщения kill в dmesg, добавьте RAM/swap.
• TLS-ошибки curl/wget: сбитые системные часы — исправьте синхронизацию времени и повторите.
• Панель установлена, но недоступна: она слушает (проверьте ss -tlnp) — блокирует фаервол или сеть вашего офиса.

Когда обращаться в поддержку

Мы охотно переустановим ОС начисто или проверим сеть на стороне сервера — откройте тикет. Отладка внутренностей сторонней панели на неуправляемом сервере — вне рамок поддержки, но мы убедимся, что платформа под ней здорова.

Частые вопросы

Почему инсталлятор пишет, что порт уже занят?

Уже запущен другой веб- или БД-сервер, то есть ОС не чистая. Переустановите операционную систему из Client Area и запустите инсталлятор панели на чистом образе.

Панель установилась, но не открывается — почему?

Если "ss -tlnp" показывает, что панель слушает, — блокирует фаервол: откройте порт панели (8443, 8090, 8888, 8083 или 2087) в UFW/firewalld и проверьте также сеть своего офиса.

Может ли поддержка доустановить панель за меня?

Панели — стороннее ПО на неуправляемом сервере, поэтому их внутренности вне рамок поддержки. Но мы охотно переустановим ОС начисто и проверим, что платформа исправна.

Похожие статьи

• Какую панель управления выбрать?
• Как установить CloudPanel
• Как установить cPanel
• Чек-лист безопасности панели управления

Нужна помощь? Связаться с поддержкой Cloud2Y →