Como Instalar Apache Tomcat 10 com Nginx Reverse Proxy no Debian 12

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.

Neste guia, vamos mostrar como instalar o Apache Tomcat 10 no servidor Debian 12. Você também aprenderá como configurar o Nginx como um proxy reverso para o Apache Tomcat.

Pré-requisitos

Para começar, certifique-se de que você tem o seguinte:

• Um servidor Debian 12.
• Um usuário não-root com privilégios de administrador.

Instalando Java OpenJDK

O Apache Tomcat é principalmente escrito em Java, então antes de instalá-lo, você deve instalar o Java em seu sistema. Neste exemplo, você instalará o Java OpenJDK 17, que está disponível por padrão no repositório Debian.

Antes de começar a instalar o Java, atualize e atualize seu repositório Debian com o comando abaixo.

sudo apt update

Agora instale o pacote Java OpenJDK em seu servidor Debian usando o seguinte comando. O pacote default-jdk refere-se ao Java OpenJDK 17, que é a versão LTS do Java.

sudo apt install default-jdk

Digite y para confirmar a instalação.

Após instalar o Java, execute o comando abaixo para verificar sua versão do Java. Você verá que o Java OpenJDK 17 está instalado.

java --version

Instalando Apache Tomcat via Repositório

Por padrão, o repositório Debian 12 mais recente fornece o Apache Tomcat 10. Se você precisar instalar o Apache Tomcat via APT, então este método é adequado para você.

Primeiro, verifique o pacote tomcat10 usando o comando abaixo.

sudo apt info tomcat10

Na saída a seguir, você pode ver que o Apache Tomcat 10 está disponível no repositório principal do Debian, na seção de java.

Se você quiser instalar o Tomcat via APT, execute o comando abaixo em seu sistema. Digite y para confirmar a instalação.

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

Uma vez que a instalação esteja completa, o serviço tomcat10 deve estar em execução. Verifique com o comando abaixo.

sudo systemctl is-enabled tomcat10  
sudo systemctl status tomcat10

Se o serviço tomcat10 estiver em execução, você deve obter a seguinte saída:

Por fim, abra seu navegador e visite o endereço IP do servidor com a porta padrão do Tomcat 8080 http://192.168.5.15:8080/. Se sua instalação for bem-sucedida, você deve ver a página de índice padrão do Apache Tomcat 10.

Instalando Tomcat via Binário

Agora, se você quiser instalar o pacote mais recente do Apache Tomcat, pode instalá-lo via pacote binário. Nesta seção, você aprenderá como fazê-lo em seu servidor Debian.

Primeiro, crie um novo usuário do sistema tomcat com o comando abaixo.

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

Visite a página de download do Apache Tomcat e verifique a versão mais recente do Tomcat. Em seguida, execute o comando abaixo para baixar a versão mais recente do 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

Uma vez baixado, execute o comando abaixo para criar um novo diretório de instalação do Apache Tomcat /opt/tomcat e extrair o pacote binário do Tomcat nele.

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

Agora crie um novo symlink do diretório Tomcat extraído para /opt/tomcat/latest. Em seguida, mude a propriedade do diretório /opt/tomcat para o usuário tomcat.

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

Em seguida, crie um novo arquivo de serviço systemd /etc/systemd/system/tomcat.service usando o editor nano.

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

Cole a configuração abaixo para configurar o arquivo de serviço para o 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

Salve o arquivo e saia do editor.

Execute o comando abaixo para recarregar o gerenciador systemd, em seguida, inicie e habilite o serviço tomcat.

sudo systemctl daemon-reload

sudo systemctl start tomcat  
sudo systemctl enable tomcat

Uma vez iniciado, verifique o serviço tomcat usando o comando abaixo. Certifique-se de que seu serviço Tomcat esteja em execução como o seguinte.

sudo systemctl status tomcat

Por fim, abra seu navegador e visite http://192.168.5.15:8080/. Se tudo correr bem, você deve ver a página de índice do Apache Tomcat.

Criando Administrador do Tomcat

Neste ponto, você instalou o Apache Tomcat em seu servidor Debian. No próximo passo, você configurará a autenticação para o Apache Tomcat e habilitará o gerenciador do Tomcat e o host-manager.

Para começar, edite o arquivo de configuração do Tomcat /etc/tomcat10/tomcat-users.xml usando o seguinte editor nano.

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

Insira as linhas abaixo entre a seção ‘tomcat-users‘. Certifique-se de alterar o nome de usuário padrão admin e a senha tomcatadmin com suas credenciais.

Salve e saia do arquivo.

Agora, abra o arquivo de configuração para o gerenciador do Tomcat e o host-manager usando o 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

‘*, a configuração será desativada ou comentada.

Salve o arquivo e saia do editor.

Em seguida, reinicie o serviço tomcat com o comando abaixo para aplicar a nova configuração do Tomcat.

sudo systemctl restart tomcat

Por fim, visite http://192.168.5.15:8080/manager para acessar o gerenciador do Tomcat, e http://192.168.5.15:8080/host-manager para acessar o gerenciador do host do Tomcat. Insira seu usuário e senha de administrador quando solicitado e clique em Entrar.

Se for bem-sucedido, você deve ver o painel do gerenciador do Apache Tomcat.

Para o gerenciador do host do Tomcat, abaixo está como ele se parece:

Configurando Nginx como um Proxy Reverso

Neste guia, você executará o Apache Tomcat com o Nginx como um proxy reverso. Nesta seção, você instalará o nginx e configurará um bloco de servidor como um proxy reverso para o Tomcat que roda na porta 8080.

Execute o comando abaixo para instalar o Nginx em seu sistema. Digite y para confirmar a instalação.

sudo apt install nginx

Uma vez que a instalação esteja completa, crie uma nova configuração de bloco de servidor /etc/nginx/sites-available/tomcat.conf usando o editor nano.

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

Adicione a configuração abaixo para configurar o Nginx como um proxy reverso para o 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/;  
}  
}

Salve e saia do arquivo quando terminar.

Agora, ative a configuração do bloco de servidor e verifique sua sintaxe do Nginx. Se tudo correr bem, você deve obter uma saída como ‘teste bem-sucedido - sintaxe está ok‘.

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

Em seguida, reinicie o serviço Nginx para aplicar as novas alterações e verifique para garantir que o serviço esteja em execução.

sudo systemctl restart nginx  
sudo systemctl status nginx

Se o Nginx estiver em execução, você deve obter a seguinte saída:

Por fim, volte ao seu navegador e visite http://tomcat.howtoforge.local/. Você deve ver a página de índice padrão do Apache Tomcat.

Conclusão

Parabéns! Você agora instalou o Apache Tomcat 10 no servidor Debian 12. Você aprendeu dois métodos para instalar o Apache Tomcat, via repositório APT e manualmente via pacote binário. No final, você também aprendeu como configurar o Nginx como um proxy reverso para sua instalação do Tomcat.