WildFly インストール · 3 min read · Dec 19, 2025

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

WildFly、以前はJBoss ASとして知られていたものは、JEE(Java Enterprise Edition)コンテナの軽量実装です。その柔軟なアプリケーションランタイムはJavaで書かれており、素晴らしいアプリケーションを構築するのに役立ちます。

WildFlyは、Linux、macOS、Windowsオペレーティングシステムで動作するマルチプラットフォームアプリケーションランタイムです。JBoss Incによって作成され、2006年にRedHatに買収され、WildFlyとなりました。

このチュートリアルでは、最新のUbuntu 20.04にWildFlyをインストールする方法を示します。最新バージョンのWildFly 20をインストールし、WildFlyの管理コンソールを有効にし、WildFly管理ユーザーを作成し、NginxをWildFlyのリバースプロキシとして設定します。

前提条件

このガイドでは、2GBのRAM、50GBの空きディスクスペース、2つのCPUを持つ最新のUbuntu Server 20.04 FocalFossaにWildFlyをインストールします。

何をするのか?

  • Java OpenJDK 11をインストール
  • 新しいユーザーを追加し、WildFlyをダウンロード
  • WildFlyの基本設定
  • WildFly管理コンソールを有効にする
  • WildFlyの管理ユーザーを設定
  • NginxをWildFlyのリバースプロキシとして設定
  • テスト

ステップ1 - Java OpenJDKをインストール

まず、Ubuntuサーバー20.04にJava OpenJDKをインストールします。そして、WildFlyのインストールにはJava OpenJDK 11を使用します。これは、Ubuntu 20.04リポジトリのデフォルトのJavaパッケージのバージョンです。

すべてのパッケージリポジトリを更新し、以下のaptコマンドを使用してJava OpenJDKをインストールします。

sudo apt update  
sudo apt install default-jdk

すべてのインストールが完了したら、以下のコマンドを使用してJavaのバージョンを確認します。

java -version

以下は、得られる結果です。

openjdk version "11.0.7" 2020-04-14  
OpenJDK Runtime Environment (build 11.0.7+10-post-Ubuntu-3ubuntu1)  
OpenJDK 64-Bit Server VM (build 11.0.7+10-post-Ubuntu-3ubuntu1, mixed mode, sharing)

その結果、Ubuntu 20.04にJava OpenJDKのインストールが完了しました。

ステップ2 - 新しいユーザーを追加し、WildFlyをダウンロード

このステップでは、新しいシステムユーザーとグループ「wildfly」を作成し、WildFlyのソースコードを「/opt/wildfly」ディレクトリにダウンロードします。

以下のコマンドを使用して、「wildfly」という名前の新しいユーザーとグループを作成します。

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

次に、「/opt」ディレクトリに移動し、以下のwgetコマンドを使用してWildFlyのソースコードをダウンロードします。

cd /opt/  
wget -q wget https://download.jboss.org/wildfly/20.0.1.Final/wildfly-20.0.1.Final.tar.gz

WildFlyのソースコードがダウンロードされました。

次に、WildFlyのソースコードを抽出し、抽出されたディレクトリの名前を「wildfly」に変更します。

tar -xf wildfly-20.0.1.Final.tar.gz  
mv wildfly-20.0.1.Final wildfly

その後、「wildfly」ディレクトリの所有権を「wildfly」ユーザーとグループに変更します。

chown -RH wildfly:wildfly /opt/wildfly

その結果、WildFlyのインストールディレクトリは「/opt/wildfly」ディレクトリにあります。WildFlyサービスは、先ほど作成した「wildfly」という新しいユーザーの下で実行されます。

新しいユーザーを作成し、WildFlyソースコードをダウンロード

ステップ3 - WildFlyの基本設定

WildFlyのソースコードをダウンロードした後、UbuntuシステムにWildFlyを設定します。

新しい設定ディレクトリ「/etc/wildfly」を作成し、サンプル設定「wildfly.conf」をその中にコピーします。

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

次に、サービスファイル「wildfly.service」を「/etc/systemd/system」ディレクトリにコピーします。

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

その後、WildFlyの起動スクリプトのサンプルを「/opt/wildfly/bin」ディレクトリにコピーし、実行可能にします。

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

今、systemdマネージャーをリロードして新しい「wildfly.service」ファイルを適用します。

systemctl daemon-reload

WildFlyサービスを開始し、システム起動時に追加します。

systemctl start wildfly  
systemctl enable wildfly

WildFlyサービスは、デフォルト設定でUbuntuシステム上で稼働しています。

WildFlyの基本設定

以下のコマンドを使用してWildFlyサービスを確認します。

ss -plnt  
systemctl status wildfly

そして、以下の結果が得られます。

WildFlyをSystemdサービスとして開始

ご覧の通り、WildFlyはUbuntuシステム上のデフォルトTCPポート「8080」でsystemdサービスとして実行されています。

ステップ4 - WildFly管理コンソールを有効にする

このステップでは、WildFlyをローカルIPアドレス「127.0.0.1」で実行し、その管理コンソールを有効にします。WildFlyの設定「wildfly.conf」、WildFly起動スクリプト「launch.sh」、およびWildFlyサービスファイル「wildfly.service」を編集します。

vimエディタを使用してWildFly設定「/etc/wildfly/wildfly.conf」を編集します。

vim /etc/wildfly/wildfly.conf

今、「WILDFLY_BIND」の値をローカルIPアドレス「127.0.0.1」に変更します。

WILDFLY_BIND=127.0.0.1

WildFly管理コンソールを有効にするために、以下の「WILDFLY_CONSOLE_BIND」設定を追加します。

WILDFLY_CONSOLE_BIND=127.0.0.1

保存して閉じます。

次に、vimエディタを使用してWildFlyの起動スクリプト「/opt/wildfly/bin/launch.sh」を編集します。

vim /opt/wildfly/bin/launch.sh

domain.sh」および「standalone.sh」の行に、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

保存して閉じます。

次に、vimエディタを使用してWildFlyのデフォルトサービスファイル「/etc/systemd/system/wildfly.service」を編集します。

vim /etc/systemd/system/wildfly.service

ExecStart=/opt/wildfly/bin/launch.sh….」の行に、オプション「$WILDFLY_CONSOLE_BIND」を以下のように追加します。

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

保存して閉じます。

今、systemdマネージャーをリロードし、WildFlyサービスを再起動します。

systemctl daemon-reload  
systemctl restart wildfly

WildFly管理コンソールを有効にする

WildFlyサービスは管理コンソールが有効な状態で実行されています。以下のコマンドを使用して確認します。

ss -plnt  
systemctl status wildfly

以下は、得られる結果です。

WildFlyポートとサービスを確認

その結果、WildFlyはローカルIPアドレス「127.0.0.1」でデフォルトTCPポート「8080」で実行され、WildFly管理コンソールがTCPポート「9990」で有効になっています。

ステップ5 - WildFlyの管理ユーザーを設定

このステップでは、WildFlyを管理するための新しいユーザーを作成します。これは、WildFlyが提供するスクリプト「add-user.sh」を使用します。

以下のようにWildFlyの「add-user.sh」スクリプトを実行します。

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

ユーザーの種類として、「a」を入力して管理ユーザー(WildFlyを管理するためのadmin)を作成します。

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

次に、ユーザー名とパスワードを入力し、安全なパスワードを使用することを確認します。

Enter the details of the new user to add.  
Using the realm 'ManagementRealm' as discovered from the existing property files.  
Username : hakase  
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 :

新しいユーザーのグループについては、「Enter」を押して続行します。

What groups do you want this user to belong to? (Please enter a comma separated list, or leave blank for none)[  ]:

次に、「yes」と入力して、WildFlyの「ManagementRealm」にユーザーを追加します。

About to add user 'hakase' for realm 'ManagementRealm'  
Is this correct yes/no? yes  
Added user 'hakase' to file '/opt/wildfly/standalone/configuration/mgmt-users.properties'  
Added user 'hakase' to file '/opt/wildfly/domain/configuration/mgmt-users.properties'  
Added user 'hakase' with groups  to file '/opt/wildfly/standalone/configuration/mgmt-groups.properties'  
Added user 'hakase' with groups  to file '/opt/wildfly/domain/configuration/mgmt-groups.properties'

yes」と入力して、WildFlyのマスタースレーブホストコントローラーを管理するためのプロセスとしてユーザーを有効にします。

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 EJB calls.   
yes/no? yes  
To represent the user add the following to the server-identities definition 

その結果、WildFlyの管理ユーザーが作成されました。

ステップ6 - NginxをWildFlyのリバースプロキシとして設定

このステップでは、Ubuntuシステム上でWildFlyのリバースプロキシとしてNginxをインストールし、設定します。

以下のaptコマンドを使用してNginxパッケージをインストールします。

sudo apt install nginx -y

すべてのインストールが完了したら、「/etc/nginx/」設定ディレクトリに移動します。

cd /etc/nginx/

vimエディタを使用して「/etc/nginx/conf.d」ディレクトリの下に新しいファイル「proxy_headers.conf」を作成します。

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

保存して閉じます。

次に、「/etc/nginx/sites-available」ディレクトリの下にWildFlyの新しい仮想ホスト設定を作成します。

vim sites-available/wildfly

IPアドレスを自分のものに変更し、設定を貼り付けます。

server {  
  listen          80;  
  server_name     SERVER-IP;  
  
  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設定を確認します。

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

エラーがないことを確認したら、Nginxサービスを再起動します。

systemctl restart nginx

その結果、WildFlyのリバースプロキシとしてのNginxのインストールと設定が完了しました。

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

ステップ7 - テスト

ウェブブラウザを開き、アドレスバーにサーバーのIPアドレスを入力します。

http://192.168.1.50/

これで、WildFlyのデフォルトインデックスページが表示されます。

WildFlyデフォルトインデックス

次に、URLパス「/console」でWildFly管理コンソールにアクセスします。

http://192.168.1.50/console/

WildFly管理ユーザーとパスワードを使用してログインします。

WildFly管理ログイン

これで、WildFly管理ダッシュボードが表示されます。

WildFly管理コンソールダッシュボード

その結果、Ubuntu 20.04サーバーにNginxリバースプロキシを使用してWildFlyのインストールが成功裏に完了しました。

Share: X/Twitter LinkedIn

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

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