Instalação WildFly · 8 min read · Sep 10, 2025

Como Instalar e Configurar o WildFly (JBoss) no Debian 11

Wildfly é um servidor de aplicações escrito em Java e desenvolvido pela RedHat. É um servidor simples, leve e poderoso, com uma CLI e um console de administração. É open-source, multiplataforma e baseado em subsistemas plugáveis que podem ser adicionados ou removidos conforme necessário. Ele fornece todos os recursos necessários para executar uma aplicação web em Java.

Neste tutorial, vou mostrar como instalar o Wildfly com o Nginx como um proxy reverso no Debian 11.

Pré-requisitos

  • Um servidor rodando Debian 11.
  • Um nome de domínio válido apontado para o IP do seu servidor.
  • Uma senha de root configurada no seu servidor.

Instalar Java JDK

Wildfly é uma aplicação baseada em Java, então o Java deve ser instalado no seu servidor. Se não estiver instalado, você pode instalá-lo executando o seguinte comando:

apt-get install default-jdk -y

Uma vez que o Java esteja instalado, você pode verificar usando o seguinte comando:

java --version

Você deve ver a versão do Java na seguinte saída:

openjdk 11.0.12 2021-07-20
OpenJDK Runtime Environment (build 11.0.12+7-post-Debian-2deb10u1)
OpenJDK 64-Bit Server VM (build 11.0.12+7-post-Debian-2deb10u1, mixed mode, sharing)

Instalar Wildfly

Primeiro, crie um usuário e grupo para executar a aplicação Wildfly usando o seguinte comando:

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

Em seguida, baixe a versão mais recente do Wildfly usando o comando wget:

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

Uma vez que o download esteja completo, descompacte o arquivo baixado com o seguinte comando:

unzip wildfly-25.0.1.Final.zip

Em seguida, mova o diretório extraído para o /opt usando o seguinte comando:

mv wildfly-25.0.1.Final /opt/wildfly

Em seguida, altere a propriedade do diretório /opt/wildfly:

chown -RH wildfly:wildfly /opt/wildfly

Em seguida, crie um diretório de configuração do Wildfly dentro de /etc usando o seguinte comando:

mkdir -p /etc/wildfly

Em seguida, copie todos os arquivos necessários do diretório Wildfly para o diretório /etc/wildfly:

cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/  
cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/  
cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/

Em seguida, defina a permissão de execução para todos os arquivos de script shell:

chmod +x /opt/wildfly/bin/*.sh

Em seguida, recarregue o daemon systemd com o seguinte comando:

systemctl daemon-reload

Em seguida, inicie e habilite o serviço Wildfly usando o seguinte comando:

systemctl start wildfly  
systemctl enable wildfly

Para verificar o status do serviço Wildfly, execute o seguinte comando:

systemctl status wildfly

Você receberá a seguinte saída:

? wildfly.service - The WildFly Application Server
   Loaded: loaded (/etc/systemd/system/wildfly.service; disabled; vendor preset: enabled)
   Active: active (running) since Fri 2021-12-10 14:55:07 UTC; 6s ago
 Main PID: 20928 (launch.sh)
    Tasks: 59 (limit: 4701)
   Memory: 171.6M
   CGroup: /system.slice/wildfly.service
           ??20928 /bin/bash /opt/wildfly/bin/launch.sh standalone standalone.xml 0.0.0.0
           ??20929 /bin/sh /opt/wildfly/bin/standalone.sh -c standalone.xml -b 0.0.0.0
           ??21022 java -D[Standalone] -server -Xms64m -Xmx512m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m -Djava.net.preferIPv4Stack=tru

Dec 10 14:55:07 debian11 systemd[1]: Started The WildFly Application Server.

Habilitar o Console de Administração do Wildfly

Por padrão, o console de administração do Wildfly está desativado. É recomendável habilitá-lo para gerenciar a aplicação Wildfly.

Você pode habilitá-lo editando o arquivo de configuração do Wildfly:

nano /etc/wildfly/wildfly.conf

Altere as seguintes linhas:

WILDFLY_BIND=127.0.0.1
WILDFLY_CONSOLE_BIND=127.0.0.1

Salve e feche o arquivo, em seguida, edite o script de inicialização do Wildfly e habilite o console de administração.

nano /opt/wildfly/bin/launch.sh

Altere o arquivo conforme mostrado abaixo:

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

Salve e feche o arquivo, em seguida, edite o arquivo systemd do Wildfly:

nano /etc/systemd/system/wildfly.service

Altere a seguinte linha:

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

Salve e feche o arquivo, em seguida, recarregue o daemon systemd para aplicar as alterações de configuração:

systemctl daemon-reload

Em seguida, reinicie o serviço Wildfly para aplicar as alterações:

systemctl restart wildfly

Você também pode verificar o status do Wildfly com o seguinte comando:

systemctl status wildfly

Você receberá a seguinte saída:

? wildfly.service - The WildFly Application Server
   Loaded: loaded (/etc/systemd/system/wildfly.service; disabled; vendor preset: enabled)
   Active: active (running) since Fri 2021-12-10 14:57:22 UTC; 3s ago
 Main PID: 21182 (launch.sh)
    Tasks: 64 (limit: 4701)
   Memory: 205.6M
   CGroup: /system.slice/wildfly.service
           ??21182 /bin/bash /opt/wildfly/bin/launch.sh standalone standalone.xml 127.0.0.1 127.0.0.1
           ??21183 /bin/sh /opt/wildfly/bin/standalone.sh -c standalone.xml -b 127.0.0.1 -bmanagement 127.0.0.1
           ??21282 java -D[Standalone] -server -Xms64m -Xmx512m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m -Djava.net.preferIPv4Stack=tru

Dec 10 14:57:22 debian11 systemd[1]: Started The WildFly Application Server.

Neste ponto, o Wildfly está iniciado e escutando nas portas 8080 e 9990. Você pode verificá-las com o seguinte comando:

ss -plnt

Você receberá a seguinte saída:

State        Recv-Q       Send-Q             Local Address:Port             Peer Address:Port                                                 
LISTEN       0            128                      0.0.0.0:22                    0.0.0.0:*           users:(("sshd",pid=678,fd=3))            
LISTEN       0            128                    127.0.0.1:8443                  0.0.0.0:*           users:(("java",pid=21282,fd=485))        
LISTEN       0            50                     127.0.0.1:9990                  0.0.0.0:*           users:(("java",pid=21282,fd=487))        
LISTEN       0            80                     127.0.0.1:3306                  0.0.0.0:*           users:(("mysqld",pid=12461,fd=21))       
LISTEN       0            128                    127.0.0.1:8080                  0.0.0.0:*           users:(("java",pid=21282,fd=476))        
LISTEN       0            128                         [::]:22                       [::]:*           users:(("sshd",pid=678,fd=4))

Uma vez que você tenha terminado, pode prosseguir para a próxima etapa.

Criar Usuário Administrador do Wildfly

Em seguida, você também precisará criar um usuário administrador para acessar o console de administração do Wildfly. Você pode criá-lo executando o seguinte comando:

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

Você será solicitado a escolher os tipos de usuário:

What type of user do you wish to add? 
 a) Management User (mgmt-users.properties) 
 b) Application User (application-users.properties)
(a): a

Digite a e pressione a tecla Enter para adicionar o usuário de gerenciamento. Você será solicitado a definir seu nome de usuário e senha, conforme mostrado abaixo:

Enter the details of the new user to add.
Using realm 'ManagementRealm' as discovered from the existing property files.
Username : hitesh
Password recommendations are listed below. To modify these restrictions edit the add-user.properties configuration file.
 - The password should be different from the username
 - The password should not be one of the following restricted values {root, admin, administrator}
 - The password should contain at least 8 characters, 1 alphabetic character(s), 1 digit(s), 1 non-alphanumeric symbol(s)
Password : 
Re-enter Password :

Forneça seu nome de usuário, senha e pressione Enter. Você será solicitado a adicionar usuários ao reino:

What groups do you want this user to belong to? (Please enter a comma separated list, or leave blank for none)[  ]: 
About to add user 'hitesh' for realm 'ManagementRealm'
Is this correct yes/no? yes

Digite yes e pressione a tecla Enter para continuar. Uma vez que o usuário seja adicionado, você receberá a seguinte saída:

Added user 'hitesh' to file '/opt/wildfly/standalone/configuration/mgmt-users.properties'
Added user 'hitesh' to file '/opt/wildfly/domain/configuration/mgmt-users.properties'
Added user 'hitesh' with groups  to file '/opt/wildfly/standalone/configuration/mgmt-groups.properties'
Added user 'hitesh' with groups  to file '/opt/wildfly/domain/configuration/mgmt-groups.properties'
Is this new user going to be used for one AS process to connect to another AS process? 
e.g. for a slave host controller connecting to the master or for a Remoting connection for server to server Jakarta Enterprise Beans calls.
yes/no? yes
To represent the user add the following to the server-identities definition

Uma vez que você tenha terminado, pode prosseguir para a próxima etapa.

Instalar e Configurar o Nginx como um Proxy Reverso

Em seguida, você precisará configurar o Nginx como um proxy reverso para acessar o Wildfly através da porta 80.

Primeiro, instale o pacote Nginx usando o comando abaixo:

apt-get install nginx -y

Uma vez que o Nginx esteja instalado, crie um arquivo de proxy do Nginx com o seguinte comando:

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

Adicione as seguintes linhas:

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

Salve e feche o arquivo, em seguida, crie um arquivo de configuração de host virtual do Nginx para o Wildfly:

nano /etc/nginx/conf.d/wildfly.conf

Adicione as seguintes linhas:

server {
  listen          80;
  server_name     wildfly.seudominio.com;

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

}

Salve e feche o arquivo, em seguida, verifique o Nginx para qualquer erro de sintaxe usando o seguinte comando:

ginx -t

Você deve ver a seguinte saída:

ginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Finalmente, reinicie o serviço Nginx para aplicar as alterações:

systemctl restart nginx

Você também pode verificar o status do Nginx usando o comando abaixo:

systemctl status nginx

Você receberá a seguinte saída:

? nginx.service - A high performance web server and a reverse proxy server
   Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
   Active: active (running) since Fri 2021-12-10 15:12:26 UTC; 9s ago
     Docs: man:nginx(8)
  Process: 22115 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
  Process: 22116 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
 Main PID: 22117 (nginx)
    Tasks: 3 (limit: 4701)
   Memory: 3.8M
   CGroup: /system.slice/nginx.service
           ??22117 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
           ??22118 nginx: worker process
           ??22119 nginx: worker process

Dec 10 15:12:25 debian11 systemd[1]: Starting A high performance web server and a reverse proxy server...
Dec 10 15:12:26 debian11 systemd[1]: Started A high performance web server and a reverse proxy server.

Neste ponto, o Nginx está instalado e configurado para servir o Wildfly. Você pode agora prosseguir para a próxima etapa.

Acessar a Interface Web do Wildfly

Agora, abra seu navegador e acesse a página da aplicação Wildfly usando a URL http://wildfly.seudominio.com. Você deve ver a página padrão do Wildfly na seguinte tela:

WildFly JAVA Application Server

Para acessar o console de administração do Wildfly, digite a URL http://wildfly.seudominio.com/console/ em seu navegador. Você será solicitado a fornecer um nome de usuário e senha de administrador, conforme mostrado abaixo:

WildFly login

Forneça seu nome de usuário de administrador, senha e clique no botão Entrar. Uma vez que você esteja logado, você deve ver o painel de administração do Wildfly:

WildFly admin dashboard

Conclusão

Parabéns! você instalou com sucesso o Wildfly com o Nginx como um proxy reverso no Debian 11. Você pode agora usar o Wildfly para hospedar sua aplicação Java na internet. Sinta-se à vontade para me perguntar se você tiver alguma dúvida.

Share: X/Twitter LinkedIn
#Instalação WildFly

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.