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: Linux (Ubuntu 20.04+, Debian 11+, CentOS 8+).
Arquitectura: amd64 o arm64.
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).

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
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

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-plugin
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 Panel

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

4. Iniciar los contenedores

docker compose up -d

5. Verificar que los contenedores estén corriendo

docker compose ps

6. Ver los logs (opcional)

docker compose logs -f

Configuración de Docker

El docker-compose.yml incluye:

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

Opción rápida: Usar imagen pre-construida

Si prefieres no compilar desde el código fuente, puedes usar la imagen pre-construida de Docker:

docker run -d \
  --name skypanel \
  -p 8080:8080 \
  -p 5657:5657 \
  -v skypanel-config:/etc/SkyPanel \
  -v skypanel-data:/var/lib/SkyPanel \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --restart=always \
  ghcr.io/aether-panel/panel:latest

Este comando descargará la imagen más reciente y ejecutará el panel con persistencia de datos.

Opción con Docker Compose (simplificada)

También puedes usar este docker-compose.yml simplificado:

services:
  skypanel:
    image: ghcr.io/aether-panel/panel:latest
    ports:
      - "8080:8080"
      - "5657:5657"
    volumes:
      - ./config:/etc/SkyPanel
      - ./data:/var/lib/SkyPanel
      - /var/run/docker.sock:/var/run/docker.sock
    restart: always

Inicia el servicio con: docker compose up -d

Crear Usuario Administrador (Docker)

Una vez que el contenedor esté corriendo, ejecuta este comando para crear tu cuenta de administrador:

docker exec -it skypanel /SkyPanel/bin/SkyPanel user add --name admin --email admin@example.com --password 'admin123' --admin

Recuerda cambiar admin@example.com y admin123 por tus datos reales.

Post-Instalación

Una vez instalado, el panel estará accesible en:

http://<IP-DE-SU-SERVIDOR>:8080

Inicia sesión con las credenciales de administrador creadas durante el proceso de instalación.

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.25.0
wget https://go.dev/dl/go1.25.0.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.0.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.25.0
wget https://go.dev/dl/go1.25.0.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.0.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 Panel

2. Compilar el frontend

cd client/frontend
yarn install
yarn build

3. Compilar el backend

cd ../..
go mod download
go build -o SkyPanel ./cmd/panel

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/aetherpanel

5. Copiar archivos compilados

sudo cp -r client/frontend/dist/* /var/www/aetherpanel/
sudo cp SkyPanel /usr/sbin/
sudo chmod +x /usr/sbin/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/aetherpanel"
    }
  },
  "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/sbin/SkyPanel runService --config /etc/SkyPanel/config.json
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'

# O usar ss
sudo ss -tuln | grep -E '8080|5657'

Verificar Panel Web

# Desde el servidor
curl http://localhost:8080

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

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 --name admin --email admin@example.com --admin

Si instalaste nativamente, ejecuta directamente:

sudo -u skypanel /usr/sbin/SkyPanel user add --name admin --email admin@example.com --admin

O desde el directorio de instalación:

SkyPanel user add --name 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:

Abre http://TU_IP:8080 en tu navegador
Ingresa el nombre de usuario que creaste
Ingresa la contraseña
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 --name USER --email EMAIL --admin

SkyPanel user add --name USER --email EMAIL --password PASS (no interactivo)

SkyPanel user edit (menú interactivo para cambiar username/email/password/admin/2FA)

Gestión de Base de Datos

SkyPanel db migrate (actualizar esquema de BD)

SkyPanel db upgrade (actualizar a nueva versión)

Ejecutar Panel

SkyPanel runService (iniciar como servicio con systemd notify)

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

Ve a Settings (Configuración) en el menú
Configura la URL del panel (ej: http://TU_IP:8080 o https://tu-dominio.com)
Configura el email del administrador
Configura el nombre de la empresa/organización
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:

Ve a Admin Nodos
Haz clic en 'Crear Nodo'
Ingresa la IP del nodo remoto
Ingresa el puerto del daemon (por defecto 5656)
Ingresa el token de autenticación del daemon
Verifica la conexión
Guarda el nodo

Configurar Discord (Opcional)

Para recibir notificaciones en Discord:

Ve a Settings Notifications
Ingresa la URL del webhook de Discord
Configura los tipos de notificaciones que quieres recibir
Guarda los cambios

Para crear un webhook de Discord:

Ve a tu servidor de Discord
Configuración del Canal Integraciones Webhooks
Crea un nuevo webhook
Copia la URL del webhook

Paso 5: Crear tu Primer Servidor

Ahora estás listo para crear tu primer servidor:

Ve a la sección Servidores
Haz clic en 'Crear Servidor'
Selecciona el nodo donde se ejecutará (o usa el nodo local)
Elige una plantilla (ej: Minecraft Java Edition)
Configura el nombre del servidor
Configura el puerto del servidor
Ajusta los recursos (RAM, CPU) si es necesario
Haz clic en 'Crear'
Espera a que el servidor se instale
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
✓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

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

AnteriorConceptos Clave SiguienteUso del Panel

Primeros Pasos - Guía Completa

Bienvenido a Aether Panel

Requisitos del Sistema

Hardware y Software

Recomendado

Puertos Necesarios

Verificar Requisitos

Instalación Paso a Paso

Métodos de Instalación

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

El script de instalación realizará los siguientes pasos:

Proceso Interactivo

Método 2: Instalación con Docker

Requisitos Previos

Pasos para instalar con Docker:

1. Clonar el repositorio

2. Configurar base de datos (opcional)

3. Construir la imagen Docker

4. Iniciar los contenedores

5. Verificar que los contenedores estén corriendo

6. Ver los logs (opcional)

Configuración de Docker

Opción rápida: Usar imagen pre-construida

Opción con Docker Compose (simplificada)

Crear Usuario Administrador (Docker)

Post-Instalación

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

Instalar Dependencias Manualmente

Ubuntu/Debian

Fedora/RHEL/CentOS

Proceso de Compilación Manual:

1. Clonar el repositorio

2. Compilar el frontend

3. Compilar el backend

4. Crear estructura de directorios

5. Copiar archivos compilados

6. Crear archivo de configuración

7. Crear usuario del sistema

8. Crear servicio systemd

Verificación de la Instalación

Verificar Servicio (Instalación Nativa)

Verificar Contenedores (Instalación Docker)

Verificar Puertos

Verificar Panel Web

Primer Acceso y Configuración Inicial

Acceder al Panel

Paso 1: Crear Usuario Administrador

Parámetros del Comando

Paso 2: Iniciar Sesión

Comandos CLI Disponibles

Gestión de Usuarios

Gestión de Base de Datos

Ejecutar Panel

Paso 3: Configurar Firewall

Ubuntu/Debian (UFW)

Fedora/RHEL/CentOS (firewalld)

Paso 4: Configuración Inicial en el Panel

Configuración Básica

Configurar Nodos

Configurar Discord (Opcional)

Paso 5: Crear tu Primer Servidor

Resumen de la Instalación

Checklist de Instalación

Próximos Pasos

¿Necesitas Ayuda?

Configuración Avanzada del Panel

Archivo de Configuración

Configuración de Base de Datos

SQLite (Por Defecto)

MySQL/MariaDB

Configuración de Puertos