Servidor de aplicaciones · 9 min read · Sep 08, 2025

Cómo instalar el servidor de aplicaciones WildFly con Nginx como proxy inverso en Debian 12

WildFly, anteriormente JBoss, es un servidor de aplicaciones gratuito y de código abierto que te ayuda a construir y desplegar aplicaciones web en Java. Está escrito en Java y cumple con las especificaciones de Java EE (Edición Empresarial). WildFly fue creado por JBoss, pero ahora es desarrollado por RedHat. Es un servidor de aplicaciones poderoso, listo para producción, modular y ligero que proporciona todas las herramientas y características necesarias para ejecutar y desplegar aplicaciones web en Java.

WildFly es un servidor de aplicaciones multiplataforma que proporciona herramientas para aplicaciones Java como EJBs, JPA, Servlets, JAX-RS, Batch y seguridad.

En esta guía, aprenderás a instalar WildFly o el entorno de ejecución de JBoss en un servidor Debian 12 paso a paso. Instalarás WildFly, habilitarás la consola de administración, crearás un usuario administrador de WildFly e instalarás y configurarás Nginx como un proxy inverso.

Requisitos previos

Antes de continuar, reúne lo siguiente:

  • Un servidor Debian 12 con 4GB o más de memoria.
  • Un usuario no root con privilegios de administrador sudo.

Instalando Java OpenJDK

WildFly es un entorno de ejecución de aplicaciones Java flexible y ligero para construir aplicaciones. En esta sección, instalarás y usarás Java OpenJDK 17 para instalar WildFly en tu servidor Debian.

Primero, ejecuta el siguiente comando para actualizar tu repositorio de Debian.

sudo apt update

Ahora, instala el paquete Java OpenJDK ejecutando el siguiente comando. Esto instalará el paquete default-jdk, que es equivalente a la versión Java OpenJDK 17 LTS (Soporte a Largo Plazo).

sudo apt install default-jdk

Ingresa y para proceder con la instalación.

instalar java openjdk

Después de haber instalado Java, verifica la versión de Java usando el siguiente comando. Deberías ver que Java OpenJDK 17 está instalado.

java -version

verificando la versión de java

Instalando y configurando WildFly

Después de haber instalado Java OpenJDK, ahora puedes comenzar la instalación de WildFly completando las siguientes tareas:

  • Agregar usuario y grupo wildfly
  • Descargar el paquete binario de WildFly
  • Configurar la instalación de WildFly
  • Ejecutar WildFly como un servicio Systemd

Comencemos.

Agregando usuario y grupo wildfly

Primero, crearás un nuevo usuario y grupo del sistema llamado wildfly que se utilizará para ejecutar tu instalación de WildFly.

Ejecuta el siguiente comando para agregar un nuevo grupo y usuario llamado wildfly ejecutando el siguiente comando. Con esto, también configurarás el directorio de inicio predeterminado para los usuarios wildfly a /opt/wildfly, que se utilizará como el directorio de instalación de WildFly.

sudo groupadd -r wildfly  
sudo useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly

Descargando el paquete binario de WildFly

Después de agregar un usuario systemd, descargarás el paquete binario de WildFly a través de wget. Asegúrate de visitar la página de descarga de WildFly para obtener la última versión.

Antes de eso, instala unzip mediante el siguiente comando apt.

sudo apt install unzip -y

Después de eso, visita la página de descarga de WildFly y copia el enlace a la última versión de WildFly. Descarga el paquete binario de WildFly a través del comando wget como el siguiente. En este ejemplo, instalarás WildFly 30.0.0.

wget https://github.com/wildfly/wildfly/releases/download/30.0.0.Final/wildfly-30.0.0.Final.zip

A continuación, descomprime el paquete binario de WildFly y mueve el directorio extraído a /opt/wildfly.

unzip wildfly-30.0.0.Final.zip  
sudo mv wildfly-30.0.0.Final /opt/wildfly

Por último, ejecuta el siguiente comando para cambiar la propiedad del directorio /opt/wildfly al usuario wildfly.

sudo chown -RH wildfly: /opt/wildfly

Configurando la instalación de WildFly

En este ejemplo, instalarás WildFly en una sola máquina en modo independiente. Así que, cada configuración que modifiques aquí está relacionada con las configuraciones independientes de WildFly.

Lanza el siguiente comando del editor nano para abrir el archivo /opt/wildfly/bin/standalone.conf.

sudo nano /opt/wildfly/bin/standalone.conf

Cambia el valor Xmx512m dentro de la variable de entorno JBOSS_JAVA_SIZING para aumentar el tamaño máximo de memoria heap predeterminado de WildFly, de la siguiente manera.

Asegúrate de ajustar el tamaño máximo de memoria heap con tu servidor actual. El siguiente ejemplo establece el tamaño máximo de memoria heap en 4GB.

  JBOSS_JAVA_SIZING="-Xms64m -Xmx4096m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m"

Guarda y cierra el archivo cuando hayas terminado.

Ahora crea un nuevo directorio de configuración /etc/wildfly usando el siguiente comando.

sudo mkdir -p /etc/wildfly

Copia el archivo de configuración de WildFly a /etc/wildfly/wildfly.conf y ábrelo usando el siguiente comando del editor nano.

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/  
sudo nano /etc/wildfly/wildfly.conf

Cambia el WILDFLY_BIND predeterminado a 127.0.0.1 y agrega una variable WILDFLY_CONSOLE_BIND para habilitar la administración de la consola de WildFly. Tanto WildFly como la consola de administración se ejecutarán en localhost.

# La dirección a la que enlazar  
WILDFLY_BIND=127.0.0.1  
  
# Habilitar Admin  
WILDFLY_CONSOLE_BIND=127.0.0.1

Cuando termines, guarda y cierra el archivo.

ejecutar wildfly en modo independiente

A continuación, copia el script de lanzamiento de WildFly a /opt/wildfly/bin/launch.sh y hazlo ejecutable mediante el comando chmod a continuación.

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/  
sudo chmod +x /opt/wildfly/bin/*.sh

Abre el script de lanzamiento de WildFly /opt/wildfly/bin/launch.sh usando el siguiente comando del editor nano.

sudo nano /opt/wildfly/bin/launch.sh

Inserta la nueva opción de comando ‘-bmanagement $4‘ para habilitar la consola de administración de WildFly de esta manera.

if [[ "$1" == "domain" ]]; then  
    $WILDFLY_HOME/bin/domain.sh -c $2 -b $3 -bmanagement $4  
else  
    $WILDFLY_HOME/bin/standalone.sh -c $2 -b $3 -bmanagement $4  
fi

Guarda y cierra el archivo cuando hayas terminado.

Por último, ejecuta el siguiente comando para cambiar la propiedad del directorio de instalación de WildFly /opt/wildfly al usuario wildfly.

sudo chown -RH wildfly: /opt/wildfly

Ejecutando WildFly como un servicio Systemd

Después de configurar WildFly en modo independiente, configurarás un archivo de servicio systemd para WildFly. Esto te permite ejecutar WildFly en segundo plano y gestionar WildFly fácilmente a través de la utilidad systemctl.

Copia el archivo de servicio systemd de WildFly a /etc/systemd/system/wildfly.service y modifícalo usando el siguiente comando del editor nano.

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/  
sudo nano /etc/systemd/system/wildfly.service

Dentro de la opción ExecStart, agrega un nuevo parámetro de inicio $WILDFLY_CONSOLE_BIND para habilitar la consola de administración de WildFly.

ExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BIND

Cuando termines, guarda el archivo y cierra el editor.

A continuación, ejecuta el siguiente comando systemctl para recargar el administrador de systemd.

sudo systemctl daemon-reload

Luego, inicia y habilita el servicio wildfly usando el siguiente comando.

sudo systemctl start wildfly  
sudo systemctl enable wildfly

wildfly systemd

Verifica el servicio wildfly para asegurarte de que el servicio esté en ejecución ejecutando el siguiente comando.

sudo systemctl status wildfly

Si el servicio wildfly está en ejecución, se mostrará la siguiente salida.

servicio wildfly

También puedes verificar la lista de puertos abiertos en tu sistema ejecutando el siguiente comando.

ss -antpl | grep -i java

Deberías ver múltiples puertos 8080, 8443 y 9990 que WildFly utiliza.

Agregando gestión de usuarios de WildFly

Después de instalar WildFly, crearás un nuevo usuario administrador para WildFly a través del script /opt/wildfly/bin/add-user.sh.

Ejecuta el script /opt/wildfly/bin/add-user.sh como el siguiente.

sh /opt/wildfly/bin/add-user.sh

Ahora se te pedirá lo siguiente:

  • Ingresa a para crear un nuevo usuario de gestión de WildFly.
  • Ingresa tu usuario y contraseña de administrador, luego repítelo.
  • Presiona ENTER cuando se te pida la configuración del grupo.
  • Ingresa sí para agregar tu usuario al ManagementRealm.

Una vez que el proceso haya terminado, deberías ver que tu nuevo usuario ha sido agregado a la configuración de WildFly.

agregar usuario administrador

Configurando Nginx como un proxy inverso

En este punto, has completado la instalación de WildFly, habilitado la consola de administración y creado el usuario administrador. El siguiente paso es instalar Nginx y configurarlo como un proxy inverso para WildFly.

Ejecuta el siguiente comando apt para instalar Nginx en tu servidor Debian. Ingresa y para proceder con la instalación.

sudo apt install nginx

instalar nginx

Una vez que Nginx esté instalado, lo configurarás como un proxy inverso para WildFly.

Crea una nueva configuración de encabezados proxy de Nginx /etc/nginx/conf.d/proxy_headers.conf usando el siguiente comando del editor nano.

sudo nano /etc/nginx/conf.d/proxy_headers.conf

Inserta la siguiente configuración en el archivo.

proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
add_header Front-End-Https on;
add_header Cache-Control no-cache;

Guarda y cierra el archivo cuando termines.

A continuación, lanza el siguiente comando del editor nano para crear una nueva configuración de bloque de servidor Nginx /etc/nginx/sites-available/wildfly.

sudo nano /etc/nginx/sites-available/wildfly

Inserta la configuración a continuación para configurar Nginx como un proxy inverso para tu instalación de WildFly. Asegúrate de cambiar el dominio dentro de la opción server_name, puedes usar un nombre de dominio local.

server {  
    listen          80;  
    server_name     wildfly.howtoforge.local;  
  
    location / {  
        include conf.d/proxy_headers.conf;  
        proxy_pass http://127.0.0.1:8080;  
    }  
  
    location /management {  
        include conf.d/proxy_headers.conf;  
        proxy_pass http://127.0.0.1:9990/management;  
    }  
  
    location /console {  
        include conf.d/proxy_headers.conf;  
        proxy_pass http://127.0.0.1:9990/console;  
    }  
  
    location /logout {  
        include conf.d/proxy_headers.conf;  
        proxy_pass http://127.0.0.1:9990/logout;  
    }  
  
    location /error {  
        include conf.d/proxy_headers.conf;  
        proxy_pass http://127.0.0.1:9990;  
    }  
  
}

Guarda y cierra el archivo cuando termines.

Ahora ejecuta el siguiente comando para activar el archivo de host virtual wildfly y verificar la sintaxis de Nginx.

sudo ln -s /etc/nginx/sites-available/wildfly /etc/nginx/sites-enabled/  
sudo nginx -t

Si tienes una sintaxis de Nginx correcta, se mostrará la salida “syntax is ok—test is successful“.

configurar nginx

Por último, ejecuta el siguiente comando para reiniciar el servicio de Nginx y aplicar los cambios que has realizado. Luego, verifica el servicio de Nginx para asegurarte de que el servicio esté en ejecución.

sudo systemctl restart nginx  
sudo systemctl status nginx

Si Nginx está en ejecución, deberías obtener la salida active (running).

verificar nginx

Accediendo a WildFly a través del cliente

En tu máquina cliente, abre el archivo hosts usando tu editor de texto. Para los usuarios de Windows, abre el archivo C:\Windows\System32\drivers\etc\hosts como administrador, mientras que para los usuarios de Linux o macOS, abre el archivo /etc/hosts con privilegios sudo.

Inserta la siguiente configuración y asegúrate de cambiar el nombre de dominio local y la dirección IP con tu información.

192.168.5.15  wildfly.howtoforge.local

Guarda y cierra el archivo cuando termines.

Lanza tu navegador web y visita tu dominio local de WildFly (por ejemplo: http:wildfly.howtoforge.local/). Si tu instalación es exitosa, deberías ver la página de índice predeterminada de WildFly, que es la siguiente:

wildfly jboss

Ahora haz clic en el enlace Consola de administración para acceder a la consola de administración de WildFly. Esto abrirá una nueva pestaña y serás redirigido a la consola de administración de WildFly con la ruta de URL /console.

Ingresa tu usuario y contraseña de administrador para la consola de administración de WildFly, luego haz clic en Iniciar sesión.

iniciar sesión en la consola de administración

Si tienes el usuario y la contraseña correctos, deberías ver la consola de administración de WildFly como la siguiente.

consola de administración de wildfly

A continuación, haz clic en el menú Runtime y selecciona tu servidor. Deberías ver la confirmación de que WildFly está en funcionamiento.

estado runtime

Por último, selecciona el menú Estado y deberías ver el estado detallado de tu instalación de WildFly, incluyendo la configuración de heap cambiada a 4GB.

estado runtime

Conclusión

En conclusión, ahora has terminado la instalación de WildFly en Debian 12 paso a paso. Has instalado WildFly, habilitado la consola de administración y creado un usuario administrador de WildFly. Además, también has configurado Nginx como un proxy inverso para WildFly. De ahora en adelante, puedes desplegar y ejecutar tus aplicaciones JBoss utilizando el entorno de ejecución de aplicaciones WildFly.

Share: X/Twitter LinkedIn
#Servidor de aplicaciones

Recibe nuevas publicaciones en tu bandeja de entrada.

No spam. Cancela la suscripción en cualquier momento.