본문 바로가기
WIKI 기술 지식 베이스

request_header 지시문

원문 보기 위키 갱신

request_header 지시문 (요청 헤더 조작)

request_header 지시문은 요청의 HTTP 헤더 필드를 조작해요. 헤더 값을 설정·추가·삭제하거나 정규 표현식으로 치환할 수 있어요.

출처: Caddy 공식 문서

본문

요청의 HTTP 헤더 필드를 조작해요. 헤더 값을 설정·추가·삭제하거나 정규 표현식을 사용해 치환할 수 있어요.

프록시를 위해 헤더를 조작하려면, 그 조작은 프록시를 인지하므로 reverse_proxy의 header_up 하위 지시문을 대신 사용해요.

HTTP 응답 헤더를 조작하려면 header 지시문을 사용해요.

문법 (Syntax)

request_header [<matcher>] [[+|-]<field> [<value>|<find>] [<replace>]]
  • ****는 헤더 필드의 이름이에요.

    접두사가 없으면 필드를 설정(덮어쓰기)해요.

    +를 붙이면 필드가 이미 존재해도 덮어쓰지 않고 추가해요. 헤더 필드는 요청에 여러 번 나타날 수 있어요.

    -를 붙이면 필드를 삭제해요. 필드에 접두사 또는 접미사 * 와일드카드를 써서 일치하는 필드를 모두 삭제할 수 있어요.

  • ****는 필드를 추가하거나 설정할 때의 헤더 필드 값이에요.

  • ****는 검색할 부분 문자열 또는 정규 표현식이에요.

  • ****는 치환할 값이에요. 검색-치환을 수행하려면 필수예요.

예시 (Examples)

요청에서 Referer 헤더를 제거해요:

request_header -Referer

요청에서 밑줄을 포함한 모든 헤더를 삭제해요:

request_header -*_*

더 알아보기 (Learn more)