리버스 프록시 재시작 후 Immich 로그인 실패

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

리버스 프록시를 재시작한 후에만 Immich 로그인이 실패한다면, 먼저 Immich 애플리케이션과 계정은 직접 접속 시 정상인데 프록시 경로만 끊겼는지 확인하세요.

재시작으로 인해 오래된 업스트림 주소, 공유 네트워크 멤버십 누락, 헤더 변경, 쿠키 동작 또는 의존 서비스에 연결되기 전에 먼저 실행된 프록시 프로세스가 드러날 수 있습니다. 동일한 계정으로 로컬 Immich 엔드포인트와 일반 공개 호스트 이름을 각각 테스트한 뒤, 두 경로가 처음 갈라지는 계층을 확인하세요.

직접 접속으로 인증 문제와 프록시 문제 구분하기

신뢰할 수 있는 로컬 경로를 통해 리버스 프록시를 우회해 Immich 서버에 알려진 계정으로 접속해 보세요. 직접 로그인은 성공하지만 공개 호스트 이름에서는 로딩이 계속되거나, 리디렉션되거나, 업스트림 오류가 반환된다면 사용자 레코드와 기본 인증 경로는 정상일 가능성이 높습니다. 프록시, TLS, 라우팅 및 브라우저 상태를 중심으로 조사하세요.

직접 접속은 되지만 프록시를 통한 로그인은 실패한 커뮤니티 사례는 이러한 분리 진단 방법을 보여줍니다. 보고된 내용은 특정 버전에 관한 것이므로 동일한 근본 원인을 가정하지 말고 접속 경로를 비교하는 근거로 활용하세요.

직접 로그인과 프록시를 통한 로그인 모두 실패하면 프록시 설정을 더 이상 변경하지 마세요. 대신 Immich 서비스 상태, 데이터베이스 연결, 계정 상태 및 서버 로그를 확인하세요. 장애가 발생한 시점에 프록시도 재시작됐다는 것은 우연일 수 있습니다. 우회 테스트를 하면 그 시점만으로 근거 없는 진단을 내리는 일을 막을 수 있습니다.

프록시가 현재 Immich 업스트림에 연결할 수 있는지 확인

프록시를 재시작한 후 자체 네트워크 네임스페이스에서 Immich 업스트림을 확인하고 연결할 수 있는지 확인하세요. Docker에서는 공유 사용자 정의 네트워크의 서비스 이름을 업스트림으로 지정하는 방식이 일반적으로 컨테이너를 다시 만들 때 바뀌는 컨테이너 IP를 수동으로 복사해 사용하는 것보다 안정적입니다.

프록시와 Immich 간 연결 관련 리버스 프록시 장애 논의는 계정 복구를 시도하기 전에 업스트림 연결 가능성과 WebSocket을 지원하는 프록시 구성을 확인해야 하는 이유를 보여줍니다. 정확한 구성은 참고 사례로만 다루고 모든 프록시에 적용되는 템플릿으로 간주하지 마세요.

프록시만 두 번 재시작하고 매번 업스트림이 동일한 서비스로 연결되는지 확인하세요. 주소를 수정하지 않아도 즉시 연결에 성공하면 통과입니다. 컨테이너를 다시 만든 후 이름 확인, 네트워크 멤버십 또는 대상 포트가 바뀐다면 스택을 반복해서 재시작하지 말고 Compose 네트워크 정의를 수정하세요.

전달 헤더, TLS 및 쿠키 동작 검사

프록시가 Immich 페이지를 반환하더라도 전체 HTTP 경로에 따라 인증이 달라지므로 로그인이 실패할 수 있습니다. 재시작 전후의 프록시 구성을 비교해 호스트 및 스킴 전달, HTTPS 종료, 리디렉션, 쿠키 재작성 여부, 그리고 두 번째 프록시나 터널이 응답을 수정하는지도 확인하세요.

Immich 커뮤니티의 한 논의에서는 프록시 쿠키 처리로 로그인이 멈춘 중복 쿠키 로그인 사례를 다룹니다. 제한적인 사례이지만, 유효한 자격 증명만으로 프록시를 통한 세션이 정상적으로 성립한다고 단정하지 말고 브라우저 응답과 쿠키를 확인해야 한다는 점을 잘 보여줍니다.

브라우저 세션이 멈춘 것처럼 보인다고 모든 계정을 삭제하거나 데이터베이스를 초기화하지 마세요. 기존 쿠키와 응답을 기록한 뒤 시크릿 창이나 다른 브라우저를 사용하세요. 깨끗한 클라이언트에서는 정상 작동한다면 영향을 받은 사이트 데이터만 삭제하고, 잘못된 쿠키나 리디렉션을 만든 프록시 규칙을 수정하세요.

요청 실패 시점의 프록시 액세스 로그와 오류 로그 확인

로그인 시도를 한 번 재현하고 정확한 시간, 공개 호스트 이름, 클라이언트, 반환된 상태를 기록하세요. 그런 다음 해당 요청 전후의 프록시 액세스 로그와 오류 로그를 확인하세요. 프록시에 도달하지 않은 요청, 프록시가 생성한 4xx 또는 5xx 응답, 업스트림 연결 실패, Immich에 도달해 애플리케이션 응답을 받은 요청을 구분하세요.

NGINX 로그 문제 해결 워크플로에서는 상태 코드, 업스트림 오류, 요청 처리 시간, 대상별 로깅이 로그인 페이지를 반복해서 새로 고치는 것보다 훨씬 확실한 단서를 제공하는 방법을 보여줍니다. Caddy, Traefik 또는 다른 프록시에도 같은 원칙을 적용하세요.

프록시 로그에 업스트림 응답이 성공적으로 기록되었는데 브라우저에서 로그인이 완료되지 않는다면 리디렉션, 쿠키, TLS, 클라이언트 상태를 점검하세요. 프록시가 업스트림에 연결할 수 없다면 라우팅 또는 서비스 준비 상태를 수정하세요. Immich 자체가 오류를 반환한다면 프록시를 원인으로 단정하지 말고 해당 서버 로그를 확인하세요.

문제를 일으켰던 재시작 후에도 수정이 유지되는지 확인하세요

원인이 확인되어 수정된 후에는 동일한 트리거를 다시 테스트하세요. 리버스 프록시만 재시작하고, 상태 점검이 완료될 때까지 기다린 다음, 공개 호스트 이름으로 로그인하세요. 기존 에셋을 열고 작은 파일을 업로드한 뒤, 정상적인 API 트래픽을 확인할 수 있도록 세션을 충분히 유지하세요.

ZimaSpace 가이드의 제어된 원격 접속 경로는 더 넓은 범위를 다룹니다. 프록시는 원격 접속의 한 계층일 뿐이므로 DNS, TLS, 인증, 비공개 업스트림을 모두 의도적으로 구성하고 관찰 가능하게 유지해야 합니다.

로그인이 프록시를 두 번 재시작한 뒤에도 유지되고, 전체 스택을 재시작한 후에도 동일한 설정이 문제없이 시작될 때만 통과로 판정하세요. 새 헤더 또는 쿠키 규칙으로 장애가 발생했다면 최근 프록시 변경 사항을 롤백하세요. 프록시 설정 diff, 요청 상태, 업스트림 오류, 서버 로그 타임스탬프, 직접 연결과 프록시 연결 테스트 결과를 첨부해 에스컬레이션하세요.

지원 및 팁

더 읽어보기

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.