리버스 프록시 설정 확인하는 순서

리버스 프록시 문제는 운영 중에 발생하면 문제를 크게 잡아야 하기 때문에 무섭다. 하지만 단계적으로 확인하면 대부분 간단한 설정 실수다.

DNS가 제대로 향하고 있는지 먼저 확인

도메인이 실제로 어느 서버 IP를 향하고 있는지부터 확인해야 한다. DNS 레코드가 업데이트되는 데 시간이 걸릴 수 있으니, 글로벌 DNS로 조회해보자.

# DNS A 레코드 확인
dig example.com

# 특정 DNS 서버로 조회
dig @8.8.8.8 example.com

# 종합 DNS 정보 확인
dig example.com +trace

SSL/TLS 인증서가 유효한지 확인하기

HTTPS 연결이 안 된다면 인증서 문제일 가능성이 높다. 인증서가 설치되어 있는지, 그리고 유효 기간이 남아 있는지 확인해야 한다.

# HTTPS로 접속하면서 헤더와 인증서 정보 확인
curl -I https://example.com

# 인증서 상세 정보 확인 (openssl 필요)
openssl s_client -connect example.com:443

Nginx 설정 문법이 맞는지 검증하기

Nginx 설정을 고칠 때는 무조건 리로드 전에 문법을 확인해야 한다. 문법 오류가 있으면 nginx 자체가 시작 안 되고, 서비스 전체가 다운될 수 있다.

# 문법 검증 (실제 적용하지는 않음)
sudo nginx -t

# 설정 적용하기
sudo systemctl reload nginx

프록시 규칙이 제대로 전달되는지 확인하기

리버스 프록시가 요청을 올바른 백엔드로 전달하는지 확인하려면 요청 헤더를 봐야 한다. X-Forwarded-For, X-Forwarded-Proto 같은 헤더가 제대로 전달되고 있는지 백엔드 로그에서 확인한다.

캐시가 문제는 아닌지 의심해보기

Nginx나 브라우저 캐시가 오래된 내용을 보여줄 수 있다. DNS 캐시도 마찬가지다. 설정을 바꿨는데 바뀐 게 안 보이면 캐시를 지우고 다시 시도해보자. 브라우저는 Ctrl+Shift+Delete (또는 Cmd+Shift+Delete)로 캐시를 지울 수 있다.