X-Forwarded-For (XFF)는 프록시를 통해 웹 서버에 연결하는 클라이언트의 원래 IP 주소를 식별하는 HTTP 요청 헤더입니다. 이를 사용하지 않으면 서버는 마지막 프록시의 IP만을 볼 수 있습니다. 이 헤더는 설계상 클라이언트의 IP를 노출하기 때문에, 이를 추가하는 프록시는 원래 주소를 목적지 사이트에 전달합니다.

체인 내의 각 프록시는 연결을 수신한 IP 주소를 추가합니다. 가장 왼쪽 항목은 주장된 클라이언트이고, 가장 오른쪽은 가장 최근의 프록시입니다. 예를 들어 X-Forwarded-For: 203.0.113.195, 198.51.100.178.

표준 상태 및 관련 헤더

  • 사실상의 표준: XFF는 널리 사용되지만 현재 어떤 명세에도 정의되어 있지 않습니다.
  • 전달 헤더: RFC 7239는 동일한 정보를 위한 표준 Forwarded 헤더를 정의하지만, 실제로는 훨씬 덜 사용됩니다.
  • 동반 헤더: X-Forwarded-Host, X-Forwarded-Proto 및 Via는 관련 프록시 세부 정보를 전달합니다.
  • 로드 밸런서: 일부 로드 밸런서는 클라이언트 IP를 XFF에 추가하거나, 변경하지 않고 전달하거나, 제거할 수 있습니다.

신뢰 및 스푸핑

클라이언트는 위조된 X-Forwarded-For 헤더를 보낼 수 있으므로, 신뢰할 수 있는 프록시가 추가한 주소만 신뢰할 수 있습니다. XFF를 속도 제한 또는 접근 제어에 사용하는 서버는 오른쪽에서부터 목록을 읽고, 알려진 신뢰할 수 있는 프록시는 건너뛰며, 가장 왼쪽 값을 신뢰할 수 없는 것으로 처리해야 합니다. 서버가 인터넷에서 직접 접근할 수 있는 경우, 목록의 어떤 부분도 신뢰할 수 없습니다.

X-Forwarded-For의 사용 용도

프록시 또는 로드 밸런서 뒤에 있는 서버는 해당 장치의 IP 주소만 기록합니다. XFF는 디버깅, 통계 및 위치 의존 콘텐츠를 위해 클라이언트의 주소를 복구할 수 있게 해줍니다.

NGINX에서 X-Forwarded-For 읽기

NGINX의 realip 모듈은 X-Forwarded-For와 같은 헤더에서 가져온 주소로 클라이언트 주소를 대체합니다.

  • set_real_ip_from: 올바른 값을 전송하는 것으로 알려진 신뢰할 수 있는 주소 목록입니다.
  • real_ip_header X-Forwarded-For;: NGINX에 어떤 헤더를 읽어야 하는지 알려줍니다.
  • real_ip_recursive on;: 마지막으로 신뢰할 수 없는 헤더의 주소를 사용하여, 전체 마지막 주소 대신 사용합니다.

이 모듈은 기본적으로 빌드되지 않습니다. --with-http_realip_module 빌드 옵션이 필요합니다.

관련 용어