Debian 12에서 Nginx 리버스 프록시와 함께 Apache Tomcat 10 설치하는 방법

Apache Tomcat 또는 “Tomcat”은 Java 코드 및 애플리케이션을 위한 무료 오픈 소스 Java 서블릿 컨테이너입니다. Java 코드가 실행될 수 있는 “순수 Java” HTTP 서버 환경을 제공합니다. Tomcat은 또한 JavaServer Pages, Java Expression Language 및 WebSocket 기술을 구현합니다.

이 가이드에서는 Debian 12 서버에 Apache Tomcat 10을 설치하는 방법을 보여줍니다. 또한 Apache Tomcat을 위한 리버스 프록시로 Nginx를 설정하는 방법도 배울 것입니다.

필수 조건

시작하기 전에 다음 사항을 확인하십시오:

Debian 12 서버.
관리자 권한이 있는 비루트 사용자.

Java OpenJDK 설치하기

Apache Tomcat은 주로 Java로 작성되므로 설치하기 전에 시스템에 Java를 설치해야 합니다. 이 예제에서는 Debian 리포지토리에 기본적으로 제공되는 Java OpenJDK 17을 설치합니다.

Java를 설치하기 전에 아래 명령어로 Debian 리포지토리를 업데이트하고 새로 고칩니다.

sudo apt update

update repo

이제 아래 명령어를 사용하여 Debian 서버에 Java OpenJDK 패키지를 설치합니다. default-jdk 패키지는 Java의 LTS 버전인 Java OpenJDK 17을 참조합니다.

sudo apt install default-jdk

설치 확인을 위해 y를 입력합니다.

install java

Java를 설치한 후, 아래 명령어를 실행하여 Java 버전을 확인합니다. Java OpenJDK 17이 설치된 것을 볼 수 있습니다.

java --version

리포지토리를 통한 Apache Tomcat 설치하기

기본적으로 최신 Debian 12 리포지토리는 Apache Tomcat 10을 제공합니다. APT를 통해 Apache Tomcat을 설치해야 하는 경우 이 방법이 적합합니다.

먼저 아래 명령어를 사용하여 tomcat10 패키지를 확인합니다.

sudo apt info tomcat10

다음 출력에서 Apache Tomcat 10이 Java 섹션의 기본 Debian 리포지토리에 있는 것을 볼 수 있습니다.

check tomcat10

APT를 통해 Tomcat을 설치하려면 아래 명령어를 시스템에서 실행합니다. 설치 확인을 위해 y를 입력합니다.

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

install tomcat10

설치가 완료되면 tomcat10 서비스가 실행 중이어야 합니다. 아래 명령어로 확인합니다.

sudo systemctl is-enabled tomcat10  
sudo systemctl status tomcat10

tomcat10 서비스가 실행 중이라면 다음과 같은 출력이 나타납니다:

tomcat status

마지막으로 웹 브라우저를 열고 기본 Tomcat 포트 8080으로 서버 IP 주소를 방문합니다 http://192.168.5.15:8080/. 설치가 성공적이라면 Apache Tomcat 10의 기본 인덱스 페이지가 표시됩니다.

tomcat index

바이너리를 통한 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

다음으로, nano 편집기를 사용하여 새로운 systemd 서비스 파일 /etc/systemd/system/tomcat.service를 생성합니다.

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

setup tomcat

시작되면 아래 명령어를 사용하여 tomcat 서비스를 확인합니다. Tomcat 서비스가 다음과 같이 실행되고 있는지 확인합니다.

sudo systemctl status tomcat

verify tomcat

마지막으로 웹 브라우저를 열고 http://192.168.5.15:8080/를 방문합니다. 모든 것이 잘 진행되었다면 Apache Tomcat 인덱스 페이지가 표시됩니다.

tomcat index

Tomcat 관리자 생성하기

이 시점에서 Debian 서버에 Apache Tomcat을 설치했습니다. 다음 단계에서는 Apache Tomcat에 대한 인증을 설정하고 Tomcat 관리자 및 호스트 관리자를 활성화합니다.

시작하려면 아래 명령어로 Tomcat 구성 파일 /etc/tomcat10/tomcat-users.xml을 편집합니다.

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

‘tomcat-users‘ 섹션 사이에 아래 줄을 삽입합니다. 기본 사용자 이름 admin과 비밀번호 tomcatadmin을 자신의 자격 증명으로 변경해야 합니다.

파일을 저장하고 종료합니다.

이제 nano 편집기를 사용하여 Tomcat 관리자 및 호스트 관리자의 구성 파일을 엽니다.

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 login

성공적으로 로그인하면 Apache Tomcat 관리자 대시보드가 표시됩니다.

tomcat manager

Tomcat 호스트 관리자는 아래와 같은 모습입니다:

tomcat host manager

Nginx를 리버스 프록시로 구성하기

이 가이드에서는 Nginx를 리버스 프록시로 사용하여 Apache Tomcat을 실행합니다. 이 섹션에서는 Nginx를 설치하고 Tomcat이 포트 8080에서 실행되도록 리버스 프록시로 설정하는 서버 블록 구성을 설정합니다.

아래 명령어를 실행하여 시스템에 Nginx를 설치합니다. 설치 확인을 위해 y를 입력합니다.

sudo apt install nginx

install nginx

설치가 완료되면 nano 편집기를 사용하여 새로운 서버 블록 구성 /etc/nginx/sites-available/tomcat.conf을 생성합니다.

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

Apache Tomcat을 위한 리버스 프록시로 Nginx를 설정하기 위해 아래 구성을 추가합니다.

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 구문을 확인합니다. 모든 것이 잘 진행되었다면 ‘ test is successful - syntax is ok ‘와 같은 출력이 나타납니다.

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가 실행 중이라면 다음과 같은 출력이 나타납니다:

verify nginx

마지막으로 웹 브라우저로 돌아가서 http://tomcat.howtoforge.local/를 방문합니다. Apache Tomcat의 기본 인덱스 페이지가 표시되어야 합니다.

tomcat nginx reverse proxy

결론

축하합니다! 이제 Debian 12 서버에 Apache Tomcat 10을 설치했습니다. APT 리포지토리와 바이너리 패키지를 통해 Apache Tomcat을 설치하는 두 가지 방법을 배웠습니다. 마지막으로 Tomcat 설치를 위한 Nginx 리버스 프록시 설정 방법도 배웠습니다.