Cómo instalar Apache Tomcat 10 con Nginx como proxy inverso en Debian 12

Apache Tomcat o “Tomcat” es un contenedor de servlets Java gratuito y de código abierto para código y aplicaciones Java. Proporciona un entorno de servidor HTTP “puro Java” donde se puede ejecutar código Java. Tomcat también implementa JavaServer Pages, Java Expression Language y tecnologías WebSocket.

En esta guía, te mostraremos cómo instalar Apache Tomcat 10 en el servidor Debian 12. También aprenderás a configurar Nginx como un proxy inverso para Apache Tomcat.

Prerrequisitos

Para comenzar, asegúrate de tener lo siguiente:

• Un servidor Debian 12.
• Un usuario no root con privilegios de administrador.

Instalando Java OpenJDK

Apache Tomcat está escrito principalmente en Java, así que antes de instalarlo, debes instalar Java en tu sistema. En este ejemplo, instalarás Java OpenJDK 17, que está disponible por defecto en el repositorio de Debian.

Antes de comenzar a instalar Java, actualiza y refresca tu repositorio de Debian con el siguiente comando.

sudo apt update

Ahora instala el paquete Java OpenJDK en tu servidor Debian usando el siguiente comando. El paquete default-jdk se refiere a Java OpenJDK 17, que es la versión LTS de Java.

sudo apt install default-jdk

Escribe y para confirmar la instalación.

Después de instalar Java, ejecuta el siguiente comando para verificar tu versión de Java. Verás que Java OpenJDK 17 está instalado.

java --version

Instalando Apache Tomcat a través del Repositorio

Por defecto, el último repositorio de Debian 12 proporciona Apache Tomcat 10. Si necesitas instalar Apache Tomcat a través de APT, entonces este método es adecuado para ti.

Primero, verifica el paquete tomcat10 usando el siguiente comando.

sudo apt info tomcat10

En la salida siguiente, puedes ver que Apache Tomcat 10 está disponible en el repositorio principal de Debian, en la sección de java.

Si deseas instalar Tomcat a través de APT, ejecuta el siguiente comando en tu sistema. Escribe y para confirmar la instalación.

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

Una vez que la instalación esté completa, el servicio tomcat10 debería estar en funcionamiento. Verifícalo con el siguiente comando.

sudo systemctl is-enabled tomcat10  
sudo systemctl status tomcat10

Si el servicio tomcat10 está en funcionamiento, deberías obtener la siguiente salida:

Por último, abre tu navegador web y visita la dirección IP del servidor con el puerto predeterminado de Tomcat 8080 http://192.168.5.15:8080/. Si tu instalación es exitosa, deberías ver la página de índice predeterminada de Apache Tomcat 10.

Instalando Tomcat a través de Binario

Ahora, si deseas instalar el paquete más reciente de Apache Tomcat, puedes instalarlo a través del paquete binario. En esta sección, aprenderás cómo hacerlo en tu servidor Debian.

Primero, crea un nuevo usuario del sistema tomcat con el siguiente comando.

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

Visita la página de descarga de Apache Tomcat y verifica la última versión de Tomcat. Luego ejecuta el siguiente comando para descargar la última versión de 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 vez descargado, ejecuta el siguiente comando para crear un nuevo directorio de instalación de Apache Tomcat /opt/tomcat y extraer el paquete binario de Tomcat en él.

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

Ahora crea un nuevo enlace simbólico del directorio de Tomcat extraído a /opt/tomcat/latest. Luego, cambia la propiedad del directorio /opt/tomcat al usuario tomcat.

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

A continuación, crea un nuevo archivo de servicio systemd /etc/systemd/system/tomcat.service usando el editor nano.

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

Pega la configuración a continuación para configurar el archivo de servicio para 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

Guarda el archivo y sal del editor.

Ejecuta el siguiente comando para recargar el administrador de systemd, luego inicia y habilita el servicio tomcat.

sudo systemctl daemon-reload

sudo systemctl start tomcat  
sudo systemctl enable tomcat

Una vez iniciado, verifica el servicio tomcat usando el siguiente comando. Asegúrate de que tu servicio Tomcat esté en funcionamiento como el siguiente.

sudo systemctl status tomcat

Por último, abre tu navegador web y visita http://192.168.5.15:8080/. Si todo va bien, deberías ver la página de índice de Apache Tomcat.

Creando Administrador de Tomcat

En este punto, has instalado Apache Tomcat en tu servidor Debian. En el siguiente paso, configurarás la autenticación para Apache Tomcat y habilitarás el administrador de Tomcat y el administrador de host.

Para comenzar, edita el archivo de configuración de Tomcat /etc/tomcat10/tomcat-users.xml usando el siguiente editor nano.

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

Inserta las líneas a continuación entre la sección ‘ tomcat-users ‘. Asegúrate de cambiar el nombre de usuario predeterminado admin y la contraseña tomcatadmin por tus credenciales.

Guarda y sal del archivo.

Ahora, abre el archivo de configuración para el administrador de Tomcat y el administrador de host usando el 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 configuración se desactivará o comentará.

Guarda el archivo y sal del editor.

A continuación, reinicia el servicio tomcat con el siguiente comando para aplicar la nueva configuración de Tomcat.

sudo systemctl restart tomcat

Por último, visita http://192.168.5.15:8080/manager para acceder al administrador de Tomcat, y http://192.168.5.15:8080/host-manager para acceder al administrador de host de Tomcat. Ingresa tu usuario y contraseña de administrador cuando se te solicite y haz clic en Iniciar sesión.

Si tienes éxito, deberías ver el panel de control del administrador de Apache Tomcat.

Para el administrador de host de Tomcat, así es como se ve:

Configurando Nginx como un Proxy Inverso

En esta guía, ejecutarás Apache Tomcat con Nginx como un proxy inverso. En esta sección, instalarás nginx y configurarás un bloque de servidor como un proxy inverso para Tomcat que se ejecuta en el puerto 8080.

Ejecuta el siguiente comando para instalar Nginx en tu sistema. Escribe y para confirmar la instalación.

sudo apt install nginx

Una vez que la instalación esté completa, crea una nueva configuración de bloque de servidor /etc/nginx/sites-available/tomcat.conf usando el editor nano.

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

Agrega la configuración a continuación para configurar Nginx como un proxy inverso para 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/;  
}  
}

Guarda y sal del archivo cuando termines.

Ahora, activa la configuración del bloque de servidor y verifica la sintaxis de tu Nginx. Si todo va bien, deberías obtener una salida como ‘ la prueba es exitosa - la sintaxis es correcta ‘.

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

A continuación, reinicia el servicio Nginx para aplicar los nuevos cambios y verifícalo para asegurarte de que el servicio esté en funcionamiento.

sudo systemctl restart nginx  
sudo systemctl status nginx

Si Nginx está en funcionamiento, deberías obtener la siguiente salida:

Por último, vuelve a tu navegador web y visita http://tomcat.howtoforge.local/. Deberías ver la página de índice predeterminada de Apache Tomcat.

Conclusión

¡Felicidades! Ahora has instalado Apache Tomcat 10 en el servidor Debian 12. Has aprendido dos métodos para instalar Apache Tomcat, a través del repositorio APT y manualmente a través del paquete binario. Al final, también has aprendido cómo configurar Nginx como un proxy inverso para tu instalación de Tomcat.