mod_proxy parameter

링크 참고

AllowCONNECT

• usage : AllowCONNECT port [port] ...

• default : AllowCONNECT 443 563
  AllowCONNECT 지시문은 리스트를 지정합니다. 프록시 CONNECT 메서드가 사용할 수 있는 포트 번호 연결하다 오늘날의 브라우저는 https일 때 이 방법을 사용한다. 연결이 요청되고 HTTP를 통한 프록시 터널링이 적용된다

  BalancerMember

• BalancerMember [balancerurl] url [key=value] [key=value]...
  부하분산 그룹에 멤버를 추가.

  NoProxy

• NoProxy host [host] ...
  host는 Domain, SubNet, IPAddr, Hostname 의 형식을 가진다

  <Proxy>

• usage : <Proxy wildcard-url> ... </Proxy>
  해당 와일드 카드에 속한 지시문들은 프록시 컨텐츠에서만 적용됨

  ProxyBadHeader

• usage : ProxyBadHeader IsError|Ignore|StartBody

• default : PorxyBadHeader IsError
  잘못된 Header 가 전송될시, 다음과 같은 진행을 따른다

  • IsError : 502 에러를 응답한다
  • 잘못된 Header를 무시하고 진행한다
  • 잘못된 Header를 읽은 순간, 해당 부분부터 body로 판단하고 작업을 진행한다

  ProxyBlock

• usage : ProxyBlock *|word|host|doamin [word|host|domain] ...
  일치하는 단어가 포함된 주소를 차단

  ProxyDomain

• usage : ProxyDomain Domain
  Domain 이름에 없는 호스트 요청 발견시, Domain에 대한 응답 생성

  ProxyErrorOverride

• usage : ProxyErrorOverride On|Off

• default : ProxyErrorOverride Off
  reverse proxy 에 유용. 에러페이지에서 공통,비슷한 page를 보낼 수 있음

ProxyFtpDirCharset

• usage : ProxyFtpDirCharset character set

• default : ProxyFtpDirCharset ISO-8859-1
  FTP directory 의 character set

  ProxyIOBufferSize

• usage : ProxyIOBufferSize bytes

• default : ProxyIOBufferSize 8192
  Buffer 의 크기. 최소 8192 이상이여야 한다.

  <ProxyMatch>

• usage : <ProxyMatch regex> ... </ProxyMatch>
  <ProxyMatch> 는 정규표현식을 사용한다는 점을 제외하고 <Proxy>와 usage이 같다.

  ProxyMaxForwards

• usage : ProxyMaxForwards number

• default : ProxyMaxForwards -1
  요청을 전달 할 수 있는 최대 프록시 요청 수, Max-Forwards 헤더. Dos 공격 방지들을 위해 설정 가능.

  ProxyPass

• usage : ProxyPass [path] !|url [key=value] [key=value] ... [noncanon] [interpolate]
  원격서버에 매핑 가능. <Location> 안에서 사용시 첫번째 인수 생략.정규식을 지원하지 않으므로, ProxyPassMatch 를 사용하여야한다.!는 원하지 않는 경로를 지정할때 사용한다.

  ProxyPassParam

  key=value 형태의 ProxyPass Parameter

  min

  default : 0
  최소 연결 백엔드 서버. 힙 메모리가 연결된 위치 백엔드 연결을 미리 할당, 유지할때만 사용

  max

  default : 1...n
  최대 연결 백엔드 서버. 기본값은 스레드 숫자.

  smax

  default : max

  acquire

  default : -
  설정된 경우, 밀리초 동안 기다렸다, free connection 이 없을때, SERVER_BUSY 를 반환

  connectiontimeout

  default : timeout
  connection을 만들기 위해 기다리는 시간. 밀리초단위

  disablereuse

  default : Off
  mod_proxy 를 강제로 적용시, 사용 후 백엔드에 대한 연결을 바로 닫게 만듬.
  apache 와 was 사이에 firewall 이 있는 상황에 유용할 수 있음.

  flushpackets

  default : off
  출력을 자동 flush 할지 여부 결정. AJP에만 적용중

  flushwait

  default : 10
  추가 패킷을 기다리는 시간

  keepalive

  default : Off
  사용자 사이에 방화벽이 있는 경우 유용히 사용 가능.

  lbset

  default : 0
  loadbalancer cluster set 을 설정. 낮은 번호의 멤버를 먼저 시도함

  ping

  default : 0
  webserver 에 cpling을 보냄. AJP에서만 사용

  loadfactor

  default : 1
  작업자 부하 계수. 1~100 사이의 숫자. 정규화된 가중치 정의

  redirect

  리다이렉션 경로

  retry

  default : 60
  작업자 재시작 시간. 백엔드와의 연결이 오류상태이면, 해당 시간동안 요청을 보내지 않는다.
  0은 항상 재시도 함을 의미함.

  route

  작업자의 경로. 세션 ID에 추가된 값

  status

  초기 상태를 정의하는 단일 문자값.
  D - disabled
  S - stopped
  I - ignore-errors
  H - hot-standby
  E - error

  timeout

  default : ProxyTimeout
  연결 제한 시간

  ttl

  time to live

만약 ProxyPass 가 balancer:// 로 시작하는 경우, 특별한 매개변수를 추가할 수 있다. 아래 항복은 mod_proxy_balancer에 더 자세히 나와있다.

lbmethod

default : byrequests
로드밸런싱 방법
byrequests : 가중치에 따라 요청을 분배합니다
bytraffic : traffic byte count 에 따라
bybusyness : 큐의 길이가 가장 적은 작업자에게 할당

maxattempts

default : workers - 1, 단일모드일때 1
연결을 끊기전 failover 시도 횟수

nofailover

default : Off
On일때, 작업자가 에러상태이면 session을 중단합니다. was가 session replication을 지원하지 않으면 On으로 설정합니다

stickysession

Was에서 쿠키에 다른 이름을 상요하는 경우, url 인코딩 된 ID를 구분하기 위함.

scolonpathdelim

default : Off
추가적인 sticky session 을 ';' 을 통하여 사용할 수 있게 만들어줌. mod_jk 등을 사용하기 위할때 주로 사용

timeout

default : 0
비어있는 worker 를 기다리는데 사용 할 시간.

failonstatus

콤마로 이루어진 HTTP 상태 리스트. 이 리스트에 존재하는 응답 반환시, 에러를 띄운다.

failontimeout

default : Off
On일때, Was 로 요청이 전송된 후, 시간초과가 발생합니다.

forcecovery

default : On
즉각적인 복구를 강제함.

ProxyPassInterpolateEnv

• usage : ProxyPassInterpolateEnv On|Off

• default : ProxyPassInterpolateEnv Off
  mod_rewrite 와 같은 모듈에서 동적으로 활용 가능한 지시자.
  ProxyPass, ProxyPassReverse, ProxyPassReverseCookieDomain, ProxyPassReverseCookiePath 지시자의 값들을 변경시킴.

  ProxyPassMatch

• usage : ProxyPassMatch [regex] !|url [key=value] [key=value]...
  ProxyPass 와 동일한 기능. 정규식 사용 가능

  ProxyPassReverse

• usage : ProxyPassReverse [path] url [interpolate]
  URL 조절 가능. reverse proxy(or gateway) 를 사용할때 우회를 방지하기 위해 필수.

  http://example.com 에 접속할때에,

  ProxyPass /mirror/foo/ http://backend.example.com/
  ProxyPassReverse /mirror/foo/ http://backend.example.com/

  와 같은 경우, http://example.com/mirror/foo/bar 에 접속할때 proxy 는 http://backend.example.com/bar 로 접속을 시도한다

Location 내에서 수행시, 첫번째 인자는 무시한다.

ProxyPassReverseCookieDomain

• usage : ProxyPassReverseCookieDomain internal-domain public-domain [interpolate]
  ProxyPassReverse 와 동일. set-cookie 헤더가 존재

  ProxyPassReverseCookiePath

• usage : ProxyPassReverseCookiePath internal-path public-path [interpolate]
  백엔드 url 경로가 공용 경로에 매핑되는 경우 사용가능.

  ProxyPreserveHost

• usage : ProxyPreserveHost On|Off

• default : ProxyPreserveHost Off
  proxied-mass name-based virtual hosting 설정일때 사용하는 특별한 설정

  ProxyReceiveBufferSize

• usage : ProxyReceiveBufferSize bytes

• default : ProxyReceiveBufferSize 0
  Proxy HTTP,. FTP 연결에 대한 명시적 Buffer 크기. 512보다 크게 설정.

  ProxyRemote

• usage : ProxyRemote match remote- server
  원격 proxy를 지정

  remote-server = scheme://hostname[:port]

  과 같은 형식으로 지정

  ProxyRemoteMatch

• usage : ProxyRemoteMatch regex remote-server
  ProxyRemote 와 같음. 정규식을 통해 URL을 지정 가능

  ProxyRequests

• usage : ProxyRequests On|Off

• default : ProxyRequests Off
  Apache 가 Forward Proxy 역할이 가능해짐.(Off 라고 사용하지 않음은 아니다)

  ProxySet

• usage : ProxySet url key=value [key=value] ...
  ProxyBalancer 및 ProxyPass 지시문

  ProxyStatus

• usage : ProxysStatus Off|On|Full

• Default : ProxyStatus Off
  프록시 여부 결정. loadbalancer 상태 데이터는 mod_status 를 통해 표시

  ProxyTimeout

• usage : ProxyTimeout seconds

• default : Timeout
  프록시 요청에 대한 시간제한 지정 가능.

  ProxyVia

• usage : ProxyVia On|Off|Full|Block

• default : ProxyVia Off
  Via: HTTP 헤더를 제한시킨다. Via: 는 proxy 체인을 따라 흐르는 proxy 요청을 컨트롤 한다.
  Off. 처리가 필요하지 않음
  On. Via: 에 대한 요청/응답의 각 헤더에 추가됨
  Full. 각각 Via: 헤더를 생성하며, 각각의 라인은 Apache 버젼 및 주석을 나타낸다.
  Block. 모든 프록시 요청이 Via: 헤더라인을 제거한다.