WildFly Installation · 7 min read · Sep 09, 2025

So installieren Sie WildFly mit Nginx als Reverse-Proxy auf Debian 10

WildFly ist eine kostenlose, Open-Source- und plattformübergreifende Anwendungsruntime, die in Java geschrieben und von Red Hat entwickelt wurde und es Ihnen ermöglicht, großartige Anwendungen aus einer einzigen IDE zu entwickeln. Es ist leichtgewichtig, schnell, flexibel und basiert auf modularen Subsystemen. Es läuft auf Windows- und Linux-Betriebssystemen und zielt darauf ab, den Benutzern eine schnelle und stabile Java-Laufzeitumgebung bereitzustellen. WildFly bietet eine umfangreiche Palette von Funktionen, darunter schnelle, anpassbare Laufzeit, Skalierbarkeit, einheitliche Konfiguration und Verwaltung, gleichzeitiges Laden, schnelles Verlinken, Domainverwaltung und vieles mehr.

In diesem Tutorial zeigen wir Ihnen die Schritte zur Installation von WildFly mit Nginx als Reverse-Proxy auf Debian 10.

Anforderungen

  • Ein Server, der Debian 10 ausführt.
  • Ein Root-Passwort ist auf Ihrem Server eingerichtet.

Erste Schritte

Bevor Sie beginnen, müssen Sie Ihr System mit der neuesten Version aktualisieren. Sie können dies tun, indem Sie den folgenden Befehl ausführen:

apt-get update -y  
apt-get upgrade -y

Sobald Ihr Server aktualisiert ist, starten Sie Ihren Server neu, um die Änderungen anzuwenden.

Java installieren

WildFly erfordert, dass Java Version 8 auf Ihrem Server installiert ist. Standardmäßig ist Java 8 im Standard-Repository von Debian 10 nicht verfügbar. Daher müssen Sie Java 8 von der offiziellen Website herunterladen.

Nachdem Sie Java 8 heruntergeladen haben, extrahieren Sie den Java-Quellcode in das Verzeichnis /usr/lib/jvm mit dem folgenden Befehl:

mkdir /usr/lib/jvm/  
tar -zxvf jdk-8u221-linux-x64.tar.gz -C /usr/lib/jvm/

Führen Sie als Nächstes den folgenden Befehl aus, um die Standard-Java-Version zu ändern:

update-alternatives --config java

Wählen Sie die Java-Version 8 und drücken Sie die Eingabetaste. Sie sollten die folgende Ausgabe sehen:

Es gibt 2 Auswahlmöglichkeiten für die alternative Java (bereitgestellt von /usr/bin/java).

  Auswahl    Pfad                                         Priorität   Status
------------------------------------------------------------
* 0            /usr/lib/jvm/java-11-openjdk-amd64/bin/java   1111      Automatikmodus
  1            /usr/lib/jvm/java-11-openjdk-amd64/bin/java   1111      manueller Modus
  2            /usr/lib/jvm/jdk1.8.0_221/bin/java            1         manueller Modus

Drücken Sie  , um die aktuelle Auswahl[*] beizubehalten, oder geben Sie die Auswahlnummer ein: 2
update-alternatives: Verwendung von /usr/lib/jvm/jdk1.8.0_221/bin/java zur Bereitstellung von /usr/bin/java (java) im manuellen Modus

Überprüfen Sie als Nächstes die Java-Version mit dem folgenden Befehl:

java -version

Sie sollten die folgende Ausgabe erhalten:

java version "1.8.0_221"
Java(TM) SE Runtime Environment (build 1.8.0_221-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.221-b11, gemischter Modus)

WildFly installieren

Zuerst müssen Sie einen Benutzer und eine Gruppe für WildFly erstellen. Sie können dies mit dem folgenden Befehl tun:

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 folgenden Befehl herunter:

wget https://download.jboss.org/wildfly/17.0.1.Final/wildfly-17.0.1.Final.zip

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

unzip wildfly-17.0.1.Final.zip

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

cp -r wildfly-17.0.1.Final /opt/wildfly

Ändern Sie als Nächstes den Eigentümer des WildFly-Verzeichnisses auf den Benutzer wildfly, wie unten gezeigt:

chown -RH wildfly:wildfly /opt/wildfly

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

WildFly konfigurieren

Als Nächstes müssen Sie die erforderlichen Dateien kopieren, um WildFly zu konfigurieren.

Zuerst kopieren Sie die WildFly-Konfigurationsdatei in das Verzeichnis /etc/wildfly:

mkdir /etc/wildfly  
cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/

Kopieren Sie als Nächstes die launch.sh-Datei in das Verzeichnis /opt/wildfly/bin/ mit dem folgenden Befehl:

cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/

Geben Sie als Nächstes Ausführungsberechtigungen für die launch.sh-Datei:

sh -c 'chmod +x /opt/wildfly/bin/*.sh'

Kopieren Sie als Nächstes die WildFly-Systemd-Einheitendatei in das Verzeichnis /etc/systemd/system/:

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

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

systemctl daemon-reload

Starten Sie als Nächstes den WildFly-Dienst und aktivieren Sie ihn, damit er beim Booten gestartet wird, mit dem folgenden Befehl:

systemctl start wildfly  
systemctl enable wildfly

Sie können jetzt den Status des WildFly-Dienstes mit dem folgenden Befehl überprüfen:

systemctl status wildfly

Sie sollten die folgende Ausgabe erhalten:

? wildfly.service - Der WildFly-Anwendungsserver
   Loaded: loaded (/etc/systemd/system/wildfly.service; disabled; vendor preset: enabled)
   Active: active (running) since Tue 2019-09-10 00:19:27 EDT; 1s ago
 Main PID: 1142 (launch.sh)
    Tasks: 7 (limit: 1138)
   Memory: 24.7M
   CGroup: /system.slice/wildfly.service
           ??1142 /bin/bash /opt/wildfly/bin/launch.sh standalone standalone.xml 0.0.0.0
           ??1143 /bin/sh /opt/wildfly/bin/standalone.sh -c standalone.xml -b 0.0.0.0
           ??1200 java -D[Standalone] -server -Xms64m -Xmx512m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m -Djava.net.preferIPv4Stack=true -

Sep 10 00:19:27 debian systemd[1]: Started Der WildFly-Anwendungsserver.

WildFly-Authentifizierung konfigurieren

Als Nächstes müssen Sie einen Administrationsbenutzer für WildFly erstellen, um auf die WildFly-Admin-Konsole zuzugreifen. Sie können dies mit dem folgenden Befehl tun:

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

Sie sollten die folgende Ausgabe sehen:

Welchen Benutzertyp möchten Sie hinzufügen? 
 a) Verwaltungsbenutzer (mgmt-users.properties) 
 b) Anwendungsbenutzer (application-users.properties)
(a): a

Geben Sie a ein und drücken Sie Enter, um einen Verwaltungsbenutzer zu erstellen. Während des Benutzererstellungsprozesses müssen Sie Benutzernamen, Passwort und Gruppennamen angeben, wie unten gezeigt:

Geben Sie die Daten des neuen Benutzers ein, den Sie hinzufügen möchten.
Verwende Realm 'ManagementRealm', wie in den vorhandenen Property-Dateien entdeckt.
Benutzername : wildflyadmin
Passwortempfehlungen sind unten aufgeführt. Um diese Einschränkungen zu ändern, bearbeiten Sie die Konfigurationsdatei add-user.properties.
 - Das Passwort sollte sich vom Benutzernamen unterscheiden
 - Das Passwort sollte nicht eines der folgenden eingeschränkten Werte {root, admin, administrator} sein
 - Das Passwort sollte mindestens 8 Zeichen, 1 alphabetisches Zeichen, 1 Ziffer, 1 nicht-alphanumerisches Symbol enthalten
Passwort : 
Passwort erneut eingeben : 
Zu welchen Gruppen möchten Sie, dass dieser Benutzer gehört? (Bitte geben Sie eine durch Kommas getrennte Liste ein oder lassen Sie es leer für keine)[  ]: 
Über die Hinzufügung des Benutzers 'wildflyadmin' für das Realm 'ManagementRealm'
Ist das korrekt ja/nein? ja
Benutzer 'wildflyadmin' zur Datei '/opt/wildfly/standalone/configuration/mgmt-users.properties' hinzugefügt
Benutzer 'wildflyadmin' zur Datei '/opt/wildfly/domain/configuration/mgmt-users.properties' hinzugefügt
Benutzer 'wildflyadmin' mit Gruppen zur Datei '/opt/wildfly/standalone/configuration/mgmt-groups.properties' hinzugefügt
Benutzer 'wildflyadmin' mit Gruppen zur Datei '/opt/wildfly/domain/configuration/mgmt-groups.properties' hinzugefügt
Wird dieser neue Benutzer verwendet, um einen AS-Prozess mit einem anderen AS-Prozess zu verbinden? 
z.B. für einen Slave-Host-Controller, der sich mit dem Master verbindet, oder für eine Remoting-Verbindung für Server-zu-Server EJB-Aufrufe.
ja/nein? ja
Um den Benutzer darzustellen, fügen Sie Folgendes zur Definition der Serveridentitäten hinzu

Sobald Sie dies getan haben, können Sie mit dem nächsten Schritt fortfahren.

WildFly so konfigurieren, dass es von einem Remote-System aus zugänglich ist

Standardmäßig ist WildFly nur vom lokalen System aus zugänglich. Daher müssen Sie es so konfigurieren, dass es von einem Remote-System aus zugänglich ist. Sie können dies tun, indem Sie die Datei /etc/wildfly/wildfly.conf bearbeiten:

nano /etc/wildfly/wildfly.conf

Fügen Sie am Ende der Datei die folgende Zeile hinzu:

WILDFLY_CONSOLE_BIND=0.0.0.0

Speichern Sie die Datei und schließen Sie sie, wenn Sie fertig sind. Öffnen Sie dann die Datei /opt/wildfly/bin/launch.sh wie unten gezeigt:

nano /opt/wildfly/bin/launch.sh

Ändern Sie die Datei wie unten gezeigt:

if [ "x$WILDFLY_HOME" = "x" ]; then
    WILDFLY_HOME="/opt/wildfly"
fi

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. Öffnen Sie dann die Datei /etc/systemd/system/wildfly.service.

nano /etc/systemd/system/wildfly.service

Ändern Sie die Datei wie unten gezeigt:

[Unit]
Beschreibung=Der WildFly-Anwendungsserver
Nach=syslog.target network.target
Vor=httpd.service

[Service]
Umgebung=LAUNCH_JBOSS_IN_BACKGROUND=1
Umgebungsdatei=-/etc/wildfly/wildfly.conf
Benutzer=wildfly
LimitNOFILE=102642
PIDFile=/var/run/wildfly/wildfly.pid
ExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BIND
StandardOutput=null

[Install]
WantedBy=multi-user.target

Speichern Sie die Datei. Erstellen Sie dann das Verzeichnis /var/run/wildfly und setzen Sie die richtigen Berechtigungen:

mkdir /var/run/wildfly/  
chown wildfly:wildfly /var/run/wildfly/

Laden Sie schließlich den systemd-Daemon neu und starten Sie den WildFly-Dienst neu, um die Änderungen anzuwenden:

systemctl daemon-reload  
systemctl restart wildfly

Sobald Sie dies getan haben, können Sie mit dem nächsten Schritt fortfahren.

Greifen Sie auf WildFly zu

WildFly ist jetzt installiert und konfiguriert, um von einem Remote-System aus zugänglich zu sein. Standardmäßig hört die WildFly-Management-Konsole auf Port 9990. Sie können darauf zugreifen, indem Sie die URL http://192.168.0.4:9990 besuchen. Sie werden auf die folgende Seite umgeleitet:

Anmelden bei WildFly

Geben Sie jetzt Ihren Admin-Benutzernamen und Ihr Passwort ein und klicken Sie auf die Schaltfläche Anmelden. Sie sollten die WildFly-Management-Konsole auf dem folgenden Bildschirm sehen:

HAL Management Console

Sie können auch auf die WildFly-Anwendung zugreifen, indem Sie die URL http://192.168.0.4:8080 besuchen. Sie sollten die folgende Seite sehen:

Willkommen bei WildFly

Nginx als Reverse-Proxy für WildFly konfigurieren

Als Nächstes müssen Sie Nginx als Reverse-Proxy konfigurieren, um Anfragen, die auf Port 80 eingehen, an 8080 weiterzuleiten.

Zuerst installieren Sie Nginx mit dem folgenden Befehl:

apt-get install nginx -y

Sobald Nginx installiert ist, erstellen Sie eine neue virtuelle Host-Datei für Nginx mit dem folgenden Befehl:

nano /etc/nginx/sites-available/wildfly.conf

Fügen Sie die folgenden Zeilen hinzu:

upstream wildfly {
  server 127.0.0.1:8080 weight=100 max_fails=5 fail_timeout=5;
}

server {
  listen          80;
  server_name     192.168.0.4;

  location / {
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Server $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass http://wildfly/;
  }
}

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

ginx -t

Sie sollten die folgende Ausgabe erhalten:

nginx: die Konfigurationsdatei /etc/nginx/nginx.conf hat die Syntax ok
nginx: Konfigurationsdatei /etc/nginx/nginx.conf Test war erfolgreich

Aktivieren Sie als Nächstes den Nginx-virtuellen Host und starten Sie Nginx mit dem folgenden Befehl neu:

ln -s /etc/nginx/sites-available/wildfly.conf /etc/nginx/sites-enabled/  
systemctl restart nginx

Sie können jetzt auf die WildFly-Anwendung zugreifen, ohne den Port 8080 anzugeben.

Das ist es. Sie haben WildFly erfolgreich installiert und konfiguriert, mit Nginx als Reverse-Proxy auf Debian 10. Zögern Sie nicht, mich zu fragen, wenn Sie Fragen haben.

Share: X/Twitter LinkedIn
#WildFly Installation

Erhalte neue Beiträge in deinem Posteingang.

Kein Spam. Jederzeit abmelden.