Come installare Apache Tomcat 10 con Nginx Reverse Proxy su Debian 12

Apache Tomcat o “Tomcat” è un contenitore di servlet Java gratuito e open-source per codice e applicazioni Java. Fornisce un ambiente server HTTP “puro Java” in cui il codice Java può essere eseguito. Tomcat implementa anche JavaServer Pages, Java Expression Language e tecnologie WebSocket.

In questa guida, ti mostreremo come installare Apache Tomcat 10 sul server Debian 12. Imparerai anche come configurare Nginx come reverse proxy per Apache Tomcat.

Prerequisiti

Per iniziare, assicurati di avere quanto segue:

• Un server Debian 12.
• Un utente non root con privilegi di amministratore.

Installazione di Java OpenJDK

Apache Tomcat è principalmente scritto in Java, quindi prima di installarlo, devi installare Java sul tuo sistema. In questo esempio, installerai Java OpenJDK 17, che è disponibile per impostazione predefinita nel repository Debian.

Prima di iniziare a installare Java, aggiorna e aggiorna il tuo repository Debian con il comando qui sotto.

sudo apt update

Ora installa il pacchetto Java OpenJDK sul tuo server Debian utilizzando il seguente comando. Il pacchetto default-jdk si riferisce a Java OpenJDK 17, che è la versione LTS di Java.

sudo apt install default-jdk

Digita y per confermare l’installazione.

Dopo aver installato Java, esegui il comando qui sotto per verificare la tua versione di Java. Vedrai che Java OpenJDK 17 è installato.

java --version

Installazione di Apache Tomcat tramite Repository

Per impostazione predefinita, l’ultimo repository Debian 12 fornisce Apache Tomcat 10. Se hai bisogno di installare Apache Tomcat tramite APT, allora questo metodo è adatto a te.

Per prima cosa, controlla il pacchetto tomcat10 utilizzando il comando qui sotto.

sudo apt info tomcat10

Nell’output seguente, puoi vedere che Apache Tomcat 10 è disponibile nel repository principale di Debian, nella sezione java.

Se desideri installare Tomcat tramite APT, esegui il comando qui sotto sul tuo sistema. Digita y per confermare l’installazione.

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

Una volta completata l’installazione, il servizio tomcat10 dovrebbe essere in esecuzione. Verificalo con il comando qui sotto.

sudo systemctl is-enabled tomcat10  
sudo systemctl status tomcat10

Se il servizio tomcat10 è in esecuzione, dovresti ottenere il seguente output:

Infine, apri il tuo browser web e visita l’indirizzo IP del server con la porta predefinita di Tomcat 8080 http://192.168.5.15:8080/. Se la tua installazione è riuscita, dovresti vedere la pagina indice predefinita di Apache Tomcat 10.

Installazione di Tomcat tramite Binario

Ora, se desideri installare l’ultimo pacchetto di Apache Tomcat, puoi installarlo tramite pacchetto binario. In questa sezione, imparerai come farlo sul tuo server Debian.

Per prima cosa, crea un nuovo utente di sistema tomcat con il comando qui sotto.

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

Visita la pagina di download di Apache Tomcat e controlla l’ultima versione di Tomcat. Quindi esegui il comando qui sotto per scaricare l’ultima versione di 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

Una volta scaricato, esegui il comando qui sotto per creare una nuova directory di installazione di Apache Tomcat /opt/tomcat ed estrarre il pacchetto binario di Tomcat al suo interno.

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

Ora crea un nuovo symlink della directory Tomcat estratta in /opt/tomcat/latest. Quindi, cambia la proprietà della directory /opt/tomcat all’utente tomcat.

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

Successivamente, crea un nuovo file di servizio systemd /etc/systemd/system/tomcat.service utilizzando l’editor nano.

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

Incolla la configurazione qui sotto per impostare il file di servizio per 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

Salva il file ed esci dall’editor.

Esegui il comando qui sotto per ricaricare il gestore systemd, quindi avvia e abilita il servizio tomcat.

sudo systemctl daemon-reload

sudo systemctl start tomcat  
sudo systemctl enable tomcat

Una volta avviato, verifica il servizio tomcat utilizzando il comando qui sotto. Assicurati che il tuo servizio Tomcat sia in esecuzione come segue.

sudo systemctl status tomcat

Infine, apri il tuo browser web e visita http://192.168.5.15:8080/. Se tutto va bene, dovresti vedere la pagina indice di Apache Tomcat.

Creazione dell’Amministratore di Tomcat

A questo punto, hai installato Apache Tomcat sul tuo server Debian. Nel passaggio successivo, configurerai l’autenticazione per Apache Tomcat e abiliterai il manager di Tomcat e l’host-manager.

Per iniziare, modifica il file di configurazione di Tomcat /etc/tomcat10/tomcat-users.xml utilizzando il seguente editor nano.

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

Inserisci le righe qui sotto tra la sezione ‘ tomcat-users ‘. Assicurati di cambiare il nome utente predefinito admin e la password tomcatadmin con le tue credenziali.

Salva ed esci dal file.

Ora, apri il file di configurazione per il manager di Tomcat e l’host-manager utilizzando l’editor nano.

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

‘*, la configurazione sarà disabilitata o commentata.

Salva il file ed esci dall’editor.

Successivamente, riavvia il servizio tomcat con il comando qui sotto per applicare la nuova configurazione di Tomcat.

sudo systemctl restart tomcat

Infine, visita http://192.168.5.15:8080/manager per accedere al manager di Tomcat, e http://192.168.5.15:8080/host-manager per accedere all’host manager di Tomcat. Inserisci il tuo utente admin e la password quando richiesto e fai clic su Accedi.

Se hai successo, dovresti vedere la dashboard del manager di Apache Tomcat.

Per l’host-manager di Tomcat, ecco come appare:

Configurazione di Nginx come Reverse Proxy

In questa guida, eseguirai Apache Tomcat con Nginx come reverse proxy. In questa sezione, installerai nginx e configurerai un blocco server come reverse proxy per Tomcat che gira sulla porta 8080.

Esegui il comando qui sotto per installare Nginx sul tuo sistema. Digita y per confermare l’installazione.

sudo apt install nginx

Una volta completata l’installazione, crea una nuova configurazione del blocco server /etc/nginx/sites-available/tomcat.conf utilizzando l’editor nano.

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

Aggiungi la configurazione qui sotto per impostare Nginx come reverse proxy per 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/;  
}  
}

Salva ed esci dal file quando hai finito.

Ora, attiva la configurazione del blocco server e verifica la sintassi di Nginx. Se tutto va bene, dovresti ottenere un output come ‘ test riuscito - sintassi ok ‘.

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

Successivamente, riavvia il servizio Nginx per applicare le nuove modifiche e verifica che il servizio sia in esecuzione.

sudo systemctl restart nginx  
sudo systemctl status nginx

Se Nginx è in esecuzione, dovresti ottenere il seguente output:

Infine, torna al tuo browser web e visita http://tomcat.howtoforge.local/. Dovresti vedere la pagina indice predefinita di Apache Tomcat.

Conclusione

Congratulazioni! Hai ora installato Apache Tomcat 10 sul server Debian 12. Hai appreso due metodi per installare Apache Tomcat, tramite repository APT e manualmente tramite pacchetto binario. Alla fine, hai anche imparato come configurare Nginx come reverse proxy per la tua installazione di Tomcat.