Как установить Apache Tomcat с обратным прокси Nginx на Ubuntu 24.04

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

Этот гид научит вас, как установить Apache Tomcat на сервер Ubuntu 24.04. Вы установите Apache Tomcat 10 с Java OpenJDK 21, а затем установите и настроите Nginx в качестве обратного прокси.

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

Перед тем как продолжить, убедитесь, что у вас есть:

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

Установка Java OpenJDK

Перед установкой Apache Tomcat вам нужно убедиться, что Java установлена. Последний Apache Tomcat 10 требует как минимум Java 11 или более поздней версии. В этом разделе вы установите Java OpenJDK 21 из официального репозитория Ubuntu.

Для начала обновите индекс пакетов Ubuntu с помощью команды ниже.

sudo apt update

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

Теперь установите Java OpenJDK с помощью следующей команды. В Ubuntu 24.04 ‘default-jdk’ относится к OpenJDK 21, который является LTS-версией Java.

sudo apt install default-jdk

Введите Y, чтобы продолжить установку.

установка java

После завершения установки проверьте версию Java, используя следующую команду. Вы должны увидеть, что Java OpenJDK 21 установлена на вашем сервере Ubuntu.

java --version

Установка Apache Tomcat 10

Apache Tomcat 10 доступен по умолчанию в репозитории Ubuntu на последней версии Ubuntu. Это позволяет вам легко установить Tomcat, используя менеджер пакетов APT.

Сначала проверьте информацию о пакете ‘tomcat10‘ с помощью следующей команды.

sudo apt info tomcat10

Следующее показывает, что Apache Tomcat 10.1.16 доступен в репозитории Ubuntu ‘universe/java‘.

информация о пакете tomcat10

Теперь установите Apache Tomcat на вашу систему Ubuntu с помощью команды ниже. С этой командой вы также установите веб-приложения администратора Tomcat, инструменты для создания пользователей и примеры веб-приложений Tomcat.

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

Введите Y, чтобы подтвердить установку.

установка apache tomcat

Сервис ‘tomcat10’ будет создан, когда установка завершится.

Проверьте статус сервиса ‘tomcat10‘ с помощью следующей команды:

sudo systemctl is-enabled tomcat10  
sudo systemctl status tomcat10

Вы можете увидеть ниже, что сервис ‘tomcat10‘ включен и активен (работает). Сервис ‘tomcat10‘ будет автоматически запускаться при загрузке.

проверка сервиса tomcat

Теперь выполните команду ниже, чтобы проверить порт Apache Tomcat 8080. Если Tomcat работает, вы увидите, что Java-приложение использует порт 8080.

ss -tulpn

Наконец, посетите http://192.168.5.30:8080/ с помощью вашего веб-браузера, и вы увидите страницу индекса по умолчанию Apache Tomcat, как показано ниже:

индекс tomcat

Настройка аутентификации Apache Tomcat

В этом разделе вы настроите базовую аутентификацию и разрешите доступ к менеджеру хостов и менеджеру Tomcat. Вы включите базовую аутентификацию Tomcat, отредактировав файл ‘tomcat-users.xml’, а затем разрешите доступ как к менеджеру хостов Tomcat, так и к менеджеру через пакет ‘tomcat10-admin’.

Откройте конфигурацию пользователей Tomcat ‘/etc/tomcat10/tomcat-users.xml’ с помощью редактора nano.

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

Вставьте следующую конфигурацию между ‘ …. ’. В этом примере вы создадите пользователя Apache Tomcat ‘admin‘ с паролем ‘tomcatadmin‘ и несколькими ролями, включая ‘admin-gui’ и ‘manager-gui’.

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

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

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

‘. С этим вы разрешите удаленный доступ к ‘ host-manager ‘ и ‘ manager* ‘ Apache Tomcat.

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

После редактирования выполните следующую команду, чтобы перезапустить сервис ‘tomcat10’ и применить новые изменения к вашей установке Apache Tomcat.

sudo systemctl restart tomcat10

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

Введите пользователя ‘admin‘ и пароль ‘tomcatadmin‘, когда будет предложено.

вход в apache tomcat

Если аутентификация прошла успешно, вы должны увидеть страницу менеджера хостов и менеджера Apache Tomcat, как показано ниже:

Менеджер Apache Tomcat.

менеджер tomcat

Менеджер хостов Apache Tomcat.

менеджер tomcat

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

В этом руководстве вы установите веб-сервер Nginx и настроите его как обратный прокси для вашей установки Apache Tomcat. Используя обратный прокси, вы можете легко получить доступ к вашему приложению Tomcat через ваше локальное доменное имя.

Чтобы установить веб-сервер Nginx на вашем Ubuntu, выполните следующее:

sudo apt install nginx -y

установка nginx

Когда установка завершится, создайте новую конфигурацию блока сервера ‘ /etc/nginx/sites-available/tomcat10 ‘, которая будет использоваться как обратный прокси для Apache Tomcat.

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

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

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

Теперь выполните команду ниже, чтобы активировать конфигурацию блока сервера ‘tomcat10’ и протестировать синтаксис Nginx.

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

Если у вас правильный и корректный синтаксис Nginx, вы увидите вывод ‘синтаксис в порядке … тест успешен‘.

Затем выполните следующую команду, чтобы перезапустить сервис Nginx и применить блок сервера ‘tomcat10’. Затем проверьте статус сервиса Nginx, чтобы убедиться, что он работает.

sudo systemctl restart nginx  
sudo systemctl status nginx

Вывод ниже показывает, что веб-сервер Nginx работает. И вы можете получить доступ к вашей установке Apache Tomcat, используя доменное имя, такое как ‘tomcat10.howtoforge.local‘.

проверка сервиса nginx

Вы можете добавить следующую конфигурацию в файл ‘hosts’ на вашем локальном компьютере. Для пользователей Linux или Mac добавьте следующее в файл ‘/etc/hosts‘. Что касается пользователей Windows, добавьте конфигурацию ниже в файл ‘C:\Windows\System32\drivers\etc\hosts‘.

192.168.5.30 tomcat10.howtoforge.local

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

индекс tomcat

Посетите http://tomcat10.howtoforge.local/host-manager/, чтобы получить доступ к менеджеру хостов Apache Tomcat, и http://tomcat10.howtoforge.local/manager/, чтобы получить доступ к менеджеру Apache Tomcat. Вы увидите оба приложения, работающие под обратным прокси Nginx.

Заключение

Поздравляем! Вы успешно установили Apache Tomcat на сервер Ubuntu 24.04. Вы установили Tomcat 10 с Java OpenJDK 21 на Ubuntu. Также вы установили и настроили Nginx в качестве обратного прокси для Apache Tomcat.