Como Instalar Apache Tomcat com Nginx Reverse Proxy no Ubuntu 24.04

Apache Tomcat ou “Tomcat” é um contêiner de Servlets Java gratuito e de código aberto para código e aplicações Java. Ele fornece um ambiente de servidor HTTP “puro Java” onde o código Java pode ser executado. O Tomcat também implementa JavaServer Pages, Java Expression Language e tecnologias WebSocket. Ele suporta SSL para proteger dados sensíveis, como autenticação.

Este guia ensinará você a instalar o Apache Tomcat em um servidor Ubuntu 24.04. Você instalará o Apache Tomcat 10 com o Java OpenJDK 21 e, em seguida, instalará e configurará o Nginx como um proxy reverso.

Pré-requisitos

Antes de prosseguir, certifique-se de que você tem:

Um servidor Ubuntu 24.04.
Um usuário não-root com privilégios de administrador.

Instalando Java OpenJDK

Antes de instalar o Apache Tomcat, você precisa garantir que o Java esteja instalado. O Apache Tomcat 10 mais recente requer pelo menos Java 11 ou posterior. Nesta seção, você instalará o Java OpenJDK 21 do repositório oficial do Ubuntu.

Para começar, atualize o índice de pacotes do Ubuntu com o comando abaixo.

sudo apt update

atualizar repositório

Agora instale o Java OpenJDK com o seguinte comando. No Ubuntu 24.04, o ‘default-jdk’ refere-se ao OpenJDK 21, que é a versão LTS do Java.

sudo apt install default-jdk

Digite Y para prosseguir com a instalação.

instalar java

Após a conclusão da instalação, verifique a versão do Java usando o seguinte comando. Você deve ver que o Java OpenJDK 21 está instalado em seu servidor Ubuntu.

java --version

Instalando Apache Tomcat 10

O Apache Tomcat 10 está disponível por padrão no repositório do Ubuntu na versão mais recente do Ubuntu. Isso permite que você instale o Tomcat facilmente usando o gerenciador de pacotes APT.

Primeiro, verifique as informações do pacote ‘tomcat10‘ com o seguinte comando.

sudo apt info tomcat10

O seguinte mostra que Apache Tomcat 10.1.16 está disponível no repositório ‘universe/java‘ do Ubuntu.

info pacote tomcat10

Agora instale o Apache Tomcat em seu sistema Ubuntu com o comando abaixo. Com este comando, você também instalará as aplicações web administrativas do Tomcat, ferramentas para criar usuários e exemplos de aplicações web do Tomcat.

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

Digite Y para confirmar a instalação.

instalando apache tomcat

O serviço ‘tomcat10’ será criado quando a instalação for concluída.

Verifique o status do serviço ‘tomcat10‘ com o seguinte comando:

sudo systemctl is-enabled tomcat10  
sudo systemctl status tomcat10

Você pode ver abaixo que o serviço ‘tomcat10‘ está habilitado e ativo (em execução). O serviço ‘tomcat10‘ será iniciado automaticamente na inicialização.

verificar serviço tomcat

Agora execute o comando abaixo para verificar a porta 8080 do Apache Tomcat. Se o Tomcat estiver em execução, você verá que a aplicação Java usa a porta 8080.

ss -tulpn

Por fim, visite http://192.168.5.30:8080/ usando seu navegador e você verá a página de índice padrão do Apache Tomcat como a seguinte:

índice tomcat

Configurando a autenticação do Apache Tomcat

Nesta seção, você configurará a autenticação básica e permitirá o acesso ao gerenciador de hosts e ao gerenciador do Tomcat. Você habilitará a autenticação básica do Tomcat editando o arquivo ‘tomcat-users.xml’, permitindo o acesso tanto ao gerenciador de hosts do Tomcat quanto ao gerenciador através do pacote ‘tomcat10-admin’.

Abra a configuração do usuário do Tomcat ‘/etc/tomcat10/tomcat-users.xml’ usando o editor nano.

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

Insira a seguinte configuração entre os ‘ …. ’. Neste exemplo, você criará o usuário do Apache Tomcat ‘admin‘ com a senha ‘tomcatadmin‘ e vários papéis, incluindo ‘admin-gui’ e ‘manager-gui’.

Quando terminar, salve e saia do arquivo.

Agora abra a configuração para o ‘ host-manager ‘ e ‘ manager ‘ do Tomcat com o comando do editor nano abaixo.

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

‘. Com isso, você permitirá o acesso remoto ao ‘ host-manager ‘ e ‘ manager* ‘ do Apache Tomcat.

Salve e saia do arquivo.

Após a edição, execute o seguinte comando para reiniciar o serviço ‘tomcat10’ e aplicar as novas alterações à sua instalação do Apache Tomcat.

sudo systemctl restart tomcat10

Por fim, visite http://192.168.5.30:8080/host-manager/ para acessar o gerenciador de hosts do Apache Tomcat e http://192.168.5.30:8080/manager/ para acessar o gerenciador do Tomcat.

Digite o usuário ‘admin‘ e a senha ‘tomcatadmin‘ quando solicitado.

Se a autenticação for bem-sucedida, você deve obter a página do gerenciador de hosts e do gerenciador do Apache Tomcat como a seguinte:

Gerenciador do Apache Tomcat.

gerenciador tomcat

Gerenciador de hosts do Apache Tomcat.

gerenciador tomcat

Configurando o Nginx como um proxy reverso

Neste guia, você instalará o servidor web Nginx e o configurará como um proxy reverso para sua instalação do Apache Tomcat. Usando um proxy reverso, você pode acessar facilmente sua aplicação Tomcat através do seu nome de domínio local.

Para instalar o servidor web Nginx no seu Ubuntu, execute o seguinte:

sudo apt install nginx -y

instalar nginx

Quando a instalação estiver concluída, crie uma nova configuração de bloco de servidor ‘ /etc/nginx/sites-available/tomcat10 ‘ que será usada como um proxy reverso para o Apache Tomcat.

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

Adicione a configuração abaixo e altere seu nome de domínio local usando a opção 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/;  
 }  
}

Salve e saia do arquivo quando terminar.

Agora execute o comando abaixo para ativar a configuração do bloco de servidor ‘tomcat10’ e testar sua sintaxe do Nginx.

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

Se você tiver uma sintaxe correta e adequada do Nginx, verá uma saída ‘syntax is ok … test is successful‘.

Em seguida, execute o seguinte comando para reiniciar o serviço Nginx e aplicar o bloco de servidor ‘tomcat10’. Depois, verifique o status do serviço Nginx para garantir que ele esteja em execução.

sudo systemctl restart nginx  
sudo systemctl status nginx

A saída abaixo mostra que o servidor web Nginx está em execução. E você pode acessar sua instalação do Apache Tomcat usando um nome de domínio como ‘tomcat10.howtoforge.local‘.

verificar serviço nginx

Você pode adicionar a seguinte configuração ao arquivo ‘hosts’ em sua máquina local. Para usuários de Linux ou Mac, adicione o seguinte ao arquivo ‘/etc/hosts‘. Quanto aos usuários do Windows, adicione a configuração abaixo ao arquivo ‘C:\Windows\System32\drivers\etc\hosts‘.

192.168.5.30 tomcat10.howtoforge.local

Por fim, visite http://tomcat10.howtoforge.local usando seu navegador. Se sua instalação do proxy reverso Nginx for bem-sucedida, você verá a página de índice do Apache Tomcat como a seguinte:

índice tomcat

Visite http://tomcat10.howtoforge.local/host-manager/ para acessar o gerenciador de hosts do Apache Tomcat e http://tomcat10.howtoforge.local/manager/ para acessar o gerenciador do Apache Tomcat. Você verá ambas as aplicações em execução sob o proxy reverso Nginx.

Conclusão

Parabéns! Você instalou com sucesso o Apache Tomcat no servidor Ubuntu 24.04. Você instalou o Tomcat 10 com o Java OpenJDK 21 no Ubuntu. Além disso, você instalou e configurou o Nginx como um proxy reverso para o Apache Tomcat.