대용량 사진 및 동영상 업로드에 맞게 리버스 프록시 시간 제한을 설정하는 방법

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

허용할 가장 느린 정상 업로드를 기준으로 여유를 두고 프록시 타임아웃을 설정하고, 애플리케이션과 모든 업스트림 프록시의 허용 범위도 최소한 그만큼으로 설정하세요. 업로드 실패를 전부 타임아웃 무제한 설정으로 해결하려고 하지 마세요.

요청 본문, 업스트림 처리 또는 응답이 서로 다른 제한에 걸리면 큰 사진이나 동영상의 업로드에 실패해도 같은 앱이 평소처럼 작동할 수 있습니다. 먼저 상태 코드, 경과 시간, 파일 크기, 프록시 로그를 수집하세요. 이 정보를 통해 본문 크기 초과 거부인지, 유휴 타임아웃인지, 백엔드 타임아웃인지, 클라이언트 연결 해제인지 구분할 수 있습니다.

업로드를 종료시키는 단계 파악

확인된 파일 하나로 다시 테스트하고 전송 중, 진행률 표시줄이 100퍼센트에 도달한 뒤, 또는 서버가 미디어를 처리하는 동안 중 언제 실패하는지 기록하세요. 단계마다 해당되는 연결과 타임아웃이 다릅니다.

항상 같은 바이트 수에서 실패한다면 본문 크기 제한일 가능성이 높고, 같은 유휴 시간 후에 실패한다면 타임아웃일 가능성이 높습니다. 업로드 완료 후 게이트웨이 오류가 발생하면 프록시에서 애플리케이션으로 전달되는 대기 시간이나 애플리케이션 자체의 처리 제한을 살펴보세요.

프록시 액세스 로그와 오류 로그를 애플리케이션 로그와 함께 확인하세요. 클라이언트가 먼저 연결을 종료했다면 프록시 타임아웃만 늘려서는 해결되지 않습니다. 모바일 백그라운드 동작, VPN 안정성, 브라우저의 요청 경로를 확인하세요.

타당한 타임아웃 예산 측정

허용할 최대 파일 크기를 지원되는 가장 느린 업스트림 속도로 나누어 전송 시간을 추정한 다음, TLS, 버퍼링, 가변적인 처리량을 고려해 여유를 더하세요. 이를 정상적인 작업에 허용할 최대 시간으로 사용하되, 연결이 느리다는 이유만으로 연결을 무기한 유지해야 한다는 뜻은 아닙니다.

전체 소요 시간과 유휴 시간을 구분하세요. 예를 들어 NGINX는 서로 다른 프록시 타임아웃 지시어를 문서화하고 있으며, 일부 지시어는 전체 응답 시간 대신 연속된 작업 사이의 간격을 측정합니다.

서비스 거부 공격 위험도 고려하세요. 연결 유지 시간을 크게 늘리기 전에 인증과 속도 제한을 통해 업로드 엔드포인트를 보호하고, 프록시의 관리 인터페이스를 외부에 노출하지 마세요.

과도하게 수정하지 않으면서 모든 계층을 맞추세요

요청 본문 크기를 애플리케이션이 지원하는 최대 크기 이상으로 설정하세요. 그런 다음 관찰된 실패 단계에 맞춰 클라이언트 본문, 업스트림 연결, 업스트림 읽기, 업스트림 전송 타임아웃을 조정하세요.

더 짧고 변경할 수 없는 제한이 적용되는 외부 CDN, 터널, 로드 밸런서 또는 두 번째 리버스 프록시가 있는지 확인하세요. 실제 제한은 경로에 있는 제한 중 가장 작은 값이므로 내부 프록시만 변경해도 눈에 띄는 결과가 없을 수 있습니다.

애플리케이션 URL과 프록시 경로를 문서화해 두세요. 네트워크 공유에서 Immich 사용하기에 관한 ZimaSpace 가이드는 업로드 경로 오류와 저장소 마운트 지연 및 중단을 구분하는 데 도움이 됩니다.

느리거나 용량이 크거나 중단된 업로드를 다시 테스트하세요

처음 실패한 파일을 원래 위치에서 원래 네트워크 속도로 업로드하세요. 업로드가 완료되고 애플리케이션에서 색인이 생성되며 파일을 재생하거나 볼 수 있어야 성공입니다. HTTP 성공 코드만으로는 충분하지 않습니다.

테스트 연결 속도를 지원되는 최저 속도로 제한해 다시 시도하세요. 그런 다음 업로드를 의도적으로 한 번 중단하세요. 임시 파일과 미완료 데이터베이스 레코드는 애플리케이션 동작에 따라 정리되어야 합니다.

로그에 백엔드 충돌, 저장소 오류 또는 변경할 수 없는 외부 제공업체의 제한이 표시되면 타임아웃을 더 늘리지 마세요. 지나치게 큰 값을 되돌리고, 문제가 발생한 계층을 수정한 뒤, 측정된 작업량을 안정적으로 처리할 수 있는 최소 타임아웃을 유지하세요.

FAQ

모든 프록시 타임아웃을 같은 값으로 설정해야 하나요? 아니요. 연결 설정, 클라이언트 본문 읽기, 업스트림 응답 대기, 다운스트림 전송은 서로 다른 단계를 보호합니다.

작은 사진은 업로드되는데 동영상은 왜 실패하나요? 동영상이 본문 크기 한도를 넘거나, 유휴 제한 시간보다 오래 걸리거나, 서버 측 처리 시간이 길어질 수 있습니다. 로그와 실패 시점을 확인하면 원인을 파악할 수 있습니다.

지원 및 팁

더 읽어보기

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.