Installation WildFly · 9 min read · Sep 08, 2025

Comment installer le serveur d'applications WildFly avec Nginx en tant que proxy inverse sur Debian 12

WildFly, anciennement JBoss, est un serveur d’applications gratuit et open-source qui vous aide à créer et déployer des applications web Java. Il est écrit en Java et conforme aux spécifications Java EE (Enterprise Edition). WildFly a été créé par JBoss mais est maintenant développé par RedHat. C’est un serveur d’applications puissant, prêt pour la production, modulaire et léger qui fournit tous les outils et fonctionnalités nécessaires pour exécuter et déployer des applications web Java.

WildFly est un serveur d’applications multiplateforme qui fournit des outils pour les applications Java telles que EJBs, JPA, Servlets, JAX-RS, Batch et sécurité.

Dans ce guide, vous apprendrez à installer WildFly ou le runtime d’application JBoss sur un serveur Debian 12 étape par étape. Vous installerez WildFly, activerez la console d’administration, créerez un utilisateur administrateur WildFly et installerez et configurerez Nginx en tant que proxy inverse.

Prérequis

Avant de continuer, rassemblez les éléments suivants :

  • Un serveur Debian 12 avec 4 Go ou plus de mémoire.
  • Un utilisateur non-root avec des privilèges d’administrateur sudo.

Installation de Java OpenJDK

WildFly est un runtime d’application Java flexible et léger pour la création d’applications. Dans cette section, vous installerez et utiliserez Java OpenJDK 17 pour installer WildFly sur votre serveur Debian.

Tout d’abord, exécutez la commande suivante pour mettre à jour votre dépôt Debian.

sudo apt update

Maintenant, installez le paquet Java OpenJDK en exécutant la commande ci-dessous. Cela installera le paquet default-jdk, qui est équivalent à la version Java OpenJDK 17 LTS (Long Term Supports).

sudo apt install default-jdk

Entrez y pour continuer avec l’installation.

installer java openjdk

Après avoir installé Java, vérifiez la version de Java en utilisant la commande ci-dessous. Vous devriez voir que Java OpenJDK 17 est installé.

java -version

vérification de la version java

Installation et configuration de WildFly

Après avoir installé Java OpenJDK, vous pouvez maintenant commencer l’installation de WildFly en complétant les tâches suivantes :

  • Ajouter l’utilisateur et le groupe wildfly
  • Télécharger le paquet binaire WildFly
  • Configurer l’installation de WildFly
  • Exécuter WildFly en tant que service Systemd

Commençons.

Ajouter l’utilisateur et le groupe wildfly

Tout d’abord, vous allez créer un nouvel utilisateur système et un groupe wildfly qui seront utilisés pour exécuter votre installation WildFly.

Exécutez la commande ci-dessous pour ajouter un nouveau groupe et un utilisateur appelé wildfly en exécutant la commande suivante. Avec cela, vous allez également configurer le répertoire personnel par défaut pour les utilisateurs wildfly à /opt/wildfly, qui sera utilisé comme répertoire d’installation de WildFly.

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

Télécharger le paquet binaire WildFly

Après avoir ajouté un utilisateur systemd, vous allez télécharger le paquet binaire WildFly via wget. Assurez-vous de visiter la page de téléchargement de WildFly pour obtenir la dernière version.

Avant cela, installez unzip via la commande apt suivante.

sudo apt install unzip -y

Après cela, visitez la page de téléchargement de WildFly et copiez le lien vers la dernière version de WildFly. Téléchargez le paquet binaire WildFly via la commande wget comme suit. Dans cet exemple, vous allez installer WildFly 30.0.0.

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

Ensuite, décompressez le paquet binaire WildFly et déplacez le répertoire extrait vers /opt/wildfly.

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

Enfin, exécutez la commande ci-dessous pour changer la propriété du répertoire /opt/wildfly à l’utilisateur wildfly.

sudo chown -RH wildfly: /opt/wildfly

Configurer l’installation de WildFly

Dans cet exemple, vous allez installer WildFly sur une seule machine en mode autonome. Donc, chaque configuration que vous modifiez ici est liée aux configurations autonomes de WildFly.

Lancez la commande de l’éditeur nano suivante pour ouvrir le fichier /opt/wildfly/bin/standalone.conf.

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

Changez la valeur Xmx512m dans la variable d’environnement JBOSS_JAVA_SIZING pour augmenter la taille maximale de la mémoire heap par défaut de WildFly, comme suit.

Assurez-vous d’ajuster la taille de la mémoire heap maximale avec votre serveur actuel. L’exemple suivant définit la mémoire heap maximale à 4 Go.

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

Enregistrez et quittez le fichier lorsque vous avez terminé.

Maintenant, créez un nouveau répertoire de configuration /etc/wildfly en utilisant la commande ci-dessous.

sudo mkdir -p /etc/wildfly

Copiez le fichier de configuration WildFly vers /etc/wildfly/wildfly.conf et ouvrez-le en utilisant la commande de l’éditeur nano suivante.

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

Changez le WILDFLY_BIND par défaut en 127.0.0.1 et ajoutez une variable WILDFLY_CONSOLE_BIND pour activer la console d’administration WildFly. WildFly et la console d’administration fonctionneront tous deux en localhost.

# L'adresse à laquelle se lier  
WILDFLY_BIND=127.0.0.1  
  
# Activer l'Admin  
WILDFLY_CONSOLE_BIND=127.0.0.1

Lorsque vous avez terminé, enregistrez et quittez le fichier.

exécuter wildfly autonome

Ensuite, copiez le script de lancement WildFly vers /opt/wildfly/bin/launch.sh et rendez-le exécutable via la commande chmod ci-dessous

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

Ouvrez le script de lancement WildFly /opt/wildfly/bin/launch.sh en utilisant la commande de l’éditeur nano suivante.

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

Insérez la nouvelle option de commande ‘-bmanagement $4‘ pour activer la console d’administration WildFly comme ceci.

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

Enregistrez et fermez le fichier lorsque vous avez terminé.

Enfin, exécutez la commande ci-dessous pour changer la propriété du répertoire d’installation WildFly /opt/wildfly à l’utilisateur wildfly.

sudo chown -RH wildfly: /opt/wildfly

Exécution de WildFly en tant que service Systemd

Après avoir configuré WildFly en mode autonome, vous allez configurer un fichier de service systemd pour WildFly. Cela vous permet d’exécuter WildFly en arrière-plan et de gérer WildFly facilement via l’utilitaire systemctl.

Copiez le fichier de service systemd WildFly vers /etc/systemd/system/wildfly.service et modifiez-le en utilisant la commande de l’éditeur nano ci-dessous.

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

Dans l’option ExecStart, ajoutez un nouveau paramètre de démarrage $WILDFLY_CONSOLE_BIND pour activer la console d’administration WildFly.

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

Lorsque vous avez terminé, enregistrez le fichier et quittez l’éditeur.

Ensuite, exécutez la commande systemctl ci-dessous pour recharger le gestionnaire systemd.

sudo systemctl daemon-reload

Puis démarrez et activez le service wildfly en utilisant la commande ci-dessous.

sudo systemctl start wildfly  
sudo systemctl enable wildfly

wildfly systemd

Vérifiez le service wildfly pour vous assurer que le service fonctionne en exécutant la commande suivante.

sudo systemctl status wildfly

Si le service wildfly fonctionne, la sortie suivante sera affichée.

service wildfly

Vous pouvez également vérifier la liste des ports ouverts sur votre système en exécutant la commande suivante.

ss -antpl | grep -i java

Vous devriez voir plusieurs ports 8080, 8443 et 9990 que WildFly utilise.

Ajout de la gestion des utilisateurs WildFly

Après avoir installé WildFly, vous allez créer un nouvel utilisateur administrateur pour WildFly via le script /opt/wildfly/bin/add-user.sh.

Exécutez le script /opt/wildfly/bin/add-user.sh comme suit.

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

Maintenant, vous serez invité avec ce qui suit :

  • Entrez a pour créer un nouvel utilisateur de gestion WildFly.
  • Entrez votre utilisateur administrateur et votre mot de passe, puis répétez-le.
  • Appuyez sur ENTRÉE lorsque vous êtes invité pour la configuration du groupe.
  • Entrez oui pour ajouter votre utilisateur au ManagementRealm.

Une fois le processus terminé, vous devriez voir que votre nouvel utilisateur a été ajouté à la configuration WildFly.

ajouter un utilisateur admin

Configuration de Nginx en tant que proxy inverse

À ce stade, vous avez accompli l’installation de WildFly, activé la console d’administration et créé l’utilisateur administrateur. L’étape suivante consiste à installer Nginx et à le configurer en tant que proxy inverse pour WildFly.

Exécutez la commande apt ci-dessous pour installer Nginx sur votre serveur Debian. Entrez y pour continuer avec l’installation.

sudo apt install nginx

installer nginx

Une fois Nginx installé, vous allez le configurer en tant que proxy inverse pour WildFly.

Créez une nouvelle configuration d’en-têtes proxy Nginx /etc/nginx/conf.d/proxy_headers.conf en utilisant la commande de l’éditeur nano ci-dessous.

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

Insérez la configuration suivante dans le fichier.

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

Enregistrez et quittez le fichier lorsque vous avez terminé.

Ensuite, lancez la commande de l’éditeur nano suivante pour créer une nouvelle configuration de bloc de serveur Nginx /etc/nginx/sites-available/wildfly.

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

Insérez la configuration ci-dessous pour configurer Nginx en tant que proxy inverse pour votre installation WildFly. Assurez-vous de changer le domaine dans l’option server_name, vous pouvez utiliser un nom de domaine 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;  
    }  
  
}

Enregistrez et fermez le fichier lorsque vous avez terminé.

Maintenant, exécutez la commande ci-dessous pour activer le fichier d’hôte virtuel wildfly et vérifier votre syntaxe Nginx.

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

Si vous avez une syntaxe Nginx correcte, la sortie “la syntaxe est correcte - le test est réussi“ sera affichée.

configuration nginx

Enfin, exécutez la commande ci-dessous pour redémarrer le service Nginx et appliquer les modifications que vous avez apportées. Ensuite, vérifiez le service Nginx pour vous assurer que le service fonctionne.

sudo systemctl restart nginx  
sudo systemctl status nginx

Si Nginx fonctionne, vous devriez obtenir la sortie actif (en cours d’exécution).

vérifier nginx

Accéder à WildFly via le client

Sur votre machine cliente, ouvrez le fichier hosts en utilisant votre éditeur de texte. Pour les utilisateurs de Windows, ouvrez le fichier C:\Windows\System32\drivers\etc\hosts en tant qu’administrateur, pour les utilisateurs de Linux ou macOS, ouvrez le fichier /etc/hosts avec des privilèges sudo.

Insérez la configuration suivante et assurez-vous de changer le nom de domaine local et l’adresse IP avec vos informations.

192.168.5.15  wildfly.howtoforge.local

Enregistrez et fermez le fichier lorsque vous avez terminé.

Lancez votre navigateur web et visitez votre domaine local WildFly (par exemple : http:wildfly.howtoforge.local/). Si votre installation est réussie, vous devriez voir la page d’index par défaut de WildFly, qui est la suivante :

wildfly jboss

Maintenant, cliquez sur le lien Console d’administration pour accéder à la console d’administration WildFly. Cela ouvrira un nouvel onglet et vous serez redirigé vers la console d’administration WildFly avec le chemin d’URL /console.

Entrez votre utilisateur administrateur et votre mot de passe pour la console d’administration WildFly, puis cliquez sur Se connecter.

connexion console admin

Si vous avez le bon utilisateur et le bon mot de passe, vous devriez voir la console d’administration WildFly comme suit.

console admin wildfly

Ensuite, cliquez sur le menu Runtime et sélectionnez votre serveur. Vous devriez voir la confirmation que WildFly est en marche.

statut runtime

Enfin, sélectionnez le menu Statut et vous devriez voir le statut détaillé de votre installation WildFly, y compris la configuration de la heap changée à 4 Go.

statut runtime

Conclusion

En conclusion, vous avez maintenant terminé l’installation de WildFly sur Debian 12 étape par étape. Vous avez installé WildFly, activé la console d’administration et créé un utilisateur administrateur WildFly. De plus, vous avez également configuré Nginx en tant que proxy inverse pour WildFly. À partir de maintenant, vous pouvez déployer et exécuter vos applications JBoss en utilisant le runtime d’application WildFly.

Share: X/Twitter LinkedIn
#Installation WildFly

Recevez de nouveaux articles dans votre boîte de réception.

Aucun spam. Désabonnez-vous à tout moment.