Proxy Support HOW-TO

톰캣의 표준 설정을 사용하여 웹어플리케이션은 요청이 처리되는 서버 이름과 포트를 요구할 수 있다. 톰캣이 HTTP/1.1 커넥터를 가지고 독립적으로(standalone) 구동하고 있을때, 일반적으로 요청에 지정된 서버 이름과, 커넥터가 리스닝하는 포트 번호를 보고한다. 이 목적과 관련한 두 개의 서블릿 API 메소드가 있다.

• ServletRequest.getServerName()
• ServletRequest.getServerPort()

프락시 서버(또는 프락시 서버처럼 작동하도록 설정한 웹서버) 배후에서 톰캣을 구동한다면 때로는 호출에서 리턴되는 값들을 관리하고 싶을 것이다. 특히 커넥터가 열려있는 포트 번호가 아닌 본래의 요청에서 지정한 포트를 일반적으로 원할 것이다. 이 값들을 설정하기 위하여 <Connector>엘리먼트에서 proxyName과 proxyPort를 사용할 수 있다.

프락시 지원은 여러 행태를 띨 수 있다. 다음 섹션들은 몇 가지 일반의 경우 프락시 설정을 말하고 있다.

Apache 1.3은 웹서버를 프락시 서버로 사용하도록 설정하는 선택적인 모듈(mod_proxy)을 지원한다. 이것은 굳이 mod_webapp같은 웹 커넥터를 설정할 필요 없이 특정 웹 어플리케이션에 대한 요청을 톰캣 4 인스턴스로 보내는데 사용될 수 있다. 이렇게 하기 위해서 아래 작업들을 할 필요가 있다.

1. 아파치가 mod_proxy 모듈을 포함하도록 설정하라. 만일 소스로부터 빌드하고 있다면 가장 쉬운 방법은 ./configure 명령어 라인에 --enable-module=proxy 구문을 포함하는 것이다.
2. 만일 이를 포함하지 않은채로 이미 빌드한 상태라면 httpd.conf 파일에 다음 지시문을 사용하여 아파치가 시작될 때 mod_proxy 모듈을 로딩하도록 하라.

   	LoadModule proxy_module {path-to-modules}/mod_proxy.so AddModule mod_proxy.c

3. 톰캣 4로 포워드 하고자 하는 각 웹 어플리케이션에 대하여 httpd.conf에 두가지 지시문을 포함하라. 예를 들어 /myapp 컨텍스트 패스에 어플리케이션을 포워드 하는 방법은 다음과 같다.

   	ProxyPass /myapp http://localhost:8081/myapp ProxyPassReverse /myapp http://localhost:8081/myapp

   이는 아파치에게 http://localhost/myapp/* 형태의 URL을 톰갯 4 커넥터로 포워드하게 한다.
4. 톰캣 4를 <Connector>요소를 포함하도록 설정하여 적절한 프락시 세팅이 되도록 한다. 예를 들어보자.

   	<Connector className="org.apache.catalina.connector.http.HttpConnector" port="8081" ... proxyName="www.mycompany.com" proxyPort="80"/>

   이는 모든 중개된 요청들이 www.mycompany.com의 포트 80으로 향한다고 웹 어플리케이션내의 서블릿들이 여기게 한다.
5. <Connector>엘리먼트의 proxyName 속성을 생략해도 된다. 그 경우에 request.getServerName()는 톰캣이 구동되는 호스트 명을 리턴할 것이다. 위의 예에서는 localhost가 될 것이다.
6. 만일 8080 포트로 열려있는 (동일한 Service 엘리먼트에 들어가 있는) <Connector>가 있다면, 각 포트의 요청들이 동일한 가상 호스트와 웹 어플리케이션 집합을 공유하고 있을 것이다.
7. 운영체제의 IP 필터링이을, 아파치가 구동되는 서버에서만 허용되는 8081 포트(이 예제에서는)에 제한하고자 할 수도 있다.
8. 대안으로 다음과 같이 프락시를 통해서만 이용가능한 일련의 웹 어플리케이션을 만들 수도 있다.
   • 다른 <Service>가 프락시 포트에 대한 오직 하나의 <Connector>만을 포함하도록 설정하라.
   • 프락시로 접근가능한 가상 호스트와 웹어플리케이션에 대해 적절한 Engine, Host 그리고 Context 엘리먼트를 설정하라.
   • 앞에 나온 것처럼 IP 필터로 8081 포트를 막아도 된다.
9. 아파치가 요청들을 중개할 때 서버는 엑세스 로그 기록을 남긴다. 그러므로 톰캣 자체가 엑세스 로그를 남기지 않게 하기를 일반적으로 원할 것이다.

요청이 이런 식으로 중개될 때, 설정된 웹 어플리케이션에 대한 모든 요청들은 (정적인 콘텐트에 대한 요청까지 포함하여) 톰캣에서 처리된다. 대신 mod_webapp 웹 커넥터를 사용하여 가끔 성능을 향상시킬 수도 있다. 즉, 웹 어플리케이션 배치 디스크립터(/WEB-INF/web.xml)에 정의된 필터와 보안 제약에 의해 처리되지 않은 정적인 콘텐트를 아파치가 처리하도록 자동으로 설정을 하는 것이다.