인프라 · 플랫폼

Nginx

Nginx는 클라이언트 요청을 처리하거나 다른 애플리케이션 서버로 전달하는 웹 서버입니다. 오류를 확인할 때는 Nginx 응답과 업스트림 애플리케이션 응답을 구분해야 합니다.

적용 범위: Nginx의 공개 기능과 본문에 적은 설정·운영 조건
출처: NGINX
출처 확인일: 2026-07-27
최종 검토: 2026-07-27
정정 이력: 2026-07-29 이후 기록 없음

오류·수정 제보

플랫폼 정의

Nginx는 정적 파일을 제공하거나 클라이언트 요청을 애플리케이션 서버로 전달하는 웹 서버입니다. Nginx에서 만든 오류 응답과 업스트림 애플리케이션이 반환한 응답을 먼저 구분해야 합니다.

확인할 범위

요청이 Nginx까지 도달했는지
server와 location 설정이 대상 호스트·경로에 적용되는지
역방향 프록시의 업스트림 주소와 연결 결과
Nginx 오류 로그와 업스트림 애플리케이션 로그의 같은 시각 기록

Nginx 설정을 변경하기 전에는 현재 설정과 되돌리기 방법을 보관합니다. 인증서 검증 우회나 방화벽 전체 허용을 기본 조치로 사용하지 않습니다.

자주 발생하는 오류·증상

413 (Request Entity Too Large)

nginx.org 공식 원문에 표시된 413 (Request Entity Too Large) 항목의 문구를 확인하는 문서입니다.

and 1 minute for responses with code 404.

nginx 공식 원문에 표시된 and 1 minute for responses with code 404. 항목의 문구를 확인하는 문서입니다.

and, if not found, is determined using a

nginx 공식 원문에 표시된 and, if not found, is determined using a 항목의 문구를 확인하는 문서입니다.

cannot be selected.

nginx 공식 원문에 표시된 cannot be selected. 항목의 문구를 확인하는 문서입니다.

client intended to send too large body: 1441104 bytes

NGINX 유지보수자 Trac 공식 원문에 표시된 client intended to send too large body: 1441104 bytes 항목의 문구를 확인하는 문서입니다.

denied |

nginx 공식 원문에 표시된 denied | 항목의 문구를 확인하는 문서입니다.

denied and

nginx 공식 원문에 표시된 denied and 항목의 문구를 확인하는 문서입니다.

“digest check failed”

nginx 공식 원문에 표시된 “digest check failed” 항목의 문구를 확인하는 문서입니다.

Enables revalidation of expired cache items using conditional requests with

nginx 공식 원문에 표시된 Enables revalidation of expired cache items using conditional requests with 항목의 문구를 확인하는 문서입니다.

error_page 404 = @fetch;

nginx 공식 원문에 표시된 error_page 404 = @fetch; 항목의 문구를 확인하는 문서입니다.

error_page 404 = /fetch$uri;

nginx 공식 원문에 표시된 error_page 404 = /fetch$uri; 항목의 문구를 확인하는 문서입니다.

502 Bad Gateway

`502 Bad Gateway`는 프록시 또는 게이트웨이가 업스트림 서버에서 유효하지 않은 응답을 받았을 때 표시됩니다. 오류 화면의 Cloudflare 브랜딩과 같은 시각의 프록시·원본 로그를 구분해 확인합니다.

is allowed or denied.

nginx 공식 원문에 표시된 is allowed or denied. 항목의 문구를 확인하는 문서입니다.

Permits passing otherwise disabled header

nginx 공식 원문에 표시된 Permits passing otherwise disabled header 항목의 문구를 확인하는 문서입니다.

proxy_cache_valid 404 1m;

nginx 공식 원문에 표시된 proxy_cache_valid 404 1m; 항목의 문구를 확인하는 문서입니다.

proxy_headers_hash_max_size 512;

nginx 공식 원문에 표시된 proxy_headers_hash_max_size 512; 항목의 문구를 확인하는 문서입니다.

proxy_next_upstream error timeout;

nginx 공식 원문에 표시된 proxy_next_upstream error timeout; 항목의 문구를 확인하는 문서입니다.

Sets a timeout for proxy_cache_lock.

nginx 공식 원문에 표시된 Sets a timeout for proxy_cache_lock. 항목의 문구를 확인하는 문서입니다.

Specifies a file with revoked certificates (CRL)

nginx 공식 원문에 표시된 Specifies a file with revoked certificates (CRL) 항목의 문구를 확인하는 문서입니다.

to update an expired cache item,

nginx 공식 원문에 표시된 to update an expired cache item, 항목의 문구를 확인하는 문서입니다.

참고 자료

NGINX Documentation

NGINX · 공식 자료 · 확인 범위: web-server, reverse-proxy, http-request-processing · 확인일: 2026-07-27

플랫폼 정의

확인할 범위

관련 기술

CDN

HTTP Status Code

자주 발생하는 오류·증상

413 (Request Entity Too Large)

and 1 minute for responses with code 404.

and, if not found, is determined using a

cannot be selected.

client intended to send too large body: 1441104 bytes

denied |

denied and

“digest check failed”

Enables revalidation of expired cache items using conditional requests with

error_page 404 = @fetch;

error_page 404 = /fetch$uri;

502 Bad Gateway

is allowed or denied.

Permits passing otherwise disabled header

proxy_cache_valid 404 1m;

proxy_headers_hash_max_size 512;

proxy_next_upstream error timeout;

Sets a timeout for proxy_cache_lock.

Specifies a file with revoked certificates (CRL)

to update an expired cache item,

관련 체크리스트

Nginx 분석 태그 운영 확인표

Nginx 데이터베이스 연결 운영 확인표

Nginx DNS 레코드 운영 확인표

Nginx 파일 업로드 운영 확인표

Nginx 로그인·세션 운영 확인표

Nginx 메일 발송·수신 운영 확인표

Nginx 파일 권한 운영 확인표

Nginx 리디렉션 운영 확인표

Nginx 런타임 버전 운영 확인표

Nginx 검색 색인 운영 확인표

Nginx SSL·도메인 운영 확인표

참고 자료

최근 검토된 문서

502 Bad Gateway

413 (Request Entity Too Large)

client intended to send too large body: 1441104 bytes

Nginx 분석 태그 운영 확인표

Nginx 데이터베이스 연결 운영 확인표