Установка

В этом руководстве описаны процедуры чистой установки, безопасного обновления и полного удаления. Оно содержит информацию о необходимых условиях, примеры команд и проверки после установки, чтобы вы могли проверить службы, брандмауэр и DNS перед запуском в эксплуатацию.

Системные требования

  • Новая установка Debian 13 (без существующего веб- или почтового стека)
  • Доступ к серверу с правами root
  • Домен для панели и почты (с записями glue, если вы хостите DNS)
  • PTR (обратный DNS) для имени хоста почты
  • Открытые порты: 22, 80, 443, 25, 465, 587, 993, 995, 53

Установка из GitHub

Запустите установщик с GitHub:

curl -fsSL https://raw.githubusercontent.com/shukiv/jabali-panel/main/install.sh | sudo bash

Дополнительные флаги:

  • JABALI_MINIMAL=1 для установки только ядра
  • JABALI_FULL=1 для принудительной установки всех дополнительных компонентов
  • --debug для подробного вывода

Установщик клонирует панель в /var/www/jabali и настраивает службы, nginx, SSL и необходимые системные пакеты.

Ручная сборка пакетов Debian

Jabali поставляется в виде двух пакетов Debian:

  • jabali-deps для системных зависимостей (nginx, PHP, DB, почта, DNS и т. д.)
  • jabali-panel для панели приложений и служб systemd

Соберите пакеты из корня репозитория:

./scripts/build-jabali-deps-deb.sh
./scripts/build-jabali-panel-deb.sh

Установите на сервере:

sudo dpkg -i ./jabali-deps_<version>_all.deb
sudo apt-get -f install -y
sudo dpkg -i ./jabali-panel_<version>_all.deb

После установки службы systemd включаются и запускаются:

  • jabali-agent
  • jabali-queue
  • jabali-health-monitor

URL-адреса после установки

  • Панель администратора: https://your-host/jabali-admin
  • Панель пользователя: https://your-host/jabali-panel
  • Веб-почта: https://your-host/webmail

Обновления

Если вы установили через GitHub или ручную сборку, из каталога панели:

cd /var/www/jabali
php artisan jabali:upgrade

Только проверка обновлений:

php artisan jabali:upgrade --check

Удалить

Перед удалением сделайте резервные копии данных панели и пользовательского контента.

Остановить и отключить службы:

sudo systemctl stop jabali-agent jabali-queue jabali-health-monitor
sudo systemctl disable jabali-agent jabali-queue jabali-health-monitor

Удалить пакеты (сохранить конфигурации) или очистить (удалить конфигурации):

sudo apt remove jabali-panel jabali-deps
# or
sudo apt purge jabali-panel jabali-deps

Дополнительная очистка (удаляет файлы панели и конфигурации):

sudo rm -rf /var/www/jabali
sudo rm -rf /etc/jabali
sudo rm -rf /etc/nginx/jabali
sudo rm -rf /etc/ssl/jabali
sudo rm -f /root/.jabali_db_credentials
sudo rm -f /root/jabali_credentials.txt

Если вы хотите удалить базу данных панели и пользователя:

sudo mysql -e "DROP DATABASE IF EXISTS jabali;"
sudo mysql -e "DROP USER IF EXISTS jabali@localhost;"

Устранение неполадок

  • Если панель не загружается, убедитесь, что nginx работает и порты 80/443 открыты.
  • Проверьте состояние службы с помощью systemctl status jabali-agent jabali-queue jabali-health-monitor.
  • Просмотрите журналы в storage/logs и вывод системного журнала.