Cómo instalar Apache Tomcat con Nginx como proxy inverso en Ubuntu 24.04

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. Soporta SSL para asegurar datos sensibles como la autenticación.

Esta guía te enseñará cómo instalar Apache Tomcat en un servidor Ubuntu 24.04. Instalarás Apache Tomcat 10 con Java OpenJDK 21 y luego instalarás y configurarás Nginx como un proxy inverso.

Prerrequisitos

Antes de continuar, asegúrate de tener:

Un servidor Ubuntu 24.04.
Un usuario no root con privilegios de administrador.

Instalando Java OpenJDK

Antes de instalar Apache Tomcat, necesitas asegurarte de que Java esté instalado. La última versión de Apache Tomcat 10 requiere al menos Java 11 o posterior. En esta sección, instalarás Java OpenJDK 21 desde el repositorio oficial de Ubuntu.

Para comenzar, actualiza tu índice de paquetes de Ubuntu con el siguiente comando.

sudo apt update

update repo

Ahora instala Java OpenJDK con el siguiente comando. En Ubuntu 24.04, el ‘default-jdk’ se refiere a OpenJDK 21, que es la versión LTS de Java.

sudo apt install default-jdk

Ingresa Y para continuar con la instalación.

install java

Después de que la instalación esté completa, verifica la versión de Java usando el siguiente comando. Deberías ver que Java OpenJDK 21 está instalado en tu servidor Ubuntu.

java --version

Instalando Apache Tomcat 10

El Apache Tomcat 10 está disponible por defecto en el repositorio de Ubuntu en la última versión de Ubuntu. Esto te permite instalar Tomcat fácilmente usando el gestor de paquetes APT.

Primero, verifica la información del paquete ‘tomcat10‘ con el siguiente comando.

sudo apt info tomcat10

Lo siguiente muestra que Apache Tomcat 10.1.16 está disponible en el repositorio ‘ universe/java ‘ de Ubuntu.

info tomcat10 package

Ahora instala Apache Tomcat en tu sistema Ubuntu con el comando a continuación. Con este comando, también instalarás las aplicaciones web de administración de Tomcat, herramientas para crear usuarios y ejemplos de aplicaciones web de Tomcat.

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

Ingresa Y para confirmar la instalación.

installing apache tomcat

El servicio ‘tomcat10’ se creará cuando la instalación haya terminado.

Verifica el estado del servicio ‘tomcat10‘ con el siguiente comando:

sudo systemctl is-enabled tomcat10  
sudo systemctl status tomcat10

Puedes ver a continuación, el servicio ‘tomcat10‘ está habilitado y activo (en ejecución). El servicio ‘tomcat10‘ se iniciará automáticamente al arrancar.

check tomcat service

Ahora ejecuta el siguiente comando para verificar el puerto 8080 de Apache Tomcat. Si Tomcat está en ejecución, verás que la aplicación Java utiliza el puerto 8080.

ss -tulpn

Por último, visita http://192.168.5.30:8080/ usando tu navegador web y verás la página de índice predeterminada de Apache Tomcat como la siguiente:

tomcat index

Configurando la autenticación de Apache Tomcat

En esta sección, configurarás la autenticación básica y permitirás el acceso al administrador del host de Tomcat y al administrador. Habilitarás la autenticación básica de Tomcat editando el archivo ‘tomcat-users.xml’, luego permitirás el acceso tanto al administrador del host de Tomcat como al administrador a través del paquete ‘tomcat10-admin’.

Abre la configuración de usuario de Tomcat ‘/etc/tomcat10/tomcat-users.xml’ usando el editor nano.

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

Inserta la siguiente configuración entre el ‘ …. ’. En este ejemplo, crearás un usuario de Apache Tomcat ‘ admin ‘ con la contraseña ‘ tomcatadmin ‘ y múltiples roles incluyendo ‘admin-gui’ y ‘manager-gui’.

Cuando termines, guarda y sal del archivo.

Ahora abre la configuración para el ‘ host-manager ‘ y ‘ manager ‘ de Tomcat con el comando del editor nano a continuación.

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

‘. Con esto, permitirás el acceso remoto al ‘ host-manager ‘ y ‘ manager* ‘ de Apache Tomcat.

Guarda y sal del archivo.

Después de editar, ejecuta el siguiente comando para reiniciar el servicio ‘tomcat10’ y aplicar los nuevos cambios a tu instalación de Apache Tomcat.

sudo systemctl restart tomcat10

Por último, visita http://192.168.5.30:8080/host-manager/ para acceder al administrador de hosts virtual de Apache Tomcat y http://192.168.5.30:8080/manager/ para acceder al administrador de Tomcat.

Escribe el usuario ‘ admin ‘ y la contraseña ‘ tomcatadmin ‘ cuando se te pida.

Si la autenticación es exitosa, deberías obtener la página del administrador de hosts y del administrador de Apache Tomcat como la siguiente:

Administrador de Apache Tomcat.

tomcat manager

Administrador de hosts de Apache Tomcat.

tomcat manager

Configurando Nginx como un proxy inverso

En esta guía, instalarás el servidor web Nginx y lo configurarás como un proxy inverso para tu instalación de Apache Tomcat. Al usar un proxy inverso, puedes acceder fácilmente a tu aplicación Tomcat a través de tu nombre de dominio local.

Para instalar el servidor web Nginx en tu Ubuntu, ejecuta lo siguiente:

sudo apt install nginx -y

install nginx

Cuando la instalación haya terminado, crea una nueva configuración de bloque de servidor ‘ /etc/nginx/sites-available/tomcat10 ‘ que se utilizará como un proxy inverso para Apache Tomcat.

sudo nano /etc/nginx/sites-available/tomcat10

Agrega la configuración a continuación y cambia tu nombre de dominio local usando la opción server_name.

server {  
 listen 80;  
  
 server_name tomcat10.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 ejecuta el siguiente comando para activar la configuración del bloque de servidor ‘tomcat10’ y probar la sintaxis de Nginx.

sudo ln -s /etc/nginx/sites-available/tomcat10 /etc/nginx/sites-enabled/  
sudo nginx -t

Si tienes una sintaxis de Nginx correcta y adecuada, verás una salida ‘ syntax is ok … test is successful ‘.

A continuación, ejecuta el siguiente comando para reiniciar el servicio Nginx y aplicar el bloque de servidor ‘tomcat10’. Luego, verifica el estado del servicio Nginx para asegurarte de que esté en ejecución.

sudo systemctl restart nginx  
sudo systemctl status nginx

La salida a continuación muestra que el servidor web Nginx está en ejecución. Y puedes acceder a tu instalación de Apache Tomcat usando un nombre de dominio como ‘ tomcat10.howtoforge.local ‘.

check nginx service

Puedes agregar la siguiente configuración al archivo ‘hosts’ en tu máquina local. Para usuarios de Linux o Mac, agrega lo siguiente al archivo ‘ /etc/hosts ‘. En cuanto a los usuarios de Windows, agrega la configuración a continuación al archivo ‘ C:\Windows\System32\drivers\etc\hosts ‘.

192.168.5.30 tomcat10.howtoforge.local

Por último, visita http://tomcat10.howtoforge.local usando tu navegador web. Si tu instalación de proxy inverso Nginx es exitosa, verás la página de índice de Apache Tomcat como la siguiente:

tomcat index

Visita http://tomcat10.howtoforge.local/host-manager/ para acceder al administrador de hosts de Apache Tomcat y http://tomcat10.howtoforge.local/manager/ para acceder al administrador de Apache Tomcat. Verás ambas aplicaciones ejecutándose bajo el proxy inverso Nginx.

Conclusión

¡Felicidades! Has instalado con éxito Apache Tomcat en el servidor Ubuntu 24.04. Has instalado Tomcat 10 con Java OpenJDK 21 en Ubuntu. Además, has instalado y configurado Nginx como un proxy inverso para Apache Tomcat.