Installation · 8 min read · Sep 10, 2025

So installieren und konfigurieren Sie WildFly (JBoss) auf Debian 11

Wildfly ist ein in Java geschriebenes Anwendungsserver, das von RedHat entwickelt wurde. Es ist ein einfacher, leichter und leistungsstarker Server mit einer CLI und einer Administrationskonsole. Es ist Open Source, plattformübergreifend und basiert auf erweiterbaren Subsystemen, die nach Bedarf hinzugefügt oder entfernt werden können. Es bietet alle notwendigen Funktionen, um eine Java-Webanwendung auszuführen.

In diesem Tutorial zeige ich Ihnen, wie Sie Wildfly mit Nginx als Reverse-Proxy auf Debian 11 installieren.

Voraussetzungen

  • Ein Server, der Debian 11 ausführt.
  • Ein gültiger Domainname, der auf Ihre Server-IP verweist.
  • Ein Root-Passwort ist auf Ihrem Server konfiguriert.

Installieren Sie Java JDK

Wildfly ist eine Java-basierte Anwendung, daher muss Java auf Ihrem Server installiert sein. Wenn es nicht installiert ist, können Sie es mit dem folgenden Befehl installieren:

apt-get install default-jdk -y

Sobald Java installiert ist, können Sie es mit dem folgenden Befehl überprüfen:

java --version

Sie sollten die Java-Version in der folgenden Ausgabe sehen:

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)

Installieren Sie Wildfly

Zuerst erstellen Sie einen Benutzer und eine Gruppe, um die Wildfly-Anwendung auszuführen, mit dem folgenden Befehl:

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

Laden Sie als Nächstes die neueste Version von Wildfly mit dem wget-Befehl herunter:

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

Sobald der Download abgeschlossen ist, entpacken Sie die heruntergeladene Datei mit dem folgenden Befehl:

unzip wildfly-25.0.1.Final.zip

Bewegen Sie als Nächstes das extrahierte Verzeichnis nach /opt mit dem folgenden Befehl:

mv wildfly-25.0.1.Final /opt/wildfly

Ändern Sie als Nächstes den Besitz des Verzeichnisses /opt/wildfly:

chown -RH wildfly:wildfly /opt/wildfly

Erstellen Sie als Nächstes ein Wildfly-Konfigurationsverzeichnis in /etc mit dem folgenden Befehl:

mkdir -p /etc/wildfly

Kopieren Sie als Nächstes alle notwendigen Dateien vom Wildfly-Verzeichnis in das Verzeichnis /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/

Setzen Sie als Nächstes die Ausführungsberechtigung für alle Shell-Skriptdateien:

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

Laden Sie als Nächstes den systemd-Daemon mit dem folgenden Befehl neu:

systemctl daemon-reload

Starten und aktivieren Sie als Nächstes den Wildfly-Dienst mit dem folgenden Befehl:

systemctl start wildfly  
systemctl enable wildfly

Um den Status des Wildfly-Dienstes zu überprüfen, führen Sie den folgenden Befehl aus:

systemctl status wildfly

Sie erhalten die folgende Ausgabe:

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

Aktivieren Sie die Wildfly-Administrationskonsole

Standardmäßig ist die Wildfly-Administrationskonsole deaktiviert. Es wird empfohlen, sie zu aktivieren, um die Wildfly-Anwendung zu verwalten.

Sie können sie aktivieren, indem Sie die Wildfly-Konfigurationsdatei bearbeiten:

nano /etc/wildfly/wildfly.conf

Ändern Sie die folgenden Zeilen:

WILDFLY_BIND=127.0.0.1
WILDFLY_CONSOLE_BIND=127.0.0.1

Speichern Sie die Datei und schließen Sie sie, und bearbeiten Sie dann das Wildfly-Startskript und aktivieren Sie die Administrationskonsole.

nano /opt/wildfly/bin/launch.sh

Ändern Sie die Datei wie unten gezeigt:

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

Speichern Sie die Datei und schließen Sie sie, und bearbeiten Sie dann die Wildfly-systemd-Datei:

nano /etc/systemd/system/wildfly.service

Ändern Sie die folgende Zeile:

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

Speichern Sie die Datei und schließen Sie sie, und laden Sie dann den systemd-Daemon neu, um die Konfigurationsänderungen anzuwenden:

systemctl daemon-reload

Starten Sie als Nächstes den Wildfly-Dienst neu, um die Änderungen anzuwenden:

systemctl restart wildfly

Sie können auch den Status von Wildfly mit dem folgenden Befehl überprüfen:

systemctl status wildfly

Sie erhalten die folgende Ausgabe:

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

An diesem Punkt ist Wildfly gestartet und hört auf den Ports 8080 und 9990. Sie können diese mit dem folgenden Befehl überprüfen:

ss -plnt

Sie erhalten die folgende Ausgabe:

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

Sobald Sie fertig sind, können Sie mit dem nächsten Schritt fortfahren.

Erstellen Sie einen Wildfly-Administrationsbenutzer

Als Nächstes müssen Sie auch einen Administrationsbenutzer erstellen, um auf die Wildfly-Administrationskonsole zuzugreifen. Sie können ihn erstellen, indem Sie den folgenden Befehl ausführen:

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

Sie werden aufgefordert, die Arten von Benutzern auszuwählen:

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

Geben Sie a ein und drücken Sie die Eingabetaste, um den Verwaltungsbenutzer hinzuzufügen. Sie werden aufgefordert, Ihren Benutzernamen und Ihr Passwort wie unten gezeigt zu definieren:

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 :

Geben Sie Ihren Benutzernamen, Ihr Passwort ein und drücken Sie Enter. Sie werden aufgefordert, Benutzer zur Domäne hinzuzufügen:

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

Geben Sie ja ein und drücken Sie die Enter-Taste, um fortzufahren. Sobald der Benutzer hinzugefügt wurde, erhalten Sie die folgende Ausgabe:

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

Sobald Sie fertig sind, können Sie mit dem nächsten Schritt fortfahren.

Installieren und Konfigurieren von Nginx als Reverse-Proxy

Als Nächstes müssen Sie Nginx als Reverse-Proxy konfigurieren, um auf Wildfly über Port 80 zuzugreifen.

Zuerst installieren Sie das Nginx-Paket mit dem folgenden Befehl:

apt-get install nginx -y

Sobald Nginx installiert ist, erstellen Sie eine Nginx-Proxy-Datei mit dem folgenden Befehl:

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

Fügen Sie die folgenden Zeilen hinzu:

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

Speichern Sie die Datei und schließen Sie sie, und erstellen Sie dann eine Nginx-virtuelle Hostkonfigurationsdatei für Wildfly:

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

Fügen Sie die folgenden Zeilen hinzu:

server {
  listen          80;
  server_name     wildfly.yourdomain.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;
  }

}

Speichern Sie die Datei und schließen Sie sie, und überprüfen Sie dann Nginx auf Syntaxfehler mit dem folgenden Befehl:

ginx -t

Sie sollten die folgende Ausgabe sehen:

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

Starten Sie schließlich den Nginx-Dienst neu, um die Änderungen anzuwenden:

systemctl restart nginx

Sie können auch den Nginx-Status mit dem folgenden Befehl überprüfen:

systemctl status nginx

Sie erhalten die folgende Ausgabe:

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

An diesem Punkt ist Nginx installiert und konfiguriert, um Wildfly zu bedienen. Sie können jetzt mit dem nächsten Schritt fortfahren.

Greifen Sie auf die Wildfly-Weboberfläche zu

Öffnen Sie jetzt Ihren Webbrowser und greifen Sie auf die Wildfly-Anwendungsseite über die URL http://wildfly.yourdomain.com zu. Sie sollten die Standardseite von Wildfly auf dem folgenden Bildschirm sehen:

WildFly JAVA Application Server

Um auf die Wildfly-Administrationskonsole zuzugreifen, geben Sie die URL http://wildfly.yourdomain.com/console/ in Ihren Webbrowser ein. Sie werden aufgefordert, einen Administrationsbenutzernamen und ein Passwort einzugeben, wie unten gezeigt:

WildFly login

Geben Sie Ihren Administrationsbenutzernamen, Ihr Passwort ein und klicken Sie auf die Schaltfläche Anmelden. Sobald Sie angemeldet sind, sollten Sie das Wildfly-Administrations-Dashboard sehen:

WildFly admin dashboard

Fazit

Herzlichen Glückwunsch! Sie haben Wildfly erfolgreich mit Nginx als Reverse-Proxy auf Debian 11 installiert. Sie können Wildfly jetzt verwenden, um Ihre Java-Anwendung im Internet zu hosten. Zögern Sie nicht, mich zu fragen, wenn Sie Fragen haben.

Share: X/Twitter LinkedIn
#Installation

Erhalte neue Beiträge in deinem Posteingang.

Kein Spam. Jederzeit abmelden.