WildFlyインストール · 2 min read · Sep 08, 2025

Debian 12にNginxリバースプロキシを使用してWildFlyアプリケーションサーバーをインストールする方法

WildFly、以前のJBossは、Javaウェブアプリケーションを構築および展開するのに役立つ無料のオープンソースアプリケーションサーバーです。Javaで書かれており、Java EE（エンタープライズエディション）仕様に準拠しています。WildFlyはJBossによって作成されましたが、現在はRedHatによって開発されています。これは、Javaウェブアプリケーションを実行および展開するために必要なすべてのツールと機能を提供する強力で、商用利用可能な、モジュール式で軽量なアプリケーションサーバーです。

WildFlyは、EJB、JPA、Servlet、JAX-RS、バッチ、およびセキュリティなどのJavaアプリケーション用のツールを提供するクロスプラットフォームのアプリケーションサーバーです。

このガイドでは、Debian 12サーバーにWildFlyまたはJBossアプリケーションランタイムをステップバイステップでインストールする方法を学びます。WildFlyをインストールし、管理コンソールを有効にし、WildFly管理ユーザーを作成し、Nginxをリバースプロキシとしてインストールおよび構成します。

前提条件

次に進む前に、以下を用意してください：

  • 4GB以上のメモリを持つDebian 12サーバー。
  • sudo管理者権限を持つ非rootユーザー。

Java OpenJDKのインストール

WildFlyは、アプリケーションを構築するための柔軟で軽量なJavaアプリケーションランタイムです。このセクションでは、DebianサーバーにWildFlyをインストールするためにJava OpenJDK 17をインストールして使用します。

まず、次のコマンドを実行してDebianリポジトリを更新します。

sudo apt update

次に、以下のコマンドを実行してJava OpenJDKパッケージをインストールします。これにより、Java OpenJDK 17 LTS（長期サポート）バージョンに相当するdefault-jdkパッケージがインストールされます。

sudo apt install default-jdk

インストールを続行するにはyを入力します。

java openjdkのインストール

Javaをインストールした後、以下のコマンドを使用してJavaのバージョンを確認します。Java OpenJDK 17がインストールされていることが確認できるはずです。

java -version

javaバージョンの確認

WildFlyのインストールと構成

Java OpenJDKをインストールした後、次のタスクを完了することでWildFlyのインストールを開始できます：

  • wildflyユーザーとグループの追加
  • WildFlyバイナリパッケージのダウンロード
  • WildFlyインストールの構成
  • WildFlyをSystemdサービスとして実行

始めましょう。

wildflyユーザーとグループの追加

まず、WildFlyインストールを実行するために使用される新しいシステムユーザーとグループwildflyを作成します。

以下のコマンドを実行して、wildflyという新しいグループとユーザーを追加します。このコマンドで、wildflyユーザーのデフォルトのホームディレクトリを/opt/wildflyに設定し、WildFlyのインストールディレクトリとして使用します。

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

WildFlyバイナリパッケージのダウンロード

systemdユーザーを追加した後、wgetを使用してWildFlyバイナリパッケージをダウンロードします。最新バージョンを取得するためにWildFlyのダウンロードページを訪問してください。

その前に、以下のaptコマンドでunzipをインストールします。

sudo apt install unzip -y

その後、WildFlyのダウンロードページを訪問し、WildFlyの最新バージョンへのリンクをコピーします。以下のようにwgetコマンドを使用してWildFlyバイナリパッケージをダウンロードします。この例では、WildFly 30.0.0をインストールします。

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

次に、WildFlyバイナリパッケージを解凍し、抽出されたディレクトリを/opt/wildflyに移動します。

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

最後に、以下のコマンドを実行して/opt/wildflyディレクトリの所有権をwildflyユーザーに変更します。

sudo chown -RH wildfly: /opt/wildfly

WildFlyインストールの構成

この例では、単一のマシンにスタンドアロンモードでWildFlyをインストールします。したがって、ここで変更するすべての構成はWildFlyスタンドアロン構成に関連しています。

以下のnanoエディタコマンドを実行して、ファイル/opt/wildfly/bin/standalone.confを開きます。

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

JBOSS_JAVA_SIZING環境変数内の値Xmx512mを変更して、WildFlyのデフォルトの最大ヒープメモリサイズを増やします。

現在のサーバーに合わせて最大ヒープメモリサイズを調整してください。以下の例では、最大ヒープメモリを4GBに設定します。

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

完了したら、ファイルを保存して終了します。

次に、以下のコマンドを使用して新しい構成ディレクトリ/etc/wildflyを作成します。

sudo mkdir -p /etc/wildfly

WildFly構成ファイルを/etc/wildfly/wildfly.confにコピーし、以下のnanoエディタコマンドを使用して開きます。

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

デフォルトのWILDFLY_BINDを127.0.0.1に変更し、WildFlyコンソール管理を有効にするために変数WILDFLY_CONSOLE_BINDを追加します。WildFlyと管理コンソールは両方ともlocalhostで実行されます。

# バインドするアドレス  
WILDFLY_BIND=127.0.0.1  
  
# 管理を有効にする  
WILDFLY_CONSOLE_BIND=127.0.0.1

完了したら、ファイルを保存して終了します。

wildflyスタンドアロンの実行

次に、WildFly起動スクリプトを/opt/wildfly/bin/launch.shにコピーし、以下のchmodコマンドで実行可能にします。

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

以下のnanoエディタコマンドを使用してWildFly起動スクリプト/opt/wildfly/bin/launch.shを開きます。

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

新しいコマンドオプション’ -bmanagement $4 ‘を挿入して、WildFly管理コンソールを有効にします。

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

完了したら、ファイルを保存して閉じます。

最後に、以下のコマンドを実行してWildFlyインストールディレクトリ/opt/wildflyの所有権をwildflyユーザーに変更します。

sudo chown -RH wildfly: /opt/wildfly

WildFlyをSystemdサービスとして実行

スタンドアロンモードでWildFlyを構成した後、WildFlyのためのsystemdサービスファイルを設定します。これにより、バックグラウンドでWildFlyを実行し、systemctlユーティリティを介してWildFlyを簡単に管理できます。

WildFly systemdサービスファイルを/etc/systemd/system/wildfly.serviceにコピーし、以下のnanoエディタコマンドを使用して修正します。

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

ExecStartオプション内に、新しい開始パラメータ$WILDFLY_CONSOLE_BINDを追加してWildFly管理コンソールを有効にします。

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

完了したら、ファイルを保存してエディタを終了します。

次に、以下のsystemctlコマンドを実行してsystemdマネージャーをリロードします。

sudo systemctl daemon-reload

次に、以下のコマンドを使用してwildflyサービスを開始および有効にします。

sudo systemctl start wildfly  
sudo systemctl enable wildfly

wildfly systemd

以下のコマンドを実行してwildflyサービスが実行中であることを確認します。

sudo systemctl status wildfly

wildflyサービスが実行中であれば、以下の出力が表示されます。

wildflyサービス

以下のコマンドを実行して、システム上のオープンポートのリストを確認することもできます。

ss -antpl | grep -i java

WildFlyが使用する複数のポート8080、8443、および9990が表示されるはずです。

WildFlyユーザー管理の追加

WildFlyをインストールした後、スクリプト/opt/wildfly/bin/add-user.shを介してWildFlyの新しい管理ユーザーを作成します。

以下のようにスクリプト/opt/wildfly/bin/add-user.shを実行します。

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

次のように求められます：

  • 新しいWildFly管理ユーザーを作成するにはaを入力します。
  • 管理ユーザー名とパスワードを入力し、再度入力します。
  • グループ構成を求められたらENTERを押します。
  • ユーザーをManagementRealmに追加するにはyesを入力します。

プロセスが完了すると、新しいユーザーがWildFly構成に追加されたことが表示されます。

管理ユーザーの追加

Nginxをリバースプロキシとして設定

この時点で、WildFlyのインストールが完了し、管理コンソールが有効になり、管理ユーザーが作成されました。次のステップは、Nginxをインストールし、WildFlyのリバースプロキシとして構成することです。

以下のaptコマンドを実行して、DebianサーバーにNginxをインストールします。インストールを続行するにはyを入力します。

sudo apt install nginx

nginxのインストール

Nginxがインストールされたら、WildFlyのリバースプロキシとして構成します。

以下のnanoエディタコマンドを使用して新しいNginxプロキシヘッダー構成/etc/nginx/conf.d/proxy_headers.confを作成します。

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

ファイルに以下の構成を挿入します。

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

完了したら、ファイルを保存して終了します。

次に、以下のnanoエディタコマンドを実行して新しいNginxサーバーブロック構成/etc/nginx/sites-available/wildflyを作成します。

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

以下の構成を挿入して、NginxをWildFlyインストールのリバースプロキシとして設定します。server_nameオプション内のドメインを変更し、ローカルドメイン名を使用してください。

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

完了したら、ファイルを保存して閉じます。

以下のコマンドを実行して、仮想ホストファイルwildflyを有効にし、Nginxの構文を確認します。

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

適切なNginx構文がある場合、「 syntax is ok—test is successful 」という出力が表示されます。

nginxの設定

最後に、以下のコマンドを実行してNginxサービスを再起動し、行った変更を適用します。その後、Nginxサービスが実行中であることを確認します。

sudo systemctl restart nginx  
sudo systemctl status nginx

Nginxが実行中であれば、出力はactive (running)となります。

nginxの確認

クライアントからWildFlyにアクセス

クライアントマシンで、テキストエディタを使用してhostsファイルを開きます。Windowsユーザーは、管理者としてC:\Windows\System32\drivers\etc\hostsファイルを開き、LinuxまたはmacOSユーザーは、sudo権限で/etc/hostsファイルを開きます。

以下の構成を挿入し、ローカルドメイン名とIPアドレスを自分の情報に変更してください。

192.168.5.15  wildfly.howtoforge.local

完了したら、ファイルを保存して閉じます。

ウェブブラウザを起動し、WildFlyのローカルドメイン（例： http:wildfly.howtoforge.local/）にアクセスします。インストールが成功していれば、デフォルトのWildFlyインデックスページが表示されるはずです。

wildfly jboss

次に、管理コンソールリンクをクリックしてWildFly管理コンソールにアクセスします。これにより新しいタブが開き、URLパス/consoleでWildFly管理コンソールにリダイレクトされます。

WildFly管理コンソールのために管理ユーザー名とパスワードを入力し、サインインをクリックします。

管理コンソールにログイン

正しいユーザー名とパスワードを入力すると、以下のようなWildFly管理コンソールが表示されます。

wildfly管理コンソール

次に、ランタイムメニューをクリックし、サーバーを選択します。WildFlyが稼働していることを確認するメッセージが表示されるはずです。

ランタイムの状態

最後に、ステータスメニューを選択すると、WildFlyインストールの詳細なステータスが表示され、ヒープ構成が4GBに変更されていることが確認できます。

ランタイムのステータス

結論

結論として、Debian 12にWildFlyをステップバイステップでインストールする作業が完了しました。WildFlyをインストールし、管理コンソールを有効にし、WildFly管理ユーザーを作成しました。その上、NginxをWildFlyのリバースプロキシとして構成しました。これからは、WildFlyアプリケーションランタイムを使用してJBossアプリケーションを展開および実行できます。

Share: X/Twitter LinkedIn
#WildFlyインストール

新しい投稿を受信箱で受け取る

スパムはありません。いつでも購読を解除できます。