리버스 프록시가 한 앱을 다른 앱의 도메인으로 리디렉션하는 이유는 무엇인가요?

Eva Wong 는 테크니컬 라이터 이자 상주 메이커 로 ZimaSpace에서 활동합니다. 평생 기술을 사랑해 온 그녀는 홈랩과 오픈 소스 소프트웨어에 열정을 품고 있으며, 복잡한 기술 개념을 누구나 이해하기 쉬운 실습 가이드로 풀어내는 데 전문성을 갖추고 있습니다. Eva는 셀프 호스팅이 어렵고 부담스러운 일이 아니라 즐거워야 한다고 믿습니다. 그녀는 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 어려움을 풀어내고, 첫 NAS를 조립하는 것부터 Docker 컨테이너를 능숙하게 다루는 것까지 도전하도록 돕습니다.

백엔드나 미들웨어가 잘못된 공개 호스트 이름을 바탕으로 리디렉션을 생성하면 리버스 프록시가 한 앱을 다른 앱의 도메인으로 보낼 수 있습니다.

ZimaSpace 셀프 호스팅 스택에서는 여러 앱이 같은 프록시를 공유하면서도 각자 다른 공개 기본 URL을 기대할 수 있습니다. Host, X-Forwarded-Host, 스킴, 미들웨어 또는 앱 수준의 표준 URL이 다른 서비스를 가리키면 첫 페이지는 제대로 로드되더라도 다음 301, 302 또는 로그인 콜백에서 도메인이 바뀔 수 있습니다.

백엔드로 전송되는 Host와 스킴 확인

리디렉션을 재현하는 동안 프록시와 백엔드에서 요청 헤더를 캡처하세요.

전달된 호스트와 스킴이 백엔드에 전달됩니다에 관한 집중적인 리버스 프록시 구현 가이드는 기반 프로토콜만 설명하는 대신 같은 세부 문제를 다루므로 이 분기를 파악하는 데 도움이 됩니다.

애플리케이션 URL을 변경하기 전에 프록시 헤더를 바로잡으세요. 백엔드가 요청이 다른 호스트를 사용했다고 판단하면 올바른 절대 리디렉션 URL을 생성할 수 없습니다.

X-Forwarded-Host를 구체적으로 확인

일부 프레임워크는 절대 URL을 생성할 때 원본 Host 헤더 대신 X-Forwarded-Host를 사용합니다.

X-Forwarded-Host가 공개 호스트 이름을 유지합니다에 관한 집중적인 HTTP 헤더 해설은 기반 프로토콜만 설명하는 대신 같은 세부 문제를 다루므로 이 분기를 파악하는 데 도움이 됩니다.

정상 작동하는 앱과 잘못 리디렉션되는 앱의 이 헤더를 비교하세요. 모든 백엔드를 하나의 도메인으로 강제하는 전역 재정의 설정은 제거하세요.

앱이 절대 URL을 생성하는지 확인

프록시 헤더를 신뢰하고 표준 링크나 리디렉션을 생성하는 프레임워크 설정을 찾아보세요.

프록시 뒤에서 절대 URL이 잘못될 수 있습니다에 관한 실전 프록시 디버깅 블로그는 기반 프로토콜만 설명하는 대신 같은 세부 문제를 다루므로 이 분기를 파악하는 데 도움이 됩니다.

모든 리디렉션을 프록시 경계에서 다시 작성하는 대신 프레임워크의 프록시 신뢰 설정이나 공개 URL 설정을 수정하세요.

앱 기본 URL 또는 표준 도메인 확인

셀프 호스팅 앱 중 상당수는 프록시 규칙과 별도로 사이트 URL을 저장합니다.

애플리케이션 기본 URL이 프록시 호스트 이름을 덮어쓸 수 있습니다에 관한 실용적인 앱-프록시 사례 연구는 기반 프로토콜만 설명하는 대신 같은 세부 문제를 다루므로 이 분기를 파악하는 데 도움이 됩니다.

마이그레이션이나 복원 후 저장된 애플리케이션 URL 값을 비교하세요. 복사한 데이터베이스에 다른 앱 환경의 표준 호스트 이름이 포함되어 있을 수 있습니다.

백엔드에 도달하기 전 리디렉션 미들웨어 점검

프록시 규칙은 요청이 애플리케이션에 도달하기 전에 스킴이나 호스트를 의도적으로 다시 쓸 수 있습니다.

리디렉션 미들웨어가 호스트를 바꿀 수 있습니다를 다루는 집중적인 홈랩 Traefik 실습 문서는 기본 프로토콜만 설명하는 대신 동일한 세부 문제를 다루므로 이 분기를 분리하는 데 도움이 됩니다.

테스트용 라우터 하나에서 의심되는 리디렉션 미들웨어만 비활성화하세요. HTTPS 강제와 교차 도메인 리디렉션은 별도로 유지하세요.

OAuth 및 OIDC 콜백 URL 확인

인증 흐름에서는 공급자가 정확히 일치하는 리디렉션 URI를 검증하므로 잘못된 공개 호스트 이름이 드러나는 경우가 많습니다.

OIDC 콜백은 공개 프록시 URL에 따라 달라집니다를 다루는 집중적인 OIDC 문제 해결 문서는 기본 프로토콜만 설명하는 대신 동일한 세부 문제를 다루므로 이 분기를 분리하는 데 도움이 됩니다.

발급자, 콜백, 전달된 헤더, 앱 기본 URL을 함께 비교하세요. 일반 페이지가 로드된다고 해서 로그인 콜백 경로가 올바르다는 뜻은 아닙니다.

정확히 같은 홈 서버 경로 재테스트

변수 하나를 변경한 뒤에는 다른 경로를 사용할 수 있는 별도의 테스트로 바꾸지 말고, 동일한 클라이언트에서 같은 NAS 또는 셀프 호스팅 작업을 반복하세요.

인접한 홈 서버 네트워크 경로에 관한 ZimaSpace 관련 가이드를 참고하면 최종 확인을 동일한 셀프 호스팅 환경에서 진행할 수 있습니다.

다시 연결하고 서비스를 재시작한 뒤, 통제된 전송이나 요청을 한 번 더 수행해도 처음 증상이 해결된 상태로 유지될 때만 문제가 완전히 해결된 것입니다.

자주 묻는 질문

DNS가 HTTP 301 또는 302를 일으킬 수 있나요?

DNS는 주소만 반환합니다. 리디렉션은 프록시, 인증 계층 또는 애플리케이션이 생성합니다.

브라우저에서 도메인이 바뀌기 전에는 왜 올바른 앱이 로드되나요?

초기 프록시 경로가 올바르더라도 백엔드가 잘못된 기본 URL이나 전달된 호스트를 바탕으로 나중에 절대 리디렉션을 생성할 수 있습니다.

프록시에서 모든 Location 헤더를 다시 써야 하나요?

아니요. 광범위한 응답 재작성은 애플리케이션 설정 오류를 감출 수 있으니 먼저 잘못된 호스트 이름의 출처를 바로잡으세요.

지원 및 팁

더 읽어보기

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.