Aether Panel Documentation

Primeros Pasos - Guía Completa

Bienvenido a Aether Panel

Esta guía te llevará paso a paso desde la instalación hasta tener tu primer servidor funcionando. Sigue cada sección en orden para una configuración exitosa.

Requisitos del Sistema

Antes de comenzar, asegúrate de que tu sistema cumpla con los siguientes requisitos:

Hardware y Software
Mínimo
  • Sistema Operativo: Ubuntu 22.04/20.04, Debian 11/10, CentOS 9/8 Stream, Fedora 40/43.
  • Virtualización: KVM, OpenVZ, LXC o servidor dedicado (para los nodos).
  • Software: Docker y Docker Compose (v20.10.0+, opcional).
  • Hardware: 2 vcores de CPU, 2GB de RAM, 5GB de almacenamiento (mínimo).

Es importante tener en cuenta que Aether Panel requiere al menos 2 vcores de CPU, 2GB de RAM y 5GB de almacenamiento solo para funcionar correctamente. Estos requisitos no cubren el uso de los servicios que gestionará en el panel.

Recomendado
  • Sistema Operativo: Ubuntu 22.04/20.04, Debian 11/10, CentOS 9/8 Stream, Fedora 40/43.
  • Virtualización: KVM, OpenVZ, LXC o servidor dedicado (para los nodos).
  • Software: Docker y Docker Compose (v20.10.0+, opcional).
  • Hardware: 2 vcores de CPU, 4GB de RAM, 20GB de almacenamiento.
Puertos Necesarios

Asegúrate de que los siguientes puertos estén disponibles:

  • 8080/TCP: Panel web (HTTP/HTTPS) - Obligatorio
  • 5657/TCP: SFTP para transferencia de archivos - Obligatorio
  • 8081/TCP: Gatus (monitoreo de uptime) - Opcional pero recomendado
  • 22/TCP: SSH para administración - Recomendado cambiar a puerto no estándar
Verificar Requisitos

Antes de instalar, verifica que tienes acceso root o sudo:

sudo whoami

Verifica que los puertos estén libres:

# Verificar puerto 8080
sudo netstat -tuln | grep 8080

# Verificar puerto 5657
sudo netstat -tuln | grep 5657

# Verificar puerto 8081
sudo netstat -tuln | grep 8081

Si algún puerto está en uso, detén el servicio o cambia el puerto en la configuración.

Instalación Paso a Paso

Métodos de Instalación

Aether Panel puede instalarse de tres formas diferentes. Elige la que mejor se adapte a tus necesidades:

  • Instalación Automática con Script (Recomendado): El método más fácil y rápido
  • Instalación con Docker: Ideal para entornos containerizados
  • Instalación Manual: Para usuarios avanzados que quieren control total

Método 1: Instalación Automática con Script

Este es el método más recomendado. El script detecta tu sistema operativo e instala todo automáticamente.

Ejecuta el siguiente comando como root o con sudo para iniciar la instalación:

bash <(curl -s https://install.aetherpanel.es/install.sh)

O descarga el script primero y luego ejecútalo:

# Descargar el script
wget https://install.aetherpanel.es/install.sh

# Dar permisos de ejecución
chmod +x install.sh

# Ejecutar como root
sudo bash install.sh
El script de instalación realizará los siguientes pasos:
  • Detectará automáticamente tu sistema operativo (Ubuntu, Debian, Fedora, CentOS, RHEL)
  • Instalará todas las dependencias necesarias (Go, Node.js, Yarn, etc.)
  • Configurará el firewall y abrirá los puertos necesarios
  • Clonará el repositorio desde GitHub
  • Compilará el frontend y backend
  • Configurará Nginx como proxy reverso
  • Creará el servicio systemd para ejecución automática
  • Te permitirá configurar dominio y SSL con Let's Encrypt
Proceso Interactivo

Durante la instalación, el script te preguntará:

  • Tipo de instalación: ¿Con Docker o sin Docker?
  • Dominio o IP: ¿Quieres usar un dominio o solo IP?
  • SSL: ¿Quieres configurar SSL con Let's Encrypt? (solo si usas dominio)
  • Puertos: ¿Quieres cambiar los puertos por defecto? (opcional)

Método 2: Instalación con Docker

Si prefieres usar Docker, puedes desplegar Aether Panel con Docker Compose. Este método es ideal si ya estás familiarizado con Docker.

Requisitos Previos

Asegúrate de tener Docker y Docker Compose instalados:

# Verificar Docker
docker --version

# Verificar Docker Compose
docker-compose --version

Si no tienes Docker instalado:

Ubuntu/Debian:

# Ubuntu/Debian
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

Fedora/RHEL/CentOS:

# Fedora/RHEL/CentOS
sudo dnf install -y docker docker-compose
sudo systemctl enable docker
sudo systemctl start docker
Pasos para instalar con Docker:

1. Clonar el repositorio

git clone https://github.com/Aether-Panel/Panel.git
cd SkyPanel

Esto descargará todo el código fuente del panel.

2. Configurar base de datos (opcional)

Si quieres usar MySQL externo, edita config.docker.json:

{
  "panel": {
    "database": {
      "dialect": "mysql",
      "url": "usuario:contraseña@tcp(IP:3306)/basedatos?charset=utf8mb4&parseTime=true"
    }
  }
}

Si usas el MySQL del docker-compose.yml, no necesitas cambiar nada.

3. Construir la imagen Docker

docker-compose build

Este proceso puede tardar varios minutos la primera vez, ya que descarga dependencias y compila el panel.

4. Iniciar los contenedores

docker-compose up -d

El flag -d ejecuta los contenedores en segundo plano (detached mode).

5. Verificar que los contenedores estén corriendo

docker-compose ps

Deberías ver los contenedores 'skypanel' y 'skypanel-mysql' (si configuraste MySQL) con estado 'Up'.

6. Ver los logs (opcional)

docker-compose logs -f

Presiona Ctrl+C para salir de los logs.

Configuración de Docker

El docker-compose.yml incluye:

  • Servicio MySQL/MariaDB para la base de datos
  • Servicio SkyPanel con todos los puertos necesarios
  • Volúmenes persistentes para datos y configuración
  • Health checks para verificar el estado de los servicios

Método 3: Instalación Manual (Sin Docker)

Para instalar manualmente sin Docker, necesitas compilar el panel tú mismo. Este método te da control total sobre el proceso.

Instalar Dependencias Manualmente

Ubuntu/Debian

# Actualizar sistema
sudo apt update && sudo apt upgrade -y

# Instalar dependencias básicas
sudo apt install -y git build-essential curl wget sqlite3

# Instalar Go 1.24.4
wget https://go.dev/dl/go1.24.4.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.24.4.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc

# Verificar Go
go version

# Instalar Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Instalar Yarn
sudo npm install -g yarn

# Verificar instalaciones
node --version
yarn --version

Fedora/RHEL/CentOS

# Actualizar sistema
sudo dnf update -y

# Instalar dependencias básicas
sudo dnf install -y git gcc make curl wget sqlite

# Instalar Go 1.24.4
wget https://go.dev/dl/go1.24.4.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.24.4.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc

# Instalar Node.js 22
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo dnf install -y nodejs

# Instalar Yarn
sudo npm install -g yarn
Proceso de Compilación Manual:

1. Clonar el repositorio

git clone https://github.com/Aether-Panel/Panel.git
cd SkyPanel

2. Compilar el frontend

cd client/frontend
yarn install
yarn build

Esto compilará la interfaz web de Vue.js.

3. Compilar el backend

cd ../..
go mod download
go build -o skypanel ./cmd

Esto creará el binario ejecutable 'skypanel'.

4. Crear estructura de directorios

sudo mkdir -p /etc/skypanel
sudo mkdir -p /var/lib/skypanel
sudo mkdir -p /var/log/skypanel
sudo mkdir -p /var/www/skypanel

5. Copiar archivos compilados

sudo cp -r client/frontend/dist/* /var/www/skypanel/
sudo cp skypanel /usr/local/bin/
sudo chmod +x /usr/local/bin/skypanel

6. Crear archivo de configuración

sudo tee /etc/skypanel/config.json > /dev/null <<EOF
{
  "logs": "/var/log/skypanel",
  "panel": {
    "database": {
      "dialect": "sqlite3",
      "url": "file:/var/lib/skypanel/database.db?cache=shared"
    },
    "web": {
      "files": "/var/www/skypanel"
    },
    "gatus": {
      "enable": true
    }
  },
  "daemon": {
    "data": {
      "root": "/var/lib/skypanel"
    }
  }
}
EOF

7. Crear usuario del sistema

sudo useradd -r -m -d /var/lib/skypanel -s /bin/bash skypanel
sudo chown -R skypanel:skypanel /var/lib/skypanel /var/log/skypanel

8. Crear servicio systemd

sudo tee /etc/systemd/system/skypanel.service > /dev/null <<EOF
[Unit]
Description=Aether Panel - Panel de Gestión de Servidores
After=network.target

[Service]
Type=simple
User=skypanel
WorkingDirectory=/var/lib/skypanel
ExecStart=/usr/local/bin/skypanel run
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable skypanel

Verificación de la Instalación

Después de instalar, verifica que todo esté funcionando correctamente:

Verificar Servicio (Instalación Nativa)
# Ver estado del servicio
sudo systemctl status skypanel

# Ver logs en tiempo real
sudo journalctl -u skypanel -f
Verificar Contenedores (Instalación Docker)
# Ver estado de contenedores
docker-compose ps

# Ver logs
docker-compose logs -f skypanel
Verificar Puertos
# Verificar que los puertos estén escuchando
sudo netstat -tuln | grep -E '8080|5657|8081'

# O usar ss
sudo ss -tuln | grep -E '8080|5657|8081'
Verificar Panel Web
# Desde el servidor
curl http://localhost:8080

# O desde tu navegador
# http://TU_IP:8080
Verificar Gatus (Monitoreo)
# Verificar que Gatus esté corriendo
curl http://localhost:8081

# O desde tu navegador
# http://TU_IP:8081

Primer Acceso y Configuración Inicial

Una vez completada la instalación y verificación, es hora de acceder al panel y configurarlo por primera vez.

Acceder al Panel

Abre tu navegador y accede a:

  • Con IP: http://TU_IP:8080
  • Con dominio: https://tu-dominio.com (si configuraste dominio y SSL)

Serás recibido por la pantalla de inicio de sesión.

Paso 1: Crear Usuario Administrador

Antes de poder iniciar sesión, necesitas crear un usuario administrador usando el CLI.

Si instalaste con Docker, ejecuta los comandos dentro del contenedor:

# Entrar al contenedor
docker exec -it skypanel sh

# Crear usuario admin
./SkyPanel/bin/SkyPanel user add --username admin --email admin@example.com --admin

Si instalaste nativamente, ejecuta directamente:

sudo -u skypanel /usr/local/bin/skypanel user add --username admin --email admin@example.com --admin

O desde el directorio de instalación:

./skypanel user add --username admin --email admin@example.com --admin

El sistema te pedirá una contraseña. Elige una contraseña segura.

Parámetros del Comando

  • --username: Nombre de usuario para iniciar sesión
  • --email: Dirección de correo electrónico
  • --admin: Otorga permisos de administrador completo
Paso 2: Iniciar Sesión

Ahora puedes iniciar sesión en el panel:

  1. Abre http://TU_IP:8080 en tu navegador
  2. Ingresa el nombre de usuario que creaste
  3. Ingresa la contraseña
  4. Haz clic en 'Iniciar Sesión'
Comandos CLI Disponibles

Para ver todos los comandos disponibles del CLI de Aether Panel:

./skypanel --help

O desde el contenedor Docker:

docker exec skypanel ./SkyPanel/bin/SkyPanel --help

Gestión de Usuarios

  • ./skypanel user add --username USER --email EMAIL --admin
  • ./skypanel user list
  • ./skypanel user delete --email EMAIL
  • ./skypanel user password --email EMAIL --password NUEVA_PASSWORD

Gestión de Base de Datos

  • ./skypanel db migrate (actualizar esquema de BD)
  • ./skypanel db upgrade (actualizar a nueva versión)

Ejecutar Panel

  • ./skypanel run (iniciar panel en primer plano)
  • ./skypanel version (ver versión)
Paso 3: Configurar Firewall

Si no tienes habilitados los puertos en el firewall, el panel no será accesible desde fuera del servidor.

Ubuntu/Debian (UFW)

# Habilitar UFW si no está activo
sudo ufw enable

# Permitir puertos necesarios
sudo ufw allow 8080/tcp
sudo ufw allow 5657/tcp
sudo ufw allow 8081/tcp

# Verificar reglas
sudo ufw status

Fedora/RHEL/CentOS (firewalld)

# Iniciar firewalld si no está activo
sudo systemctl start firewalld
sudo systemctl enable firewalld

# Permitir puertos necesarios
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --permanent --add-port=5657/tcp
sudo firewall-cmd --permanent --add-port=8081/tcp

# Aplicar cambios
sudo firewall-cmd --reload

# Verificar reglas
sudo firewall-cmd --list-ports
Paso 4: Configuración Inicial en el Panel

Una vez que hayas iniciado sesión, configura los ajustes básicos:

Configuración Básica

  1. Ve a Settings (Configuración) en el menú
  2. Configura la URL del panel (ej: http://TU_IP:8080 o https://tu-dominio.com)
  3. Configura el email del administrador
  4. Configura el nombre de la empresa/organización
  5. Guarda los cambios

Configurar Nodos

Si instalaste en el mismo servidor donde correrán los servidores (nodo local), no necesitas configurar nada más. El nodo local se configura automáticamente.

Si quieres usar nodos remotos:

  1. Ve a Admin → Nodos
  2. Haz clic en 'Crear Nodo'
  3. Ingresa la IP del nodo remoto
  4. Ingresa el puerto del daemon (por defecto 5656)
  5. Ingresa el token de autenticación del daemon
  6. Verifica la conexión
  7. Guarda el nodo

Configurar Discord (Opcional)

Para recibir notificaciones en Discord:

  1. Ve a Settings → Notifications
  2. Ingresa la URL del webhook de Discord
  3. Configura los tipos de notificaciones que quieres recibir
  4. Guarda los cambios

Para crear un webhook de Discord:

  1. Ve a tu servidor de Discord
  2. Configuración del Canal → Integraciones → Webhooks
  3. Crea un nuevo webhook
  4. Copia la URL del webhook
Paso 5: Crear tu Primer Servidor

Ahora estás listo para crear tu primer servidor:

  1. Ve a la sección Servidores
  2. Haz clic en 'Crear Servidor'
  3. Selecciona el nodo donde se ejecutará (o usa el nodo local)
  4. Elige una plantilla (ej: Minecraft Java Edition)
  5. Configura el nombre del servidor
  6. Configura el puerto del servidor
  7. Ajusta los recursos (RAM, CPU) si es necesario
  8. Haz clic en 'Crear'
  9. Espera a que el servidor se instale
  10. Haz clic en 'Iniciar' para arrancar el servidor

¡Felicidades! Ya tienes tu primer servidor funcionando en Aether Panel.

Resumen de la Instalación

Si has seguido todos los pasos, deberías tener:

Checklist de Instalación
  • ✓Aether Panel instalado y funcionando
  • ✓Usuario administrador creado
  • ✓Firewall configurado
  • ✓Panel accesible en http://TU_IP:8080
  • ✓Gatus funcionando en http://TU_IP:8081
  • ✓Configuración básica completada
  • ✓Primer servidor creado (opcional)
Próximos Pasos

Ahora que tienes el panel funcionando, puedes:

  • Explorar todas las funcionalidades del panel
  • Crear más servidores de diferentes tipos
  • Configurar Database Hosts para bases de datos MySQL
  • Añadir usuarios adicionales con permisos específicos
  • Configurar backups automáticos
  • Explorar la API para automatización
  • Leer la documentación completa en las otras secciones
¿Necesitas Ayuda?

Si encuentras problemas durante la instalación:

  • Revisa la sección Troubleshooting en la documentación
  • Verifica los logs del panel
  • Consulta el FAQ para problemas comunes
  • Únete al Discord de la comunidad para obtener ayuda

Configuración Avanzada del Panel

Archivo de Configuración

El archivo de configuración principal se encuentra en:

  • Nativo: /etc/skypanel/config.json (instalación nativa)
  • Docker: /etc/SkyPanel/config.json (dentro del contenedor Docker)

Puedes editar este archivo para personalizar la configuración del panel.

Configuración de Base de Datos

Aether Panel soporta SQLite (por defecto) y MySQL/MariaDB.

SQLite (Por Defecto)

SQLite se configura automáticamente y no requiere configuración adicional. Es ideal para instalaciones pequeñas.

MySQL/MariaDB

Para usar MySQL, edita el archivo de configuración:

{
  "panel": {
    "database": {
      "dialect": "mysql",
      "url": "usuario:contraseña@tcp(host:3306)/basedatos?charset=utf8mb4&parseTime=true"
    }
  }
}

Asegúrate de que la base de datos y el usuario existan antes de iniciar el panel.

Configuración de Puertos

Los puertos por defecto son:

  • 8080: Panel web (HTTP)
  • 5657: SFTP para transferencia de archivos
  • 8081: Gatus (monitoreo de uptime)

Puedes cambiar estos puertos editando el archivo de configuración o las variables de entorno.

Configuración de Gatus (Monitoreo)

Gatus está habilitado por defecto y monitorea automáticamente:

  • El panel principal (http://localhost:8080/api/config)
  • Todos los nodos configurados
  • El uptime y estado de cada servicio

Puedes acceder al dashboard de Gatus en http://TU_IP:8081

Archivo de Configuración

La configuración de Gatus se encuentra en /var/lib/SkyPanel/gatus/config.yaml y se actualiza automáticamente cuando añades o eliminas nodos.

No olvides que Aether Panel es un proyecto en desarrollo open source, si tienes alguna duda o problema al instalar o el comando del instalador no funciona puedes contactarnos en el Discord de Aether Panel.

    Aether Panel