Apache Tomcat — это сервер приложений на основе JAVA с открытым исходным кодом, который реализует технологии Java Servlet, JavaServer Pages, Java Expression Language и Java WebSocket. Сегодня это один из наиболее широко используемых приложений и веб-серверов в мире.
В этом руководстве объясняется, как установить Apache Tomcat 9.0 на Debian 10 Buster и настроить веб-интерфейс управления Tomcat.
Содержание
Подготовка
В инструкциях предполагается, что вы вошли в систему как пользователь root или пользователь с привилегиями sudo .
Установка OpenJDK
Tomcat 9.0 требует, чтобы на сервере была установлена Java SE 8 или новее.
Выполните следующую команду, чтобы установить пакет OpenJDK :
sudo apt install default-jdk
Создание пользователя Tomcat
Запуск Tomcat от имени пользователя root представляет собой угрозу безопасности и не рекомендуется. Мы создадим нового пользователя, который будет использоваться для запуска службы Tomcat.
Выполните следующую команду, чтобы создать нового системного пользователя и группу с домашним каталогом /opt/tomcat
:
sudo useradd -m -U -d /opt/tomcat -s /bin/false tomcat
Скачивание Tomcat
На момент написания последней версией Tomcat является 9.0.27
. Прежде чем перейти к следующему шагу, вам следует проверить страницу загрузки Tomcat 9, чтобы узнать, доступна ли более новая версия.
Перейдите в каталог /tmp
и загрузите последнюю двоичную версию Tomcat:
cd /tmp
wget https://www-eu.apache.org/dist/tomcat/tomcat-9/v9.0.27/bin/apache-tomcat-9.0.27.tar.gz
Когда загрузка будет завершена, распакуйте сжатый архив :
tar -xf apache-tomcat-9.0.27.tar.gz
Переместите туда исходные файлы Tomcat в каталог /opt/tomcat
:
sudo mv apache-tomcat-9.0.27 /opt/tomcat/
Tomcat 9 периодически обновляется. Чтобы иметь больший контроль над версиями и обновлениями, создайте символическую ссылку с именем latest
которая указывает на каталог установки Tomcat:
sudo ln -s /opt/tomcat/apache-tomcat-9.0.27 /opt/tomcat/latest
Позже, при обновлении Tomcat, просто распакуйте новую версию и измените символическую ссылку, чтобы она указывала на последнюю версию.
Измените владельца каталога /opt/tomcat
на пользователя и группу tomcat
, чтобы у пользователя был доступ к каталогу установки:
sudo chown -R tomcat: /opt/tomcat
Сделайте скрипты внутри каталога bin
исполняемым :
sudo sh -c 'chmod +x /opt/tomcat/latest/bin/*.sh'
Создание файла модуля SystemD
Откройте текстовый редактор и создайте новый файл с именем tomcat.service
со следующим содержимым:
sudo nano /etc/systemd/system/tomcat.service
[Unit]
Description=Tomcat 9.0 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"
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
Проверьте статус службы Tomcat, набрав:
sudo systemctl status tomcat
● tomcat.service - Tomcat 9.0 servlet container
Loaded: loaded (/etc/systemd/system/tomcat.service; disabled; vendor preset:
Active: active (running) since Sat 2019-11-09 13:53:51 PST; 5s ago
Process: 5752 ExecStart=/opt/tomcat/latest/bin/startup.sh (code=exited, status
Main PID: 5759 (java)
Если ошибок нет, включите автоматический запуск службы Tomcat во время загрузки:
sudo systemctl enable tomcat
Вы можете запускать, останавливать и перезапускать Tomcat так же, как и любую другую службу модуля systemd:
sudo systemctl start tomcat
sudo systemctl stop tomcat
sudo systemctl restart tomcat
Настройка брандмауэра
Если в вашей системе Debian запущен брандмауэр, и вы хотите получить доступ к интерфейсу tomcat извне локальной сети, вам нужно открыть порт 8080
:
sudo ufw allow 8080/tcp
При запуске приложения Tomcat в производственной среде, скорее всего, у вас будет балансировщик нагрузки или обратный прокси-сервер , и рекомендуется ограничить доступ к порту 8080 только для вашей внутренней сети.
Настройка веб-интерфейса управления Tomcat
Теперь, когда Tomcat установлен, следующим шагом будет создание пользователя с доступом к веб-интерфейсу управления.
Пользователи Tomcat и их роли определены в tomcat-users.xml
.
Если вы откроете файл, вы заметите, что он заполнен комментариями и примерами, описывающими, как настроить файл:
sudo nano /opt/tomcat/latest/conf/tomcat-users.xml
Мы определим нового пользователя в tomcat-users.xml
, как показано ниже. У пользователя будет доступ к веб-интерфейсу Tomcat (manager-gui и admin-gui). Обязательно измените имя пользователя и пароль на более безопасные:
<tomcat-users>
<!--
Comments
-->
<role rolename="admin-gui"/>
<role rolename="manager-gui"/>
<user username="admin" password="admin_password" roles="admin-gui,manager-gui"/>
</tomcat-users>
По умолчанию веб-интерфейс управления Tomcat разрешает доступ только с локального хоста. Если вы хотите получить доступ к веб-интерфейсу с удаленного IP-адреса или из любого места, что не рекомендуется, поскольку это представляет угрозу безопасности, вы можете открыть следующие файлы и внести следующие изменения.
Если вам нужно получить доступ к веб-интерфейсу из любого места, откройте следующие файлы и прокомментируйте или удалите строки, выделенные желтым:
<Context antiResourceLocking="false" privileged="true" >
<!--
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
allow="127.d+.d+.d+|::1|0:0:0:0:0:0:0:1" />
-->
</Context>
<Context antiResourceLocking="false" privileged="true" >
<!--
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
allow="127.d+.d+.d+|::1|0:0:0:0:0:0:0:1" />
-->
</Context>
Если вам нужно получить доступ к веб-интерфейсу только с определенного IP-адреса, вместо комментирования блоков добавьте свой общедоступный IP-адрес в список. Допустим, ваш публичный IP-адрес 32.32.32.32
и вы хотите разрешить доступ только с этого IP- 32.32.32.32
:
<Context antiResourceLocking="false" privileged="true" >
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
allow="127.d+.d+.d+|::1|0:0:0:0:0:0:0:1|32.32.32.32" />
</Context>
<Context antiResourceLocking="false" privileged="true" >
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
allow="127.d+.d+.d+|::1|0:0:0:0:0:0:0:1|32.32.32.32" />
</Context>
Список разрешенных IP-адресов представляет собой список, разделенный вертикальной чертой |
. Вы можете добавить отдельные IP-адреса или использовать регулярные выражения.
Перезапустите службу Tomcat, чтобы изменения вступили в силу:
sudo systemctl restart tomcat
Проверить установку
Откройте браузер и введите: http://<your_domain_or_IP_address>:8080
Если установка прошла успешно, появится экран, подобный следующему:
Панель управления диспетчером веб-приложений Tomcat доступна по адресу http://<your_domain_or_IP_address>:8080/manager/html
. Отсюда вы можете развертывать, отменять развертывание, запускать, останавливать и перезагружать свои приложения.
Панель управления диспетчером виртуальных хостов Tomcat доступна по адресу http://<your_domain_or_IP_address>:8080/host-manager/html
. Отсюда вы можете создавать, удалять и управлять виртуальными хостами Tomcat.
Выводы
Вы успешно установили Tomcat 9.0 в свою систему Debian 10. Теперь вы можете посетить официальную документацию Apache Tomcat 9.0 и узнать больше о функциях Apache Tomcat.
Если вы столкнулись с проблемой или хотите оставить отзыв, оставьте комментарий ниже.