So installieren Sie Apache Tomcat 10 mit Nginx Reverse Proxy auf Debian 12

Apache Tomcat oder “Tomcat” ist ein kostenloser und Open-Source-Java-Servlet-Container für Java-Code und -Anwendungen. Es bietet eine “reine Java” HTTP-Serverumgebung, in der Java-Code ausgeführt werden kann. Tomcat implementiert auch JavaServer Pages, Java Expression Language und WebSocket-Technologien.

In diesem Leitfaden zeigen wir Ihnen, wie Sie Apache Tomcat 10 auf dem Debian 12-Server installieren. Sie werden auch lernen, wie Sie Nginx als Reverse-Proxy für Apache Tomcat einrichten.

Voraussetzungen

Um zu beginnen, stellen Sie sicher, dass Sie Folgendes haben:

• Einen Debian 12-Server.
• Einen Nicht-Root-Benutzer mit Administratorrechten.

Installation von Java OpenJDK

Apache Tomcat ist hauptsächlich in Java geschrieben, daher müssen Sie Java auf Ihrem System installieren, bevor Sie es installieren. In diesem Beispiel installieren Sie Java OpenJDK 17, das standardmäßig im Debian-Repository verfügbar ist.

Bevor Sie mit der Installation von Java beginnen, aktualisieren und aktualisieren Sie Ihr Debian-Repository mit dem folgenden Befehl.

sudo apt update

Jetzt installieren Sie das Java OpenJDK-Paket auf Ihrem Debian-Server mit dem folgenden Befehl. Das Paket default-jdk bezieht sich auf Java OpenJDK 17, das die LTS-Version von Java ist.

sudo apt install default-jdk

Tippen Sie y, um die Installation zu bestätigen.

Nach der Installation von Java führen Sie den folgenden Befehl aus, um Ihre Java-Version zu überprüfen. Sie werden sehen, dass Java OpenJDK 17 installiert ist.

java --version

Installation von Apache Tomcat über das Repository

Standardmäßig bietet das neueste Debian 12-Repository Apache Tomcat 10 an. Wenn Sie Apache Tomcat über APT installieren möchten, ist diese Methode für Sie geeignet.

Überprüfen Sie zuerst das tomcat10-Paket mit dem folgenden Befehl.

sudo apt info tomcat10

In der folgenden Ausgabe können Sie sehen, dass Apache Tomcat 10 im Haupt-Debian-Repository im Abschnitt java verfügbar ist.

Wenn Sie Tomcat über APT installieren möchten, führen Sie den folgenden Befehl auf Ihrem System aus. Tippen Sie y, um die Installation zu bestätigen.

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

Sobald die Installation abgeschlossen ist, sollte der tomcat10-Dienst ausgeführt werden. Überprüfen Sie dies mit dem folgenden Befehl.

sudo systemctl is-enabled tomcat10  
sudo systemctl status tomcat10

Wenn der tomcat10-Dienst läuft, sollten Sie die folgende Ausgabe erhalten:

Öffnen Sie schließlich Ihren Webbrowser und besuchen Sie die Server-IP-Adresse mit dem Standard-Tomcat-Port 8080 http://192.168.5.15:8080/. Wenn Ihre Installation erfolgreich ist, sollten Sie die Standard-Indexseite von Apache Tomcat 10 erhalten.

Installation von Tomcat über Binärdateien

Wenn Sie jetzt das neueste Paket von Apache Tomcat installieren möchten, können Sie es über das Binärpaket installieren. In diesem Abschnitt lernen Sie, wie Sie dies auf Ihrem Debian-Server tun.

Zuerst erstellen Sie einen neuen Systembenutzer tomcat mit dem folgenden Befehl.

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

Besuchen Sie die Apache Tomcat-Downloadseite und überprüfen Sie die neueste Version von Tomcat. Führen Sie dann den folgenden Befehl aus, um die neueste Apache Tomcat-Version herunterzuladen.

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

Sobald der Download abgeschlossen ist, führen Sie den folgenden Befehl aus, um ein neues Apache Tomcat-Installationsverzeichnis /opt/tomcat zu erstellen und das Tomcat-Binärpaket darin zu extrahieren.

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

Erstellen Sie nun einen neuen Symlink des extrahierten Tomcat-Verzeichnisses zu /opt/tomcat/latest. Ändern Sie dann den Eigentümer des Verzeichnisses /opt/tomcat in den Benutzer tomcat.

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

Erstellen Sie als Nächstes eine neue systemd-Dienstdatei /etc/systemd/system/tomcat.service mit dem nano-Editor.

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

Fügen Sie die folgende Konfiguration ein, um die Dienstdatei für Apache Tomcat einzurichten.

[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

Speichern Sie die Datei und beenden Sie den Editor.

Führen Sie den folgenden Befehl aus, um den systemd-Manager neu zu laden, und starten Sie dann den tomcat-Dienst und aktivieren Sie ihn.

sudo systemctl daemon-reload

sudo systemctl start tomcat  
sudo systemctl enable tomcat

Sobald der Dienst gestartet ist, überprüfen Sie den tomcat-Dienst mit dem folgenden Befehl. Stellen Sie sicher, dass Ihr Tomcat-Dienst wie folgt läuft.

sudo systemctl status tomcat

Öffnen Sie schließlich Ihren Webbrowser und besuchen Sie http://192.168.5.15:8080/. Wenn alles gut läuft, sollten Sie die Apache Tomcat-Indexseite sehen.

Erstellen eines Tomcat-Administrators

An diesem Punkt haben Sie Apache Tomcat auf Ihrem Debian-Server installiert. Im nächsten Schritt richten Sie die Authentifizierung für Apache Tomcat ein und aktivieren den Tomcat-Manager und den Host-Manager.

Um zu beginnen, bearbeiten Sie die Tomcat-Konfigurationsdatei /etc/tomcat10/tomcat-users.xml mit dem folgenden nano-Editor.

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

Fügen Sie die folgenden Zeilen zwischen dem Abschnitt ‘tomcat-users‘ ein. Stellen Sie sicher, dass Sie den Standardbenutzernamen admin und das Passwort tomcatadmin durch Ihre Anmeldeinformationen ersetzen.

Speichern Sie die Datei und beenden Sie den Editor.

Öffnen Sie nun die Konfigurationsdatei für den Tomcat-Manager und den Host-Manager mit dem nano-Editor.

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

‘* wird die Konfiguration deaktiviert oder kommentiert.

Speichern Sie die Datei und beenden Sie den Editor.

Starten Sie als Nächstes den tomcat-Dienst mit dem folgenden Befehl neu, um die neue Tomcat-Konfiguration anzuwenden.

sudo systemctl restart tomcat

Besuchen Sie schließlich http://192.168.5.15:8080/manager, um auf den Tomcat-Manager zuzugreifen, und http://192.168.5.15:8080/host-manager, um auf den Tomcat-Host-Manager zuzugreifen. Geben Sie Ihren Admin-Benutzer und Ihr Passwort ein, wenn Sie dazu aufgefordert werden, und klicken Sie auf Anmelden.

Wenn alles erfolgreich ist, sollten Sie das Dashboard des Apache Tomcat-Managers sehen.

Für den Tomcat-Host-Manager sieht es so aus:

Konfiguration von Nginx als Reverse Proxy

In diesem Leitfaden werden Sie Apache Tomcat mit Nginx als Reverse Proxy ausführen. In diesem Abschnitt installieren Sie Nginx und richten eine Serverblockkonfiguration als Reverse Proxy für Tomcat ein, der auf Port 8080 läuft.

Führen Sie den folgenden Befehl aus, um Nginx auf Ihrem System zu installieren. Tippen Sie y, um die Installation zu bestätigen.

sudo apt install nginx

Sobald die Installation abgeschlossen ist, erstellen Sie eine neue Serverblockkonfiguration /etc/nginx/sites-available/tomcat.conf mit dem nano-Editor.

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

Fügen Sie die folgende Konfiguration hinzu, um Nginx als Reverse Proxy für Apache Tomcat einzurichten.

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

Speichern Sie die Datei und beenden Sie den Editor, wenn Sie fertig sind.

Aktivieren Sie nun die Serverblockkonfiguration und überprüfen Sie die Nginx-Syntax. Wenn alles gut läuft, sollten Sie eine Ausgabe wie ‘test ist erfolgreich - Syntax ist ok‘ erhalten.

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

Starten Sie als Nächstes den Nginx-Dienst neu, um die neuen Änderungen anzuwenden, und überprüfen Sie, ob der Dienst läuft.

sudo systemctl restart nginx  
sudo systemctl status nginx

Wenn Nginx läuft, sollten Sie die folgende Ausgabe erhalten:

Besuchen Sie schließlich wieder Ihren Webbrowser und gehen Sie zu http://tomcat.howtoforge.local/. Sie sollten die Standard-Indexseite von Apache Tomcat sehen.

Fazit

Herzlichen Glückwunsch! Sie haben jetzt Apache Tomcat 10 auf dem Debian 12-Server installiert. Sie haben zwei Methoden zum Installieren von Apache Tomcat gelernt, über das APT-Repository und manuell über das Binärpaket. Am Ende haben Sie auch gelernt, wie Sie Nginx als Reverse Proxy für Ihre Tomcat-Installation einrichten.