trust proxy
Express 등에서 X-Forwarded-* 헤더를 신뢰해 원래 클라이언트 IP/스킴을 복원하는 설정
trust proxy는 Express 같은 웹 프레임워크가 리버스 프록시 뒤에서 동작할 때 X-Forwarded-For, X-Forwarded-Proto 같은 헤더를 신뢰해 “원래 요청 정보”를 복원할지 결정하는 설정입니다.
왜 필요한가요?
- HTTPS 종료(SSL termination)가 nginx에서 이뤄지면, 앱은 내부적으로 HTTP로 보일 수 있습니다.
- 로그인 리다이렉트, 절대 URL 생성, 보안 쿠키(
Secure) 판단 등에 영향을 줍니다.
실무 체크리스트
- nginx에서
X-Forwarded-*를 설정했는지 확인합니다. trust proxy를 무작정 켜면 IP 스푸핑 위험이 있으니, 프록시 범위를 제한하는 옵션을 사용합니다.
관련 용어: X-Forwarded-For, X-Forwarded-Proto