가상 호스트(virtualHost)
가상 호스트는 특정 호스트 이름에 대해 웹 애플리케이션을 구성하기 위한 논리 그룹화를 제공합니다. 기본 가상 호스트(default_host)는 대부분의 단순 구성에 적합합니다.
| 속성 이름 | 데이터 유형 | 기본값 | 설명 |
|---|---|---|---|
| allowFromEndpointRef | 맨 위 레벨 httpEndpoint 요소에 대한 참조의 목록입니다(쉼표로 구분된 문자열). | 이 가상 호스트의 지정된 엔드포인트에 대한 인바운드 트래픽을 제한하기 위해 하나 이상의 HTTP 엔드포인트 ID를 지정하십시오. | |
| enabled | boolean | true | 이 가상 호스트를 사용합니다. |
| id | string | 고유 구성 ID입니다. |
- allowFromEndpoint
설명: 이 가상 호스트의 지정된 엔드포인트에 대한 인바운드 트래픽을 제한하기 위해 하나 이상의 HTTP 엔드포인트 ID를 지정하십시오.필수: false데이터 유형: 속성 이름 데이터 유형 기본값 설명 accessLoggingRef 맨 위 레벨 httpAccessLogging 요소에 대한 참조입니다(문자열). 엔드포인트에 대한 HTTP 액세스 로깅 구성입니다. enabled boolean true 엔드포인트의 가용성을 토글하십시오. True일 때는 이 엔드포인트가 디스패처에 의해 활성화되어 HTTP 요청을 처리합니다. host string 로컬 호스트 클라이언트가 자원을 요청하는 데 사용하는 IP 주소, 도메인 이름 접미부를 갖는 도메인 이름 서버(DNS) 호스트 이름 또는 DNS 호스트 이름만입니다. 사용 가능한 모든 네트워크 인터페이스에 대해 '*' 기호를 사용합니다. httpOptionsRef 맨 위 레벨 httpOptions 요소에 대한 참조입니다(문자열). defaultHttpOptions 엔드포인트에 대한 HTTP 프로토콜 옵션입니다. httpPort int 최소값: -1
최대값: 65535
클라이언트 HTTP 요청에 사용되는 포트입니다. 이 포트를 사용하지 않으려면 -1을 사용하십시오. httpsPort int 최소값: -1
최대값: 65535
SSL(https)로 보안되는 클라이언트 HTTP 요청에 사용되는 포트입니다. 이 포트를 사용하지 않으려면 -1을 사용하십시오. id string 고유 구성 ID입니다. onError - IGNORE
- FAIL
- WARN
WARN 엔드포인트 시작에 실패한 이후에 수행할 조치입니다. - IGNORE
- 서버에서 구성 오류가 발생하는 경우 경고 및 오류 메시지를 발행하지 않습니다.
- FAIL
- 서버에서 첫 번째 오류 발생 시 경고 또는 오류 메시지를 발행한 후 서버를 중지합니다.
- WARN
- 서버에서 구성 오류가 발생하는 경우 경고 및 오류 메시지를 발행합니다.
sslOptionsRef 맨 위 레벨 sslOptions 요소에 대한 참조입니다(문자열). 엔드포인트에 대한 SSL 프로토콜 옵션입니다. tcpOptionsRef 맨 위 레벨 tcpOptions 요소에 대한 참조입니다(문자열). defaultTCPOptions 엔드포인트에 대한 TCP 프로토콜 옵션입니다. - allowFromEndpoint > accessLogging
설명: 엔드포인트에 대한 HTTP 액세스 로깅 구성입니다.필수: false데이터 유형: 속성 이름 데이터 유형 기본값 설명 enabled boolean true 액세스 로깅을 사용하도록 설정합니다. filePath 파일 경로 ${server.output.dir}/logs/http_access.log 액세스 로그 파일의 디렉토리 경로 및 이름입니다. 디렉토리 경로를 지정할 때 ${server.output.dir}과 같은 표준 변수 대체를 사용할 수 있습니다. logFormat string %h %u %{t}W "%r" %s %b 클라이언트 액세스 정보를 로깅할 때 사용되는 로그 형식을 지정합니다. maxFileSize int 최소값: 0
20 로그 파일이 롤오버되기 전에 MB 단위의 최대 크기입니다. 값 0은 무제한을 의미합니다. maxFiles int 최소값: 0
2 가장 오래된 파일이 제거되기 전에 유지될 최대 로그 파일 수입니다. 값 0은 무제한을 의미합니다.
- allowFromEndpoint > httpOptions
설명: 엔드포인트에 대한 HTTP 프로토콜 옵션입니다.필수: false데이터 유형: 속성 이름 데이터 유형 기본값 설명 keepAliveEnabled boolean true 지속적 연결을 사용합니다(HTTP KeepAlive). true일 경우 연결은 재사용을 위해 다수의 순차 요청 및 응답에 의해 유지됩니다. false일 경우 연결은 응답이 전송된 후 닫힙니다. maxKeepAliveRequests int 최소값: -1
100 지속적 연결이 사용 가능한 경우 단일 HTTP 연결에서 허용되는 최대 지속적 요청 수입니다. -1의 값은 무제한을 의미합니다. persistTimeout 초단위 정밀도를 가진 기간 30s 소켓이 요청 사이에 유휴 상태로 남도록 허용되는 시간입니다. 이 설정은 지속적 연결이 사용 가능한 경우에만 적용됩니다. 시간의 단위로 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다. readTimeout 초단위 정밀도를 가진 기간 60s 읽기 요청이 첫 번째 읽기가 발생한 후 소켓에서 완료하기를 대기하는 시간입니다. 시간의 단위로 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다. removeServerHeader boolean false HTTP 헤더에서 서버 구현 정보를 제거하고 기본 Liberty 프로파일 환영 페이지를 사용하지 않도록 설정합니다. writeTimeout 초단위 정밀도를 가진 기간 60s 응답 데이터의 각 부분이 전송되기를 소켓에서 대기하는 시간입니다. 시간의 단위로 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다.
- allowFromEndpoint > sslOptions
설명: 엔드포인트에 대한 SSL 프로토콜 옵션입니다.필수: false데이터 유형: 속성 이름 데이터 유형 기본값 설명 sessionTimeout 초단위 정밀도를 가진 기간 1d 소켓에서 읽기 또는 쓰기 요청이 완료되기를 기다리는 시간입니다. 이 값은 프로토콜별 제한시간으로 대체됩니다. 시간의 단위로 양수를 지정하십시오. 이는 시간(h), 분(m) 또는 초(s)일 수 있습니다. 예를 들어, 30초를 30s로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1m30s는 90초와 동등합니다. sslRef 맨 위 레벨 ssl 요소에 대한 참조입니다(string). 기본 SSL 구성 레퍼토리입니다. 기본값은 defaultSSLSettings입니다. suppressHandshakeErrors boolean false SSL 핸드쉐이크 오류의 로깅을 사용하지 않습니다. 정상 조작 중에도 SSL 핸드쉐이크 오류가 발생할 수는 있지만 SSL이 예기치 않은 방식으로 작동하는 경우에는 이러한 메시지가 유용할 수 있습니다.
- allowFromEndpoint > tcpOptions
설명: 엔드포인트에 대한 TCP 프로토콜 옵션입니다.필수: false데이터 유형: 속성 이름 데이터 유형 기본값 설명 inactivityTimeout 밀리초 정밀도의 기간 60s 소켓에서 읽기 또는 쓰기 요청이 완료되기를 기다리는 시간입니다. 이 값은 프로토콜별 제한시간으로 대체됩니다. 시간의 단위로 양수를 지정하십시오. 이는 시간(h), 분(m), 초(s) 또는 밀리초(ms)일 수 있습니다. 예를 들어, 500밀리초를 500ms로 지정하십시오. 하나의 항목에 여러 값을 포함할 수 있습니다. 예를 들어, 1s500ms는 1.5초와 동등합니다. soReuseAddr boolean true 활성 리스너 없이 포트에 대한 즉각적 리바인드를 사용합니다.
참조 주제