Debian 12にNginxリバースプロキシを使用してApache Tomcat 10をインストールする方法

Apache Tomcatまたは「Tomcat」は、Javaコードおよびアプリケーション用の無料でオープンソースのJavaサーブレットコンテナです。これは、Javaコードが実行できる「純粋なJava」HTTPサーバー環境を提供します。Tomcatはまた、JavaServer Pages、Java Expression Language、およびWebSocket技術を実装しています。

このガイドでは、Debian 12サーバーにApache Tomcat 10をインストールする方法を示します。また、Apache TomcatのリバースプロキシとしてNginxを設定する方法も学びます。

前提条件

始める前に、以下のものを用意してください：

Debian 12サーバー。
管理者権限を持つ非ルートユーザー。

Java OpenJDKのインストール

Apache Tomcatは主にJavaで書かれているため、インストールする前にシステムにJavaをインストールする必要があります。この例では、Debianリポジトリにデフォルトで用意されているJava OpenJDK 17をインストールします。

Javaのインストールを開始する前に、以下のコマンドでDebianリポジトリを更新およびリフレッシュします。

sudo apt update

update repo

次に、以下のコマンドを使用してDebianサーバーにJava OpenJDKパッケージをインストールします。default-jdkパッケージはJavaのLTSバージョンであるJava OpenJDK 17を指します。

sudo apt install default-jdk

インストールを確認するためにyと入力します。

install java

Javaをインストールした後、以下のコマンドを実行してJavaのバージョンを確認します。Java OpenJDK 17がインストールされていることがわかります。

java --version

リポジトリ経由でのApache Tomcatのインストール

デフォルトでは、最新のDebian 12リポジトリはApache Tomcat 10を提供しています。APTを介してApache Tomcatをインストールする必要がある場合、この方法が適しています。

まず、以下のコマンドを使用してtomcat10パッケージを確認します。

sudo apt info tomcat10

次の出力では、Apache Tomcat 10がDebianリポジトリのjavaセクションで利用可能であることがわかります。

check tomcat10

APTを介してTomcatをインストールしたい場合は、システムで以下のコマンドを実行します。インストールを確認するためにyと入力します。

sudo apt install tomcat10 tomcat10-common tomcat10-admin tomcat10-user tomcat10-examples

install tomcat10

インストールが完了すると、tomcat10サービスが実行されているはずです。以下のコマンドで確認します。

sudo systemctl is-enabled tomcat10  
sudo systemctl status tomcat10

tomcat10サービスが実行されている場合、次の出力が得られます。

tomcat status

最後に、ウェブブラウザを開き、デフォルトのTomcatポート8080でサーバーのIPアドレスにアクセスします http://192.168.5.15:8080/。インストールが成功していれば、Apache Tomcat 10のデフォルトインデックスページが表示されます。

tomcat index

バイナリ経由でのTomcatのインストール

最新のApache Tomcatパッケージをインストールしたい場合は、バイナリパッケージを介してインストールできます。このセクションでは、Debianサーバーでの手順を学びます。

まず、以下のコマンドを使用して新しいシステムユーザーtomcatを作成します。

sudo useradd -m -u -d /opt/tomcat -s /usr/sbin/nologin tomcat

Apache Tomcatのダウンロードページにアクセスし、Tomcatの最新バージョンを確認します。次に、以下のコマンドを実行して最新のApache Tomcatバージョンをダウンロードします。

export VERSION=10.1.19  
wget https://www-eu.apache.org/dist/tomcat/tomcat-10/v${VERSION}/bin/apache-tomcat-${VERSION}.tar.gz

ダウンロードが完了したら、以下のコマンドを実行して新しいApache Tomcatインストールディレクトリ/opt/tomcatを作成し、Tomcatバイナリパッケージをそこに抽出します。

mkdir -p /opt/tomcat  
sudo tar -xf apache-tomcat-${VERSION}.tar.gz -C /opt/tomcat

次に、抽出したTomcatディレクトリの新しいシンボリックリンクを/opt/tomcat/latestに作成します。その後、/opt/tomcatディレクトリの所有権をtomcatユーザーに変更します。

sudo ln -s /opt/tomcat/apache-tomcat-${VERSION} /opt/tomcat/latest  
sudo chown -R tomcat:tomcat /opt/tomcat

次に、nanoエディタを使用して新しいsystemdサービスファイル/etc/systemd/system/tomcat.serviceを作成します。

sudo nano /etc/systemd/system/tomcat.service

以下の設定を貼り付けて、Apache Tomcatのサービスファイルを設定します。

[Unit]  
Description=Tomcat 10 servlet container  
After=network.target  
  
[Service]  
Type=forking  
  
User=tomcat  
Group=tomcat  
  
Environment="JAVA_HOME=/usr/lib/jvm/default-java"  
Environment="JAVA_OPTS=-Djava.security.egd=file:///dev/urandom -Djava.awt.headless=true"  
  
Environment="CATALINA_BASE=/opt/tomcat/latest"  
Environment="CATALINA_HOME=/opt/tomcat/latest"  
Environment="CATALINA_PID=/opt/tomcat/latest/temp/tomcat.pid"  
Environment="CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC"  
  
ExecStart=/opt/tomcat/latest/bin/startup.sh  
ExecStop=/opt/tomcat/latest/bin/shutdown.sh  
  
[Install]  
WantedBy=multi-user.target

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

以下のコマンドを実行してsystemdマネージャーをリロードし、tomcatサービスを開始して有効にします。

sudo systemctl daemon-reload

sudo systemctl start tomcat  
sudo systemctl enable tomcat

setup tomcat

開始したら、以下のコマンドを使用してtomcatサービスを確認します。Tomcatサービスが次のように実行されていることを確認してください。

sudo systemctl status tomcat

verify tomcat

最後に、ウェブブラウザを開き、http://192.168.5.15:8080/にアクセスします。すべてがうまくいけば、Apache Tomcatのインデックスページが表示されます。

tomcat index

Tomcat管理者の作成

この時点で、DebianサーバーにApache Tomcatをインストールしました。次のステップでは、Apache Tomcatの認証を設定し、Tomcatマネージャーとホストマネージャーを有効にします。

まず、以下のnanoエディタを使用してTomcat設定ファイル/etc/tomcat10/tomcat-users.xmlを編集します。

sudo nano /etc/tomcat10/tomcat-users.xml

以下の行を「tomcat-users」セクションの間に挿入します。デフォルトのユーザー名adminとパスワードtomcatadminを自分の資格情報に変更してください。

ファイルを保存して終了します。

次に、nanoエディタを使用してTomcatマネージャーおよびホストマネージャーの設定ファイルを開きます。

sudo nano /usr/share/tomcat10-admin/host-manager/META-INF/context.xml  
sudo nano /usr/share/tomcat10-admin/manager/META-INF/context.xml

‘*を追加することで、設定が無効またはコメントアウトされます。

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

次に、以下のコマンドでTomcatサービスを再起動して新しいTomcat設定を適用します。

sudo systemctl restart tomcat

最後に、http://192.168.5.15:8080/managerにアクセスしてTomcatマネージャーにアクセスし、http://192.168.5.15:8080/host-managerにアクセスしてTomcatホストマネージャーにアクセスします。プロンプトが表示されたら、管理者ユーザー名とパスワードを入力し、サインインをクリックします。

tomcat login

成功すれば、Apache Tomcatマネージャーダッシュボードが表示されます。

tomcat manager

Tomcatホストマネージャーは以下のようになります。

tomcat host manager

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

このガイドでは、Nginxをリバースプロキシとして使用してApache Tomcatを実行します。このセクションでは、nginxをインストールし、ポート8080で実行されているTomcatのリバースプロキシとしてのサーバーブロック設定を行います。

以下のコマンドを実行してシステムにNginxをインストールします。インストールを確認するためにyと入力します。

sudo apt install nginx

install nginx

インストールが完了したら、nanoエディタを使用して新しいサーバーブロック設定/etc/nginx/sites-available/tomcat.confを作成します。

sudo nano /etc/nginx/sites-available/tomcat.conf

以下の設定を追加して、NginxをApache Tomcatのリバースプロキシとして設定します。

server {  
listen 80;  
  
server_name tomcat.howtoforge.local;  
access_log /var/log/nginx/tomcat-access.log;  
error_log /var/log/nginx/tomcat-error.log;  
  
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://127.0.0.1:8080/;  
}  
}

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

次に、サーバーブロック設定を有効にし、Nginxの構文を確認します。すべてがうまくいけば、’ test is successful - syntax is ok ‘という出力が得られます。

sudo ln -s /etc/nginx/sites-available/tomcat.conf /etc/nginx/sites-enabled/  
sudo nginx -t

次に、Nginxサービスを再起動して新しい変更を適用し、サービスが実行されていることを確認します。

sudo systemctl restart nginx  
sudo systemctl status nginx

Nginxが実行されている場合、次の出力が得られます。

verify nginx

最後に、ウェブブラウザに戻り、http://tomcat.howtoforge.local/にアクセスします。Apache Tomcatのデフォルトインデックスページが表示されるはずです。

tomcat nginx reverse proxy

結論

おめでとうございます！Debian 12サーバーにApache Tomcat 10をインストールしました。APTリポジトリを介してとバイナリパッケージを介してApache Tomcatをインストールする2つの方法を学びました。最後に、TomcatインストールのためにNginxをリバースプロキシとして設定する方法も学びました。