우분투 24.04에 Nginx 리버스 프록시와 함께 Apache Tomcat 설치하는 방법

Apache Tomcat 또는 “Tomcat”은 Java 코드 및 애플리케이션을 위한 무료 오픈 소스 Java 서블릿 컨테이너입니다. Java 코드가 실행될 수 있는 “순수 Java” HTTP 서버 환경을 제공합니다. Tomcat은 또한 JavaServer Pages, Java Expression Language 및 WebSocket 기술을 구현합니다. 인증과 같은 민감한 데이터를 보호하기 위해 SSL을 지원합니다.

이 가이드는 우분투 24.04 서버에 Apache Tomcat을 설치하는 방법을 알려줍니다. Java OpenJDK 21과 함께 Apache Tomcat 10을 설치한 후 Nginx를 리버스 프록시로 설치하고 구성합니다.

전제 조건

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

• 우분투 24.04 서버.
• 관리자 권한이 있는 비루트 사용자.

Java OpenJDK 설치하기

Apache Tomcat을 설치하기 전에 Java가 설치되어 있는지 확인해야 합니다. 최신 Apache Tomcat 10은 최소 Java 11 이상이 필요합니다. 이 섹션에서는 공식 우분투 저장소에서 Java OpenJDK 21을 설치합니다.

시작하려면 아래 명령어로 우분투 패키지 인덱스를 업데이트합니다.

sudo apt update

이제 다음 명령어로 Java OpenJDK를 설치합니다. 우분투 24.04에서는 ‘default-jdk’가 Java의 LTS 버전인 OpenJDK 21을 참조합니다.

sudo apt install default-jdk

설치를 진행하려면 Y를 입력합니다.

설치가 완료되면 다음 명령어로 Java 버전을 확인합니다. 우분투 서버에 Java OpenJDK 21이 설치되어 있는지 확인할 수 있습니다.

java --version

Apache Tomcat 10 설치하기

Apache Tomcat 10은 최신 우분투 버전의 우분투 저장소에 기본적으로 제공됩니다. 이를 통해 APT 패키지 관리자를 사용하여 Tomcat을 쉽게 설치할 수 있습니다.

먼저 다음 명령어로 ‘tomcat10‘ 패키지 정보를 확인합니다.

sudo apt info tomcat10

다음은 Apache Tomcat 10.1.16이 우분투 ‘universe/java‘ 저장소에서 사용 가능하다는 것을 보여줍니다.

이제 아래 명령어로 Apache Tomcat을 우분투 시스템에 설치합니다. 이 명령어로 Tomcat 관리자 웹 애플리케이션, 사용자 생성 도구 및 Tomcat 웹 애플리케이션 예제도 설치됩니다.

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

설치를 확인하려면 Y를 입력합니다.

설치가 완료되면 ‘tomcat10’ 서비스가 생성됩니다.

다음 명령어로 ‘tomcat10’ 서비스 상태를 확인합니다:

sudo systemctl is-enabled tomcat10  
sudo systemctl status tomcat10

아래에서 볼 수 있듯이, ‘tomcat10’ 서비스는 활성화됨 및 활성(실행 중)입니다. ‘tomcat10’ 서비스는 부팅 시 자동으로 시작됩니다.

이제 아래 명령어를 실행하여 Apache Tomcat 포트 8080을 확인합니다. Tomcat이 실행 중이라면 Java 애플리케이션이 포트 8080을 사용하고 있는 것을 볼 수 있습니다.

ss -tulpn

마지막으로 웹 브라우저를 사용하여 http://192.168.5.30:8080/를 방문하면 다음과 같은 Apache Tomcat 기본 인덱스 페이지를 볼 수 있습니다:

Apache Tomcat 인증 설정하기

이 섹션에서는 기본 인증을 설정하고 Tomcat 호스트 관리자 및 관리자의 접근을 허용합니다. ‘tomcat-users.xml’ 파일을 편집하여 Tomcat 기본 인증을 활성화한 후 ‘tomcat10-admin’ 패키지를 통해 Tomcat 호스트 관리자와 관리자 모두에 대한 접근을 허용합니다.

nano 편집기를 사용하여 Tomcat 사용자 구성 ‘/etc/tomcat10/tomcat-users.xml’을 엽니다.

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

다음 구성을 ‘ …. ’ 사이에 삽입합니다. 이 예제에서는 Apache Tomcat 사용자 ‘admin‘을 비밀번호 ‘tomcatadmin‘과 함께 생성하고 ‘admin-gui’ 및 ‘manager-gui’를 포함한 여러 역할을 부여합니다.

작업이 완료되면 파일을 저장하고 종료합니다.

이제 nano 편집기 명령어를 사용하여 Tomcat ‘host-manager‘ 및 ‘manager‘의 구성을 엽니다.

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

‘를 추가합니다. 이를 통해 Apache Tomcat ‘host-manager‘ 및 ‘manager‘에 대한 원격 접근을 허용합니다.

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

편집 후 다음 명령어를 실행하여 ‘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 호스트 관리자.

Nginx를 리버스 프록시로 설정하기

이 가이드에서는 Nginx 웹 서버를 설치하고 Apache Tomcat 설치에 대한 리버스 프록시로 구성합니다. 리버스 프록시를 사용하면 로컬 도메인 이름을 통해 Tomcat 애플리케이션에 쉽게 접근할 수 있습니다.

우분투에 Nginx 웹 서버를 설치하려면 다음을 실행합니다:

sudo apt install nginx -y

설치가 완료되면 Apache Tomcat의 리버스 프록시로 사용될 새로운 서버 블록 구성 ‘/etc/nginx/sites-available/tomcat10‘을 생성합니다.

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 웹 서버가 실행 중임을 보여줍니다. 그리고 ‘tomcat10.howtoforge.local‘과 같은 도메인 이름을 사용하여 Apache Tomcat 설치에 접근할 수 있습니다.

다음 구성을 로컬 머신의 ‘hosts’ 파일에 추가할 수 있습니다. 리눅스 또는 맥 사용자는 ‘/etc/hosts‘ 파일에 다음을 추가합니다. 윈도우 사용자는 ‘C:\Windows\System32\drivers\etc\hosts‘ 파일에 아래 구성을 추가합니다.

192.168.5.30 tomcat10.howtoforge.local

마지막으로 웹 브라우저를 사용하여 http://tomcat10.howtoforge.local을 방문합니다. Nginx 리버스 프록시 설치가 성공하면 다음과 같은 Apache Tomcat 인덱스 페이지를 볼 수 있습니다:

http://tomcat10.howtoforge.local/host-manager/를 방문하여 Apache Tomcat 호스트 관리자에 접근하고 http://tomcat10.howtoforge.local/manager/에서 Apache Tomcat 관리자에 접근합니다. 두 애플리케이션이 Nginx 리버스 프록시 아래에서 실행되고 있는 것을 볼 수 있습니다.

결론

축하합니다! 우분투 24.04 서버에 Apache Tomcat을 성공적으로 설치했습니다. 우분투에 Java OpenJDK 21과 함께 Tomcat 10을 설치했습니다. 또한 Apache Tomcat에 대한 리버스 프록시로 Nginx를 설치하고 구성했습니다.