Instalación

Esta guía le guía a través de una instalación limpia, actualizaciones seguras y una eliminación limpia. Incluye requisitos previos, ejemplos de comandos y comprobaciones posteriores a la instalación para que pueda validar los servicios, el cortafuegos y el DNS antes de ponerlo en marcha.

Requisitos del sistema

  • Instalación nueva de Debian 13 (sin pila web o de correo preexistente)
  • Acceso root al servidor
  • Un dominio para el panel y el correo (con registros glue si aloja DNS)
  • PTR (DNS inverso) para el nombre de host del correo
  • Puertos abiertos: 22, 80, 443, 25, 465, 587, 993, 995, 53

Instalación desde GitHub

Ejecute el instalador desde GitHub:

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

Opciones opcionales:

  • JABALI_MINIMAL=1 para la instalación solo del núcleo
  • JABALI_FULL=1 para forzar todos los componentes opcionales
  • --debug para salida detallada

El instalador clona el panel a /var/www/jabali y configura los servicios, nginx, SSL y los paquetes del sistema necesarios.

Compilación manual de paquetes Debian

Jabali se distribuye en dos paquetes Debian:

  • jabali-deps para las dependencias del sistema (nginx, PHP, DB, correo, DNS, etc.)
  • jabali-panel para la aplicación del panel y los servicios systemd

Compile los paquetes desde la raíz del repositorio:

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

Instalar en el servidor:

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

Después de la instalación, los servicios systemd se habilitan y se inician:

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

URL tras la instalación

  • Panel de administración: https://your-host/jabali-admin
  • Panel de usuario: https://your-host/jabali-panel
  • Correo web: https://your-host/webmail

Actualizaciones

Si instaló a través de GitHub o compilación manual, desde el directorio del panel:

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

Buscar solo actualizaciones:

php artisan jabali:upgrade --check

Desinstalar

Antes de desinstalar, haga copias de seguridad de los datos del panel y del contenido del usuario.

Detener y desactivar servicios:

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

Elimine los paquetes (conserve las configuraciones) o purgue (elimine las configuraciones):

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

Limpieza opcional (elimina los archivos y las configuraciones del panel):

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

Si desea eliminar la base de datos del panel y el usuario:

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

Solución de problemas

  • Si el panel no se carga, confirme que nginx se está ejecutando y que los puertos 80/443 están abiertos.
  • Compruebe el estado del servicio con systemctl status jabali-agent jabali-queue jabali-health-monitor.
  • Revise los registros en storage/logs y la salida del diario del sistema.