Saltar al contenido
VORQUL
Documentación / VorqulPanel / Instalación y administración

Instala VorqulPanel en un servidor Linux

La mayor parte del tiempo se va esperando la instalación de paquetes y la propagación del DNS, y no en el panel en sí. El orden de abajo es el que evita que te quedes fuera.

Instalar VorqulPanel lleva aproximadamente de 15 a 30 minutos en un servidor Linux limpio. Necesita Debian 12, Ubuntu 22.04 o superior, o AlmaLinux 9, con acceso root y al menos 2 GB de RAM. El panel viene como un único JAR con scripts/install.sh, que instala Java 25 si falta, crea el usuario del servicio, registra la unidad vorqul-panel de systemd y abre los puertos 8765 a 8767. No hay paso de compilación, ni entorno de contenedores, ni base de datos externa. El panel guarda su propio estado en SQLite por defecto.

Tiempo
15 a 30 minutos
Entorno de ejecución
Java 25 o superior, se instala por ti
Distribuciones
Debian 12, Ubuntu 22.04+, AlmaLinux 9
Almacenamiento del panel
SQLite, sin base de datos externa

Requisitos

Requisitos mínimos antes de instalar
RAM 2 GB mínimo
Acceso Root en un servidor limpio
Java 25 o superior, el instalador lo añade
Puertos SSH, 8765 a 8767, 80 y 443
DNS Registro A apuntando al servidor, para los certificados
Entorno de contenedores No es necesario
Requirements for Instalar VorqulPanel: RAM 2 GB mínimo, Acceso Root en un servidor limpio, Java 25 o superior, el instalador lo añade, Puertos SSH, 8765 a 8767, 80 y 443, DNS Registro A apuntando al servidor, para los certificados, Entorno de contenedores No es necesario.

Instalar

Un servidor limpio es un requisito real y más que una recomendación. El panel administra nginx, Apache, BIND9, Postfix, Dovecot, MariaDB y nftables, y todo es mucho más fácil en una máquina donde los instaló él mismo.

  1. Step 01

    Debian 12, Ubuntu 22.04 o superior, o AlmaLinux 9, recién aprovisionado, con acceso root por SSH.

    Se puede instalar en un servidor que ya ejecuta la pila web de otra persona. El instalador no ofrece reinstalar un servidor web, PHP-FPM, MariaDB, certbot, BIND, Postfix o fail2ban que ya estén ahí, y el panel lee los vhosts existentes sin reescribirlos hasta que confirmes una toma de control. Aun así, no es la instalación con la que empezar.

  2. Step 02

    El panel es un único JAR y necesita Java 25 o superior. El instalador lo instala si falta, así que aquí no hay nada que hacer salvo que quieras comprobarlo antes.

    bash
    java -version
  3. Step 03

    Averigua en qué puerto escucha tu demonio SSH y asegúrate de poder volver a entrar. El firewall llega más tarde y necesitará una regla explícita para él.

    Un puerto SSH no estándar junto con un conjunto de reglas de firewall por defecto es la forma clásica de quedarte fuera de una instalación nueva del panel.

Instalar

Un solo script hace toda la instalación. No hay nada que compilar.

  1. Step 04

    La versión es una carpeta con el JAR, un directorio de scripts y las plantillas de unidades de systemd. Ponla en un lugar permanente como /root/vorqul-panel.

    Conserva la carpeta después de instalar. vorqulctl fix-libs y las actualizaciones posteriores la usan. Las bibliotecas de lib/ las descarga el instalador desde Maven Central con verificación de checksum, así que no hace falta copiarlas.

    VorqulPanel está en alfa y todavía no se entrega por correo para pruebas. Cuando se comparta una compilación contigo, el archivo trae los comandos exactos para esa versión. Los pasos de aquí describen lo que hacen esos comandos.

    • vorqul-panel.jar es el panel en sí
    • scripts/install.sh es el instalador y es obligatorio
    • scripts/vorqul-helper es el ayudante de root para puertos del firewall, límites de recursos y servicios
    • scripts/vorqulctl es la herramienta de línea de comandos
    • scripts/vorqul-doctor.sh es un script de diagnóstico opcional
    • systemd/ contiene plantillas de servicio, opcionales porque el instalador tiene su propia copia
  2. Step 05

    Pregunta qué partes quieres, instala lo que falta, crea el usuario del servicio e imprime la URL de configuración de un solo uso.

    • Pregunta qué módulos activar: alojamiento de juegos, alojamiento web, correo
    • Pregunta qué paquetes instalar: nginx o Apache, PHP-FPM, MariaDB, certbot, BIND, Postfix con Dovecot, Rspamd, herramientas de juegos, fail2ban
    • Instala Java si falta y crea el usuario de sistema vorqul
    • Copia el JAR a /opt/vorqul-panel, escribe una configuración con un secreto aleatorio y configura los servicios de systemd
    • Abre los puertos en ufw o firewalld e imprime la URL de configuración
    bash
    sudo bash scripts/install.sh

    El instalador busca el JAR en target/, junto a la raíz del repositorio o junto al script, así que ejecútalo desde la carpeta descomprimida.

  3. Step 06

    Cada pregunta tiene una variable de entorno. Con YES=1 no se pregunta nada y se usan las variables, o los valores por defecto.

    • INSTAL_DIR (por defecto /opt/vorqul-panel), DATA_DIR y LOG_DIR definen dónde viven el JAR, los datos y los registros
    • SYSTEM_USER (por defecto vorqul) es el usuario con el que se ejecuta el panel
    • PORT, SFTP_PORT y SFTP_DAEMON_PORT valen por defecto 8765, 8766 y 8767
    • MOD_GAMES, MOD_WEB y MOD_MAIL valen 1 por defecto y activan las tres partes del panel
    • WEB_SERVER es nginx, apache o none y solo se aplica con MOD_WEB=1
    • INSTALL_PHP, INSTALL_MARIADB, INSTALL_CERTBOT, INSTALL_BIND, INSTALL_MAIL, INSTALL_RSPAMD, INSTALL_FAIL2BAN y INSTALL_GAMETOOLS eligen los paquetes
    • DB_ENGINE es sqlite por defecto, con mysql, postgres y mssql como opciones, y DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASS para la conexión
    • WEB_ADMIN=1 instala el ayudante de root y un archivo sudoers acotado, USE_EXISTING=0 deja que el instalador toque software que ya está instalado
    bash
    sudo YES=1 MOD_MAIL=0 WEB_SERVER=nginx INSTALL_PHP=1 INSTALL_MARIADB=1 INSTALL_CERTBOT=1 bash scripts/install.sh

    La compatibilidad con SQL Server está en beta. SQLite, MySQL, MariaDB y PostgreSQL se han probado con servidores reales. Cambiar db.engine más adelante no mueve ningún dato.

  4. Step 07

    El panel se ejecuta como un servicio de systemd reforzado llamado vorqul-panel. Comprueba que arrancó y lee el journal si no lo hizo.

    bash
    sudo systemctl status vorqul-panel
    sudo vorqulctl status
    sudo vorqulctl logs err

    Si la instalación de paquetes falla durante la configuración, la causa habitual es RestrictSUIDSGID=yes en la unidad, que rompe los scripts posteriores a la instalación.

  5. Step 08

    El instalador abre 8765, 8766 y 8767 en ufw o firewalld. Con nftables sin más, pregunta primero e inserta una regla que no sobrevive a un reinicio.

    Con nftables sin más, añade también tcp dport { 8765, 8766, 8767 } accept a /etc/nftables.conf. Detrás de un proxy inverso solo 80 y 443 deben ser públicos y 8765 debe permanecer cerrado a internet.

    • Panel 8765, SFTP integrado 8766, demonio SFTP 8767, todos tcp
    • Sitios web 80 y 443, correo 25, 587, 465, 143, 993 y 4190, DNS 53 en tcp y udp
    • Cada servidor de juegos abre su propio puerto al crearse, y Hytale usa UDP 5520

Instalar

A partir de aquí todo se hace en el navegador.

  1. Step 09

    Ve a http://your-server:8765/. Mientras no exista un administrador, se abre el formulario de configuración, y el enlace completo lo da el instalador o el comando de abajo.

    bash
    sudo vorqulctl setup-url

    Quien llegue primero al puerto puede crear el administrador. Esa ventana se cierra una hora después de que arranca el panel, y a partir de entonces hace falta el enlace de configuración.

  2. Step 10

    Crea la primera cuenta enseguida y luego activa la autenticación en dos pasos en Settings, Account. Se puede hacer obligatoria para los administradores.

    Si alguna vez pierdes la cuenta de administrador, ejecuta sudo vorqulctl reset-admin y después sudo vorqulctl start. Imprime un enlace de configuración nuevo donde creas otro administrador.

  3. Step 11

    Hasta que se verifique una clave válida, el panel queda bloqueado y te lleva a la página License. Abre /license, introduce la clave y el dominio para el que se emitió, y pulsa Activate.

    Si la página web no está accesible, pon esos mismos dos valores en /opt/vorqul-panel/vorqul-panel.conf como license.key y license.domain, y reinicia el servicio. El servidor necesita HTTPS saliente para llegar al servidor de licencias.

    license.domain debe ser el dominio para el que se emitió la clave. No hay que crear ningún archivo de licencia a mano, porque data/license.json solo guarda en caché la respuesta firmada del servidor.

  4. Step 12

    Settings tiene las pestañas Game hosting, Web hosting y Mail. Desactiva lo que esta máquina no haga. Un interruptor apagado oculta la página y además hace que su API responda 404.

    Apagar una parte no desinstala nada ni borra datos. Services, Manual setup muestra lo que está instalado y lo que falta, con un botón Install para cada elemento.

  5. Step 13

    Primero apunta un registro A al servidor, luego añade el dominio en el panel, pulsa Apply para escribir el vhost y pulsa HTTPS cuando el DNS ya resuelva aquí.

    Los certificados vienen de acme.sh o certbot, y ambos necesitan que el registro DNS resuelva antes de emitirlos. Si el registro se acaba de cambiar, espera a la propagación en lugar de reintentar en bucle.

    Si se emitió un certificado pero el sitio sigue sirviendo HTTP plano, normalmente es un vhost adoptado cuya toma de control aún no se ha confirmado.

  6. Step 14

    Cada Apply ejecuta la prueba de configuración del servidor web con reversión automática. Ejecútala una vez a propósito, para ver cómo es un resultado correcto.

    Esa reversión es la razón por la que un vhost defectuoso no tumba todo el servidor. El panel prueba la configuración nueva antes de recargar y restaura la anterior si la prueba falla.

Comandos

Todo lo que escribes en el servidor. Ejecuta vorqulctl como root o con sudo.

  1. Step 15

    El panel es el servicio vorqul-panel y el demonio SFTP independiente es vorqul-sftp.

    bash
    sudo systemctl status vorqul-panel
    sudo systemctl restart vorqul-panel
    sudo systemctl stop vorqul-panel
    sudo systemctl enable vorqul-panel
    sudo journalctl -u vorqul-panel -n 100 --no-pager
  2. Step 16

    Los comandos cortos que más usarás.

    • vorqulctl status muestra el estado del servicio, el puerto y la versión
    • vorqulctl start, stop y restart controlan el servicio
    • vorqulctl enable y disable deciden si arranca con el sistema
    • vorqulctl logs [tail|follow|err|all] lee el registro del panel, las últimas 100 líneas por defecto
    • vorqulctl info imprime rutas, puertos y el directorio de datos
    • vorqulctl version imprime la versión del panel
  3. Step 17

    Para el primer inicio de sesión, un administrador perdido o una copia rápida de la configuración.

    • vorqulctl setup-url vuelve a imprimir el enlace de configuración del primer arranque
    • vorqulctl reset-admin crea una URL de configuración nueva para una cuenta de administrador nueva y reactiva el inicio de sesión con contraseña
    • vorqulctl config abre el archivo de configuración en un editor
    • vorqulctl backup escribe un tar.gz de la configuración y el directorio de datos en /tmp
  4. Step 18

    Módulos, runtimes, bibliotecas, actualizaciones y desinstalación.

    • vorqulctl modules [games|web|mail on|off] muestra o cambia un módulo junto con sus permisos en el host
    • vorqulctl deps <runtime> instala runtimes como node20, java25 o steamcmd
    • vorqulctl fix-libs vuelve a descargar las bibliotecas de lib/
    • vorqulctl fix-priv reinstala el archivo sudoers, el helper de root y el override de systemd
    • vorqulctl update <jar> instala un JAR nuevo con copia de seguridad, intercambio atómico, reinicio, comprobación de salud y reversión automática
    • vorqulctl uninstall [--purge-data] elimina el panel y conserva los datos salvo que los purgues
    bash
    sudo vorqulctl modules mail on
    sudo vorqulctl update /path/to/vorqul-panel.jar
  5. Step 19

    El panel se ejecuta como un usuario sin privilegios. Todo lo que necesita root pasa por vorqul-helper, que acepta una lista fija de acciones y nada más.

    El helper lee /etc/vorqul-helper.conf, que pertenece a root y lo escribe el instalador. Está recortado a los módulos que elegiste, así que activar un módulo solo en Settings no le da esos permisos al panel. El panel muestra un aviso con el comando, y sudo vorqulctl modules <name> on es ese comando.

    Sean cuales sean los módulos, el panel nunca detiene SSH, nftables, ufw, firewalld ni cron, nunca vacía el firewall ni cambia su política por defecto, solo añade y quita sus propias reglas etiquetadas, y nunca banea nada en fail2ban por su cuenta.

  6. Step 20

    Cuando un servidor no arranca y el registro está vacío, ejecuta el doctor. No se comunica con nada, no cambia nada y ejecuta a mano cada comando del servidor de juego para que veas el error real.

    /healthz devuelve JSON con la versión, el tiempo en marcha, el estado de la base de datos y el número de servidores en ejecución, lo que lo hace un buen objetivo para tu propia monitorización.

    bash
    ./scripts/vorqul-doctor.sh /opt/vorqul-panel
    curl -s http://127.0.0.1:8765/healthz

Referencia

Dónde está cada cosa tras una instalación por defecto.

  1. Step 21

    Todo lo que posee el panel está bajo /opt/vorqul-panel, salvo que hayas cambiado INSTAL_DIR o DATA_DIR.

    • /opt/vorqul-panel contiene el JAR, lib/ y vorqul-panel.conf
    • /opt/vorqul-panel/data contiene la base de datos, los servidores de juego y las copias de seguridad
    • /opt/vorqul-panel/logs contiene vorqul-panel.log
    • /etc/systemd/system/vorqul-panel.service y vorqul-sftp.service son las unidades
    • /usr/local/bin/vorqulctl es la herramienta de línea de comandos
    • /usr/local/sbin/vorqul-helper y /etc/vorqul-helper.conf son el helper de root y su política
    • /etc/sudoers.d/vorqul-panel es el archivo sudoers acotado
  2. Step 22

    Los tres primeros son del panel. El resto depende de qué partes uses.

    • 8765 tcp es la interfaz web y la API
    • 8766 tcp es el SFTP integrado y 8767 tcp es el demonio SFTP independiente
    • 80 y 443 tcp para sitios web y certificados
    • 25, 587, 465, 143, 993 y 4190 tcp para el correo
    • 53 tcp y udp para DNS
    • Cada servidor de juego usa su propio puerto

Referencia

El archivo es /opt/vorqul-panel/vorqul-panel.conf, con un key = value por línea. Casi todo es también un interruptor en Settings, así que rara vez hace falta editarlo a mano. Reinicia el servicio después de cambiarlo.

  1. Step 23

    Las claves que deciden cómo escucha el panel y dónde guarda sus datos.

    • server.host y server.port fijan la dirección y el puerto de escucha
    • server.public.url es la dirección que abre la gente, necesaria para iniciar sesión con Google o Discord
    • server.tls.keystore apunta a un keystore PKCS12 para HTTPS directo
    • data.dir es el directorio de datos
    • db.engine es sqlite, mysql, postgres o mssql, con un bloque db.<engine>.host, port, database, user y password para el que uses
    • security.secret firma las sesiones y lo genera el instalador, así que no lo cambies a la ligera
    • panel.trust.proxies lista los únicos pares autorizados a establecer cabeceras de reenvío
    • cloudflare.mode hace que el panel confíe en CF-Connecting-IP solo desde los rangos de Cloudflare
  2. Step 24

    feature.games, feature.webhosting y feature.mail son los interruptores maestros. Cada uno tiene interruptores hijos, y un hijo solo está activo mientras lo esté su padre.

    • Web: feature.domains, ssl, dns, databases, cache, webconfigs, webfiles, subdomains, websftp, webapps, webstats
    • Mail: feature.mail.dkim, antispam, tls, rules, catchall, autoconfig, delivery, webmail, dnsrecipe
    • Herramientas web: webcron, webbackup, webgit, webruntime
    • terminal.enabled activa el terminal del navegador, desactivado por defecto y solo para administradores con 2FA
  3. Step 25

    Cómo trata el panel a los servidores en ejecución.

    • servers.keepRunning, servers.nice y servers.oomAdjust ajustan cómo sobreviven los servidores y cómo se planifican
    • limits.cgroups activa los límites de cgroup v2, con limits.memory.headroomPercent en 125 por defecto y limits.pids.max desactivado por defecto
    • limits.servers.maxRunning limita cuántos servidores se ejecutan a la vez
    • process.stop.timeout son los segundos que tiene un servidor para guardar al detenerse, 30 por defecto y 150 como máximo
  4. Step 26

    Programaciones y retención para el panel, las copias externas y las copias de los sitios web.

    • backup.panel.cron y backup.panel.retention programan la copia del panel y deciden cuántas se conservan
    • backup.offsite.* describe adónde se envían las copias cifradas
    • web.backup.keep es cuántas copias de sitios web se conservan, 7 por defecto
    • log.level define cuánto escribe el panel en su registro

    Ejecuta el doctor o lee vorqulctl logs err cuando un cambio no parezca aplicarse. Un error tipográfico en el archivo es el motivo habitual.

Funciones

Un mapa breve de la interfaz, para que sepas dónde buscar.

  1. Step 27

    El menú está agrupado por lo que gestiona. Los grupos Web hosting, Mail y Game hosting se pueden desactivar en Settings.

    • Overview es el panel de control con las estadísticas del sistema
    • Web hosting: Websites overview, Domains and sites, DNS zones, Databases, Cache, SSL certificates, Web server configs
    • Mail: Mail y Mail delivery
    • Game hosting: Game overview, Game servers, Scheduler, Backups
    • System, solo para administradores: Services, Nginx, Logs, Cron, Monitoring, Firewall, Security, Fail2ban, Tools, Webhooks, Users, Audit log y Terminal (desactivado por defecto)
    • Account: Settings y Licence para administradores
    • Los usuarios que no son administradores también ven My websites cuando tienen acceso a algún sitio
  2. Step 28

    Más de 240 plantillas con instalación en un clic, consola en vivo, archivos, copias de seguridad, tareas programadas y SFTP por servidor.

    • Minecraft, Hytale, la familia Source, Rust, Valheim, ARK, Palworld, FiveM, bots de Discord, servidores de voz y una sección para herramientas de IA locales
    • El análisis de fallos nombra la causa y la solución, por ejemplo una versión de Java incorrecta o una terminación por falta de memoria
    • Límites de recursos por servidor mediante cgroup v2 en lugar de nice o cpulimit
    • Permisos por usuario, desde View hasta una lista Custom con elementos como consola, encendido, archivos y copias de seguridad
    • Instalación y actualización en un clic, una consola en vivo con entrada de comandos y un gestor de archivos con edición, subida, extracción de zip y tar y chmod
    • Copias de seguridad manuales y programadas, un programador para reinicios, copias y comandos, y una cuenta SFTP con chroot para cada servidor
  3. Step 29

    Vhosts de nginx o Apache, Let's Encrypt, DNS, bases de datos y herramientas por sitio.

    • Dominios para nginx o Apache con HTTPS gratuito de Let's Encrypt, subdominios con la cobertura del certificado a la vista, modo de proxy inverso e importación de sitios existentes
    • Zonas BIND9 validadas antes de recargar y sincronización con Cloudflare
    • Bases de datos y usuarios de MariaDB con importación, exportación y Adminer, además de sugerencias para acelerar una base de datos
    • Versiones, pools y módulos de PHP
    • Herramientas por sitio: ajustes de PHP, protección con contraseña, bloqueo de IP, cron, copias de seguridad, despliegue con git y aplicaciones de Node.js o Python
    • Ajustes de Nginx para todo el servidor y para cada sitio
    • Archivos, cuentas FTP y SFTP por sitio, e instaladores en un clic de Roundcube y phpMyAdmin
    • Redis, Valkey y memcached desde una sola página
  4. Step 30

    Postfix y Dovecot con DKIM, un comprobador de entregabilidad, cola, registro de entregas, comprobaciones de listas de bloqueo y Roundcube.

    Añade el dominio, genera la clave DKIM y publica los registros DNS que muestra el panel. Comprueba que el registro PTR de tu IP coincida con el nombre de host del correo, porque eso se configura donde se alquila la IP y ningún panel puede cambiarlo.

    • Postfix, Dovecot y Rspamd instalados con un solo botón
    • Buzones, alias, catch-all, reenvío y respuestas automáticas de ausencia
    • DKIM, SPF y DMARC, un comprobador de entregabilidad, la cola de correo, el registro de entregas y una comprobación de listas de bloqueo
    • Un certificado TLS en un clic, exportación de registros DNS y publicación en Cloudflare
    • Autoconfiguración para Thunderbird, Outlook y dispositivos Apple
  5. Step 31

    Control de servicios, vigilantes con autorreparación, una página de estado pública, alertas, firewall, análisis de malware, roles y un registro de auditoría.

    • Instala, inicia, detén y lee los registros de nginx, Apache, MariaDB, PHP-FPM y fail2ban, además de un visor de registros, limpieza de registros y un editor de cron
    • Monitores de HTTP, TCP, ping, caducidad de SSL, disco, memoria, CPU y servicios con autorreparación, 30 días de historial y una página de estado pública en /status
    • Webhooks, embeds de Discord y alertas por correo ante fallos, copias de seguridad, poco espacio en disco y certificados a punto de caducar
    • Firewall con ufw, firewalld o nftables, un firewall base opcional con reversión automática y un asistente de configuración de fail2ban
    • Actualización de IP real de Cloudflare y un terminal en el navegador solo para administradores con 2FA
    • Tres roles, Admin, Operator y Viewer, con permisos por servidor de View, Control, Manage o Custom
    • Autenticación en dos pasos TOTP, inicio de sesión con Google o Discord, bloqueo por intentos de acceso, protección CSRF, gestión de sesiones activas y un registro de auditoría con exportación a CSV
    • Análisis de malware con ClamAV, LMD, rkhunter y chkrootkit, y paquetes con cuotas por usuario

Copias de seguridad

Configúralas el primer día. Existen tres tipos y cada uno tiene su lugar en la interfaz.

  1. Step 32

    Las copias del panel, de los servidores de juego y de los sitios web son independientes.

    Según la programación, el panel también descomprime su copia más reciente y abre la base de datos que contiene, lo que demuestra que el archivo se puede restaurar, y no solo que existe.

    • La copia del panel cubre la configuración, la base de datos y las configuraciones del host que gestiona, con una programación cron y retención
    • Las copias de los servidores de juego son manuales o programadas, se verifican tras escribirse, con restauración desde la interfaz y ZIP descargables
    • Las copias de sitios web son un ZIP con los archivos y, opcionalmente, la base de datos, y se pueden subir a otro servidor Vorqul para mover un sitio
  2. Step 33

    Backups, Offsite targets. Las copias se cifran con AES-256-GCM antes de salir del servidor.

    Para leer una copia cifrada por tu cuenta, usa el comando decrypt-backup del JAR.

    • Destinos directos: SSH, SFTP, FTP y S3
    • Google Drive, OneDrive y Dropbox a través de rclone
    bash
    java -jar vorqul-panel.jar decrypt-backup backup.zip.enc backup.zip
  3. Step 34

    Instala rclone, crea un remoto una vez y luego usa ese remoto como destino externo.

    En rclone config crea un remoto llamado gdrive de tipo drive. En un servidor sin navegador, responde no a la pregunta de configuración automática y ejecuta rclone authorize "drive" en tu propio ordenador, luego pega el token que imprime. La línea lsd debería listar tus carpetas de Drive antes de que apuntes el panel hacia él.

    bash
    sudo apt install rclone
    rclone config
    rclone lsd gdrive:
  4. Step 35

    Los servidores de juego y los sitios web se restauran desde la interfaz. La base de datos del panel se restaura a mano con el panel detenido.

    El panel imprime el comando exacto en lugar de reemplazar una base de datos que tiene abierta. La restauración de las configuraciones del host funciona archivo por archivo y conserva una copia .vorqul-pre-restore de lo que reemplaza.

Mantenimiento

Una actualización nunca toca la configuración, la base de datos ni los servidores de juego.

  1. Step 36

    La vía segura. Guarda el JAR y la configuración actuales, intercambia de forma atómica, reinicia, espera a /healthz y revierte si la versión nueva no arranca.

    bash
    sudo vorqulctl update /path/to/vorqul-panel.jar
    sudo vorqulctl fix-libs

    Ejecuta fix-libs después solo cuando la versión nueva necesite bibliotecas nuevas.

  2. Step 37

    Al ejecutar el instalador de nuevo, reconoce la instalación existente, conserva la configuración y renueva lib/, las unidades y el helper.

    Los archivos reemplazados se guardan en el directorio de datos, en backups/_install/, y se conservan las últimas 10 ejecuciones.

    Los servidores de juego en ejecución reciben su propio comando de parada y process.stop.timeout segundos para guardar, luego SIGTERM y, por último, SIGKILL. Vuelven a arrancar cuando el panel regresa, y un reinicio planificado no se informa como un fallo.

    bash
    sudo bash scripts/install.sh
  3. Step 38

    El primer comando elimina los servicios, el helper y las reglas de sudoers, y conserva tus datos. El segundo también borra el directorio de datos y el usuario vorqul después de que escribas DELETE.

    bash
    sudo vorqulctl uninstall
    sudo vorqulctl uninstall --purge-data

    Los paquetes que instaló el panel, los sitios web en /var/www, los buzones y las reglas del firewall se quedan donde están.

Solución de problemas

The failures that actually happen, and what causes them.

Preguntas sobre la instalación

Resumen

Instalar VorqulPanel lleva aproximadamente de 15 a 30 minutos en un servidor Linux limpio. Necesita Debian 12, Ubuntu 22.04 o superior, o AlmaLinux 9, con acceso root y al menos 2 GB de RAM. El panel viene como un único JAR con scripts/install.sh, que instala Java 25 si falta, crea el usuario del servicio, registra la unidad vorqul-panel de systemd y abre los puertos 8765 a 8767. No hay paso de compilación, ni entorno de contenedores, ni base de datos externa. El panel guarda su propio estado en SQLite por defecto.

  • Tiempo: 15 a 30 minutos
  • Entorno de ejecución: Java 25 o superior, se instala por ti
  • Distribuciones: Debian 12, Ubuntu 22.04+, AlmaLinux 9
  • Almacenamiento del panel: SQLite, sin base de datos externa
Términos de esta página

Panel de control de servidores Autoalojado Licencia de pago único Registro de auditoría vorqulctl Helper de root URL de configuración Base de datos del panel Interruptor de módulo Toma de control de vhost Copia de seguridad externa Autenticación en dos pasos

Relacionado

Reviewed