Apache Tomcat установка: Полное руководство для Debian 12

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

Подготовка системы Debian 12

Перед тем как начать установку Tomcat 9 на Debian 12, убедимся, что система готова. Нам потребуется Java, так как Tomcat написан на этом языке.

1. Обновление системы и установка Java

Давай разберем процесс с самого начала. Открой терминал и выполни следующие команды:

# Обновляем список пакетов
sudo apt update && sudo apt upgrade -y

# Устанавливаем OpenJDK 11 и утилиты
sudo apt install openjdk-11-jdk wget curl tar -y

# Проверяем установку Java
java -version

В выводе команды java -version ты должен увидеть что-то вроде openjdk version "11.0.22". Отлично, основа готова.

Скачивание и установка Apache Tomcat 9

Мы не будем использовать пакеты из репозитория Debian, так как они часто содержат устаревшие версии. Лучше скачать архив напрямую с официального сайта.

2. Создание пользователя и загрузка Tomcat

# Создаем специального системного пользователя для Tomcat
sudo useradd -m -U -d /opt/tomcat -s /bin/false tomcat

# Переходим в директорию для загрузок
cd /tmp

# Скачиваем последнюю стабильную версию Tomcat 9.x
# Актуальную ссылку всегда можно найти на tomcat.apache.org
wget https://downloads.apache.org/tomcat/tomcat-9/v9.0.85/bin/apache-tomcat-9.0.85.tar.gz

# Распаковываем архив в /opt/tomcat
sudo tar -xzf apache-tomcat-9.0.85.tar.gz -C /opt/tomcat --strip-components=1

# Устанавливаем правильные права
sudo chown -R tomcat:tomcat /opt/tomcat
sudo chmod -R u+x /opt/tomcat/bin

Настройка среды и сервиса Tomcat

Для удобства управления Tomcat как службой и настройки параметров памяти создадим несколько конфигурационных файлов.

3. Настройка переменных окружения

Создадим файл для установки переменных, таких как JAVA_HOME и CATALINA_HOME.

# Создаем файл с настройками окружения для tomcat
sudo nano /opt/tomcat/bin/setenv.sh

Добавь в этот файл следующие строки. Они задают путь к Java и увеличивают лимит памяти для приложений:

#!/bin/sh
# Указываем путь к установленной Java
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64

# Указываем домашнюю директорию Tomcat
export CATALINA_HOME=/opt/tomcat

# Настройки памяти для JVM (можно регулировать под свои нужды)
export JAVA_OPTS="-Xms512M -Xmx1024M -server -XX:+UseParallelGC"

Сделай файл исполняемым:

sudo chmod +x /opt/tomcat/bin/setenv.sh

4. Создание systemd сервиса для Tomcat

Это самый важный шаг для корректной работы в production-среде. Сервис позволит управлять Tomcat командами systemctl и обеспечит автозапуск.

# Создаем файл юнита для systemd
sudo nano /etc/systemd/system/tomcat.service

Вставь следующую конфигурацию. Обрати внимание на пути и имя пользователя:

[Unit]
Description=Apache Tomcat 9 Servlet Container
After=network.target

[Service]
Type=forking

User=tomcat
Group=tomcat

# Важно: Указываем на наш setenv.sh
Environment="CATALINA_PID=/opt/tomcat/temp/tomcat.pid"
Environment="CATALINA_HOME=/opt/tomcat"
Environment="CATALINA_BASE=/opt/tomcat"
Environment="CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC"

# Запускаем стартовый скрипт
ExecStart=/opt/tomcat/bin/startup.sh
ExecStop=/opt/tomcat/bin/shutdown.sh

# Даем процессу время на корректное завершение
TimeoutStopSec=10
RestartSec=10
Restart=always

[Install]
WantedBy=multi-user.target

Теперь загрузим новый сервис и запустим Tomcat:

# Перечитываем конфигурацию systemd
sudo systemctl daemon-reload

# Включаем автозапуск Tomcat при загрузке системы
sudo systemctl enable tomcat

# Запускаем сервис Tomcat
sudo systemctl start tomcat

# Проверяем статус
sudo systemctl status tomcat

Если все сделано правильно, в статусе ты увидишь "active (running)". Поздравляю, Apache Tomcat установлен и работает!

Настройка безопасности и менеджера приложений

По умолчанию Tomcat работает с минимальными настройками безопасности. Давай это исправим, добавив пользователя для доступа к менеджеру и хосту менеджера.

5. Создание пользователей в tomcat-users.xml

Отредактируем главный файл с пользователями:

sudo nano /opt/tomcat/conf/tomcat-users.xml

Добавь следующий блок внутрь тега <tomcat-users>...</tomcat-users>, заменив пароли на свои, более сложные:

<!-- Пользователь с ролью менеджера для развертывания приложений -->
<role rolename="manager-gui"/>
<role rolename="manager-script"/>
<role rolename="manager-jmx"/>
<role rolename="manager-status"/>
<!-- Пользователь с ролью админа для полного управления -->
<role rolename="admin-gui"/>

<user username="deployer" password="StrongPass123!" roles="manager-gui,manager-script,manager-jmx,manager-status"/>
<user username="admin" password="EvenStrongerAdminPass456!" roles="admin-gui,manager-gui"/>

6. Настройка доступа к менеджерам (опционально, но рекомендуется)

По умолчанию доступ к веб-интерфейсам менеджера (/manager/html) и хоста (/host-manager/html) разрешен только с localhost. Если тебе нужен доступ извне, нужно отредактировать контексты. Но для безопасности лучше настроить VPN или SSH-туннель.

Чтобы разрешить доступ с определенного IP (например, 192.168.1.100), отредактируй файлы:

sudo nano /opt/tomcat/webapps/manager/META-INF/context.xml
sudo nano /opt/tomcat/webapps/host-manager/META-INF/context.xml

Найди блок <Valve className="org.apache.catalina.valves.RemoteAddrValve" ... /> и добавь свой IP в атрибут allow:

allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1|192\.168\.1\.100"

Проверка работоспособности и развертывание

После всех настроек необходимо перезапустить Tomcat и проверить, что все работает.

sudo systemctl restart tomcat

Теперь открой браузер и перейди по адресу:

• Главная страница Tomcat: http://IP_ТВОЕГО_СЕРВЕРА:8080
• Менеджер приложений: http://IP_ТВОЕГО_СЕРВЕРА:8080/manager/html (потребует логин/пароль)
• Хост-менеджер: http://IP_ТВОЕГО_СЕРВЕРА:8080/host-manager/html

Развертывание тестового приложения (WAR-файла)

Самый простой способ — через веб-интерфейс менеджера. Залогинься под пользователем deployer и в секции "WAR file to deploy" выбери файл своего приложения.

Или используй командную строку, что чаще делается в CI/CD:

# Копируем WAR-файл в директорию webapps Tomcat
sudo cp /путь/к/твоему/приложению.war /opt/tomcat/webapps/

# Tomcat автоматически распакует и развернет приложение.
# Или можно отправить файл через curl на API менеджера:
curl -u deployer:StrongPass123! -T /путь/к/приложению.war \
  "http://localhost:8080/manager/text/deploy?path=/myapp&update=true"

Часто задаваемые вопросы (FAQ)

Сравнение методов управления Tomcat