세션 상태 서비스를 재시작하지 않고 리버스 프록시를 재시작하는 방법

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

리버스 프록시를 뒤에 있는 인증 및 세션 상태 서비스와 독립적으로 리로드하거나 재시작할 수 있으면, 계획된 프록시 유지보수를 더욱 안전하게 진행할 수 있습니다.

일반적으로 프록시 프로세스는 자신이 전달하는 로그인 상태를 직접 소유할 필요가 없습니다. 유지보수 전에 어떤 구성 요소가 쿠키에 서명하고, 서버 측 세션을 저장하며, 인증을 종료하고, 활성 HTTP 연결을 정리하는지 파악하세요. 상태를 유지하는 구성 요소는 계속 실행하고, 구성만 변경할 때는 무중단 프록시 리로드를 우선 사용하세요. 프록시를 완전히 교체한 뒤에도 변경되지 않은 비밀값을 사용해 동일한 인증 게이트웨이와 세션 저장소에 다시 연결되는지 확인하세요.

프록시와 인증 서비스의 수명 주기를 분리하세요

프록시를 재시작해도 인증 게이트웨이, 애플리케이션, Redis 또는 데이터베이스가 자동으로 다시 생성되지 않도록 Compose 종속성, 재시작 정책, 공유 스크립트, 스택 관리자 작업을 확인하세요.

세션 아키텍처의 한 예에서는 프록시 수명 주기와 분리된 Redis를 사용하여 여러 인증 인스턴스와 재시작 후에도 동일한 세션 백엔드를 공유합니다.

모든 엣지 서비스를 하나의 무차별적인 재시작 명령에 포함하지 마세요. 인증서나 라우트 변경이 프록시에만 영향을 준다면 기존 로그인 상태를 확인하는 서비스는 그대로 실행하세요.

가능하면 재시작 대신 구성을 리로드하세요

라우트, 인증서 또는 헤더를 변경할 때는 서비스를 중지하는 대신 프록시에서 지원하는 무중단 리로드 절차를 사용하세요. 구성에 오류가 없는지 적용 전에 확인해 계획된 유지보수가 서비스 중단으로 이어지지 않도록 하세요.

API7의 NGINX 안내에서는 업데이트된 구성으로 새 워커가 요청을 처리하는 동안 기존 워커가 연결을 정리하는 방식을 설명합니다.

리로드하면 프록시 프로세스 계열은 유지되지만, 배포 스크립트가 별도의 인증 서비스도 재시작한다면 해당 서비스까지 보호되지는 않습니다. 두 구성 요소의 수명 주기는 별도로 관리하세요.

프록시 교체 중 외부 세션 저장소 유지

인증 게이트웨이가 쿠키 외부에 세션 데이터를 저장한다면, 프록시 작업 중에도 Redis 또는 다른 세션 백엔드를 계속 유지하고 변경하지 마세요. 모든 인증 인스턴스에서 사용하는 백엔드 주소와 비밀값을 기록하세요.

세션을 여러 인스턴스 간에 공유해야 하는 경우 OAuth2 Proxy는 공유 세션 저장소로서의 Redis를 지원합니다.

폐기 가능한 캐시와 로그인 상태의 기준 데이터를 혼동하지 마세요. 현재 사용자를 확인하는 데 세션 백엔드가 필요하다면, 자체적으로 검증된 유지보수 절차에 따라서만 재시작하거나 초기화하세요.

쿠키와 서명 비밀값을 안정적으로 유지하세요

인증 게이트웨이에서 사용하는 쿠키 암호화 또는 서명 비밀 값을 기록하고, 교체되는 프록시 스택이 동일한 비밀 값 소스를 마운트하는지 확인하세요. 재배포 중 새 값을 생성하면 정상적으로 작동하는 브라우저 쿠키도 무효화됩니다.

역방향 프록시 세션 가이드에서는 세션이 하나의 TCP 연결 수명이 아니라 안정적인 세션 정책에 따라 재시작 후에도 유지된다고 설명합니다.

서명 비밀 값은 명시적인 로그아웃 안내 또는 중복 사용 전략을 마련해 별도의 보안 변경으로 교체하세요. 세션 무효화가 의도된 경우가 아니라면 일반적인 계획된 프록시 다시 로드와 비밀 값 교체를 함께 진행하지 마세요.

프록시를 완전히 재시작할 때 연결 드레이닝하기

프록시 바이너리나 컨테이너를 교체해야 할 때는 가능한 경우 정상 종료 또는 무중단 재시작 기능을 사용해 이미 진행 중인 요청이 응답 도중 끊기지 않도록 하세요. 장시간 연결을 위해 유지 관리 타임아웃을 설정하세요.

HAProxy 다시 로드 가이드에서는 기존 프로세스를 즉시 종료하지 않고 무중단 다시 로드로 연결을 유지하는 방법을 설명합니다.

연결 유지와 로그인 유지는 서로 다릅니다. 웹소켓이 다시 연결되더라도 교체된 프록시가 동일한 인증 및 상태 서비스에 연결되므로 세션은 유효한 상태로 유지되어야 합니다.

계획된 유지 관리 전후에 세션 하나 테스트하기

로그인된 브라우저 하나와 새 비공개 세션 하나를 사용하세요. 유지 관리 전에 세션 쿠키, 프록시 경로, 인증 서비스, 백엔드를 기록한 다음 프록시만 다시 로드하거나 교체하고 동일한 보호된 요청을 다시 수행하세요.

Caddy 운영 가이드에서는 계획된 구성 업데이트 시 완전 재시작 대신 다시 로드할 것을 권장합니다.

기존 로그인이 유지되고, 새 로그인이 여전히 성공하며, 상태를 유지하는 종속 서비스가 의도치 않게 재시작되지 않을 때 유지 관리 설계가 제대로 작동하는 것입니다. 사용자가 여전히 로그아웃된 상태라면 관련 ZimaSpace 문서인 프록시 재시작 후 세션 손실이 여전히 올바른 복구 절차입니다.

자주 묻는 질문

프록시를 정상적으로 다시 로드하면 사용자가 계속 로그인 상태를 유지한다고 보장되나요?

아니요. 프록시 연결은 보호하지만, 인증 서비스, 세션 저장소 또는 쿠키 서명 비밀 값이 동시에 변경되면 사용자는 여전히 로그아웃될 수 있습니다.

Redis는 항상 프록시 재시작 후에도 유지되어야 하나요?

Redis가 세션 상태나 인증을 위한 다른 영구 종속성을 저장하는 경우에만 그렇습니다. 캐시 전용 Redis 인스턴스는 복구 범위가 다릅니다.

쿠키 이름만 같으면 충분한가요?

아니요. 서명 또는 암호화 비밀 값과 백엔드 세션 상태도 브라우저가 이미 보유한 쿠키와 호환되어야 합니다.

지원 및 팁

더 읽어보기

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.