Как установить Apache Tomcat 10 с обратным прокси Nginx на Debian 12

Apache Tomcat или “Tomcat” — это бесплатный и с открытым исходным кодом контейнер сервлетов Java для Java-кода и приложений. Он предоставляет среду HTTP-сервера “чистого Java”, в которой может выполняться Java-код. Tomcat также реализует JavaServer Pages, Java Expression Language и технологии WebSocket.

В этом руководстве мы покажем вам, как установить Apache Tomcat 10 на сервер Debian 12. Вы также узнаете, как настроить Nginx в качестве обратного прокси для Apache Tomcat.

Предварительные требования

Чтобы начать, убедитесь, что у вас есть следующее:

Сервер Debian 12.
Пользователь без прав root с правами администратора.

Установка Java OpenJDK

Apache Tomcat в основном написан на Java, поэтому перед его установкой необходимо установить Java на вашу систему. В этом примере вы установите Java OpenJDK 17, которая доступна по умолчанию в репозитории Debian.

Перед тем как начать установку Java, обновите и обновите ваш репозиторий Debian с помощью команды ниже.

sudo apt update

обновить репозиторий

Теперь установите пакет Java OpenJDK на ваш сервер Debian, используя следующую команду. Пакет default-jdk относится к Java OpenJDK 17, которая является LTS-версией Java.

sudo apt install default-jdk

Введите y для подтверждения установки.

установить java

После установки Java выполните команду ниже, чтобы проверить вашу версию Java. Вы увидите, что Java OpenJDK 17 установлена.

java --version

Установка Apache Tomcat через репозиторий

По умолчанию последний репозиторий Debian 12 предоставляет Apache Tomcat 10. Если вам нужно установить Apache Tomcat через APT, то этот метод подходит для вас.

Сначала проверьте пакет tomcat10, используя команду ниже.

sudo apt info tomcat10

В следующем выводе вы можете увидеть, что Apache Tomcat 10 доступен в основном репозитории Debian, в разделе java.

проверить tomcat10

Если вы хотите установить Tomcat через APT, выполните команду ниже на вашей системе. Введите y для подтверждения установки.

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

установить tomcat10

После завершения установки служба tomcat10 должна работать. Проверьте это с помощью команды ниже.

sudo systemctl is-enabled tomcat10  
sudo systemctl status tomcat10

Если служба tomcat10 работает, вы должны получить следующий вывод:

статус tomcat

Наконец, откройте ваш веб-браузер и посетите IP-адрес сервера с портом по умолчанию Tomcat 8080 http://192.168.5.15:8080/. Если ваша установка успешна, вы должны увидеть страницу индекса по умолчанию Apache Tomcat 10.

индекс tomcat

Установка Tomcat через бинарный пакет

Теперь, если вы хотите установить последнюю версию Apache Tomcat, вы можете установить ее через бинарный пакет. В этом разделе вы узнаете, как это сделать на вашем сервере Debian.

Сначала создайте нового системного пользователя tomcat с помощью команды ниже.

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

Посетите страницу загрузки Apache Tomcat и проверьте последнюю версию Tomcat. Затем выполните команду ниже, чтобы загрузить последнюю версию 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

После загрузки выполните команду ниже, чтобы создать новый каталог установки Apache Tomcat /opt/tomcat и извлечь бинарный пакет Tomcat в него.

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

Теперь создайте новую символическую ссылку извлеченного каталога Tomcat на /opt/tomcat/latest. Затем измените владельца каталога /opt/tomcat на пользователя tomcat.

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

Далее создайте новый файл службы systemd /etc/systemd/system/tomcat.service с помощью редактора nano.

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

Вставьте конфигурацию ниже, чтобы настроить файл службы для 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

Сохраните файл и выйдите из редактора.

Выполните команду ниже, чтобы перезагрузить менеджер systemd, затем запустите и включите службу tomcat.

sudo systemctl daemon-reload

sudo systemctl start tomcat  
sudo systemctl enable tomcat

настройка tomcat

После запуска проверьте службу tomcat с помощью команды ниже. Убедитесь, что ваша служба Tomcat работает, как показано ниже.

sudo systemctl status tomcat

проверка tomcat

Наконец, откройте ваш веб-браузер и посетите http://192.168.5.15:8080/. Если все прошло хорошо, вы должны увидеть страницу индекса Apache Tomcat.

индекс tomcat

Создание администратора Tomcat

На этом этапе вы установили Apache Tomcat на ваш сервер Debian. На следующем шаге вы настроите аутентификацию для Apache Tomcat и включите менеджер Tomcat и хост-менеджер.

Для начала отредактируйте файл конфигурации Tomcat /etc/tomcat10/tomcat-users.xml с помощью редактора nano.

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

Вставьте строки ниже между разделом ‘tomcat-users‘. Убедитесь, что вы изменили имя пользователя по умолчанию admin и пароль tomcatadmin на ваши учетные данные.

Сохраните и выйдите из файла.

Теперь откройте файл конфигурации для менеджера Tomcat и хост-менеджера с помощью редактора nano.

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

‘*, конфигурация будет отключена или закомментирована.

Сохраните файл и выйдите из редактора.

Далее перезапустите службу tomcat с помощью команды ниже, чтобы применить новую конфигурацию Tomcat.

sudo systemctl restart tomcat

Наконец, посетите http://192.168.5.15:8080/manager, чтобы получить доступ к менеджеру Tomcat, и http://192.168.5.15:8080/host-manager, чтобы получить доступ к хост-менеджеру Tomcat. Введите вашего администратора и пароль, когда будет предложено, и нажмите Войти.

вход tomcat

Если все прошло успешно, вы должны увидеть панель управления менеджера Apache Tomcat.

менеджер tomcat

Для хост-менеджера Tomcat ниже показано, как это выглядит:

хост-менеджер tomcat

Настройка Nginx в качестве обратного прокси

В этом руководстве вы будете запускать Apache Tomcat с Nginx в качестве обратного прокси. В этом разделе вы установите nginx и настроите конфигурацию блока сервера в качестве обратного прокси для Tomcat, который работает на порту 8080.

Выполните команду ниже, чтобы установить Nginx на вашу систему. Введите y для подтверждения установки.

sudo apt install nginx

установить nginx

После завершения установки создайте новую конфигурацию блока сервера /etc/nginx/sites-available/tomcat.conf с помощью редактора nano.

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

Добавьте конфигурацию ниже, чтобы настроить Nginx в качестве обратного прокси для 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/;  
}  
}

Сохраните и выйдите из файла, когда закончите.

Теперь активируйте конфигурацию блока сервера и проверьте синтаксис вашего Nginx. Если все пройдет хорошо, вы должны получить вывод, такой как ‘тест успешен - синтаксис в порядке‘.

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

Далее перезапустите службу Nginx, чтобы применить новые изменения, и проверьте, чтобы убедиться, что служба работает.

sudo systemctl restart nginx  
sudo systemctl status nginx

Если Nginx работает, вы должны получить следующий вывод:

проверка nginx

Наконец, вернитесь в ваш веб-браузер и посетите http://tomcat.howtoforge.local/. Вы должны увидеть страницу индекса по умолчанию Apache Tomcat.

nginx обратный прокси tomcat

Заключение

Поздравляем! Вы теперь установили Apache Tomcat 10 на сервер Debian 12. Вы узнали два метода установки Apache Tomcat: через репозиторий APT и вручную через бинарный пакет. В конце вы также узнали, как настроить Nginx в качестве обратного прокси для вашей установки Tomcat.