Nginx 보안 헤더가 200에는 있고 500에는 없을 때
Nginx add_header는 기본적으로 모든 상태 코드에 같은 방식으로 붙지 않습니다. 정상 페이지에서 헤더가 보인다는 것으로 오류 응답까지 적용됐다고 판단하지 않습니다. 필요하다면 always의 역할과 사용 버전을 확인합니다.

- add_header는 기본 적용 상태 코드 조건이 있습니다
- 내부 오류 페이지의 location도 확인합니다
- 정상·리다이렉트·오류를 나눠 요청합니다
add_header는 기본 적용 상태 코드 조건이 있습니다
Nginx add_header는 기본적으로 문서에 열거된 상태 코드에만 적용됩니다. 500 등 오류 응답에도 필요하면 해당 지시어에 always를 사용합니다. always는 1.7.5부터 지원하므로 사용 중인 버전을 확인합니다. 정상 페이지에서 헤더가 보인다는 것만으로 오류 응답까지 적용됐다고 판단하지 않습니다.
내부 오류 페이지의 location도 확인합니다
오류 처리가 다른 location으로 이동하면 최종 응답의 설정도 달라질 수 있습니다. 기본적으로 하위 수준에 add_header를 하나라도 정의하면 상위 add_header들이 그대로 상속되지 않습니다. 상속을 제어하는 add_header_inherit는 1.29.3부터이므로 구버전에는 사용하지 않습니다. 오류 location에 필요한 전체 헤더가 실제로 있는지 대조합니다.
정상·리다이렉트·오류를 나눠 요청합니다
비밀 없는 시험 경로에서 실제 응답 헤더를 비교합니다. 같은 헤더가 중복돼 상충하는지도 확인합니다. 정책 목적에 맞는지 검토한 뒤 적용하고 브라우저 화면이 아니라 최종 HTTP 응답을 근거로 결과를 기록합니다.
서버 운영 실행 전 점검표
- add_header는 기본 적용 상태 코드 조건이 있습니다
- 내부 오류 페이지의 location도 확인합니다
- 정상·리다이렉트·오류를 나눠 요청합니다
이 가이드의 근거 문서
출처 확인일: 2026-11-04. 공식 문서에 기반한 편집 가이드이며 직접 수행한 벤치마크가 아닙니다. 비용 사례는 명시된 가정에 한합니다.
오류 제보 방법