Cloudflare Error 520 오류 원인과 해결 방법

Cloudflare Error 520이란?

Error 520은 Cloudflare 고유의 상태 코드 중 하나입니다. 오류 페이지에는 "Web server is returning an unknown error"(웹 서버가 알 수 없는 오류를 반환하고 있음)라는 문구와 Error code 520, Ray ID, 그리고 세 개의 상자가 표시됩니다. 브라우저(정상), Cloudflare(정상), 호스트(오류)입니다.

Cloudflare 문서는 이를 "the origin server returns an empty, unknown, or unexpected response to Cloudflare", 즉 원본 서버가 Cloudflare에 비어 있거나, 알 수 없거나, 예상치 못한 응답을 반환한 경우로 정의합니다. 다시 말해 Cloudflare는 웹사이트의 실제 서버(원본 서버, origin)에 연결했지만, 돌아온 응답이 그대로 전달할 수 있는 유효한 HTTP 응답이 아니었던 것입니다. 상태 코드가 없거나, 빈 응답이거나, 연결이 리셋되었거나, 해석할 수 없는 내용인 경우입니다.

520은 포괄적인 오류 코드입니다. Cloudflare는 무엇이 잘못되었는지 알 수 있을 때(연결 거부, 시간 초과, SSL 실패) 더 구체적인 코드를 사용하므로, 520은 원본 서버가 Cloudflare가 분류할 수 없는 방식으로 응답했다는 뜻입니다.

Error 520과 521, 522, 523, 524, 525, 526 비교

Cloudflare의 52x 코드는 모두 Cloudflare와 원본 서버 사이의 문제를 나타냅니다. 번호를 보면 어디를 확인해야 할지 알 수 있습니다:

페이지에 일반적인 502나 504가 표시된다면 502 Bad Gateway와 504 Gateway Timeout을 참고하세요. 521과 522는 포트 확인 도구로 원본 서버의 443 또는 80 포트가 외부 연결을 받는지 확인하세요. 525와 526은 SSL 인증서 확인 도구로 원본 인증서를 확인할 수 있고, TLS 버전과 암호화 방식 문제는 ERR_SSL_VERSION_OR_CIPHER_MISMATCH에서 다룹니다.

520 오류의 원인

Cloudflare는 문제 해결 문서에서 다음 원인을 제시합니다:

• 원본 서버의 크래시 또는 잘못된 설정. 예를 들어 요청 처리 도중 죽는 PHP나 Node 프로세스입니다.

• 방화벽이나 보안 플러그인이 Cloudflare IP를 차단하는 경우. 원본 서버가 응답하는 대신 연결을 끊어 버립니다.

• 응답 헤더가 128KB를 초과하는 경우. 대개 쿠키가 너무 많거나 너무 크기 때문입니다.

• 비어 있거나 형식이 잘못된 응답. HTTP 상태 코드나 본문이 없는 경우입니다.

• 응답 헤더 누락, 또는 원본 서버가 올바른 HTTP 오류 응답을 반환하지 않는 경우.

• HTTP/2 to Origin이 켜져 있을 때 원본 서버의 잘못된 HTTP/2 설정.

• 원본 서버가 준비되지 않았는데 Cloudflare에서 Authenticated Origin Pulls를 켠 경우.

방문자라면 이렇게 해 보세요

웹사이트의 서버를 고칠 수는 없지만 시도해 볼 만한 방법이 두 가지 있습니다. 크래시나 재시작으로 생긴 520은 저절로 사라지기도 하므로 1분쯤 뒤에 새로고침하세요. 그리고 사이트 쿠키를 삭제하세요. 쿠키로 인해 헤더가 너무 커진 것이 원인이라면, 해당 사이트의 쿠키를 지우면(주소창 왼쪽 아이콘 → 쿠키 및 사이트 데이터) 내 쪽에서는 해결될 수 있습니다.

계속 실패한다면 사이트 운영자에게 알리고, 오류 페이지 하단의 Ray ID를 함께 보내세요. 운영자가 Cloudflare에서 내 요청을 정확히 찾을 수 있습니다.

해결 방법 1: 원본 서버의 오류 로그 확인

Cloudflare가 가장 먼저 권하는 방법은 오류가 발생한 시각의 원본 서버 로그를 확인하는 것입니다. 크래시, 메모리 부족(OOM) 종료, 연결 리셋이 로그에 남습니다:

sudo tail -n 50 /var/log/nginx/error.log      # 또는 /var/log/apache2/error.log
journalctl -u your-app --since "15 min ago"     # 앱 서비스 로그
pm2 logs --lines 50                             # PM2로 실행 중인 Node 앱
dmesg -T | grep -i "killed process"           # 메모리 부족(OOM) 종료

해결 방법 2: Cloudflare 없이 원본 서버 테스트

Cloudflare를 거치지 않고 원본 서버에서 페이지를 직접 요청해 원시 응답을 확인하세요. curl을 사용하면 요청 한 번에 한해 호스트 이름을 원본 IP로 지정할 수 있습니다:

# 203.0.113.10을 내 원본 서버의 IP로 바꾸세요
curl -sv --resolve example.com:443:203.0.113.10 https://example.com/broken-page -o /dev/null

# 확인할 것: 정상적인 "HTTP/1.1 200"(또는 HTTP/2 200) 상태 줄과 헤더
# 여기서 "Empty reply from server"나 "Connection reset by peer"가 나오면 520이 재현된 것입니다.

Cloudflare는 임시 해결책도 제안합니다. DNS 레코드를 DNS 전용(DNS only, 회색 구름)으로 바꾸거나 Cloudflare를 일시 중지해, 원인을 조사하는 동안 방문자가 원본 서버에 직접 접속하도록 하는 것입니다. 이 경우 원본 IP가 노출된다는 점을 기억하세요. DNS Robot의 DNS 조회는 현재 전 세계에서 내 도메인에 대해 보이는 IP를 보여 주고, HTTP 헤더 확인 도구는 트래픽이 Cloudflare를 거칠 때 server: cloudflare와 cf-ray 헤더를 보여 줍니다.

해결 방법 3: 원본 서버에서 Cloudflare IP 대역 허용

모든 방문자 트래픽은 Cloudflare의 IP 대역에서 원본 서버로 들어오므로, '의심스러운' IP의 속도를 제한하거나 차단하는 방화벽, fail2ban jail, 보안 플러그인이 결국 Cloudflare 자체를 차단할 수 있습니다. https://www.cloudflare.com/ips/에 공개된 대역을 방화벽과 보안 플러그인에서 허용하고, 웹 서버가 CF-Connecting-IP 헤더에서 실제 방문자 IP를 읽도록 설정해 속도 제한이 Cloudflare가 아니라 방문자에게 적용되도록 하세요.

해결 방법 4: 응답 헤더를 128KB 미만으로 유지

Cloudflare는 헤더가 128KB를 넘는 원본 응답을 거부하며, 대개 쿠키가 원인입니다. 페이지가 보내는 Set-Cookie 헤더의 개수와 크기를 확인하세요. 더 이상 필요 없는 쿠키는 제거하고, 세션 쿠키는 작게 유지하고, 쿠키에 큰 데이터를 기록하는 앱이나 플러그인은 피하세요.

해결 방법 5: HTTP/2 to Origin과 Authenticated Origin Pulls 확인

• HTTP/2 to Origin: Cloudflare에서(속도 설정 아래) 이 기능이 켜져 있는데 원본 서버의 HTTP/2 설정이 잘못되어 있으면 응답이 520으로 실패할 수 있습니다. Cloudflare는 원본 서버의 HTTP/2 구성을 확인하거나, HTTP/2 to Origin을 꺼서 원인인지 확인해 보라고 권합니다.

• Authenticated Origin Pulls: Cloudflare에서 이 기능이 켜져 있다면 원본 서버가 Cloudflare의 클라이언트 인증서를 받아들이도록 설정되어 있어야 합니다. 그렇지 않다면 기능을 끄거나 원본 서버 설정을 마무리하세요.

해결 방법 6: Cloudflare 지원팀에 보낼 정보

원본 서버가 정상으로 보이는데 520이 계속된다면, Cloudflare는 다음 정보를 요청합니다:

• 오류가 발생하는 전체 URL.

• 오류 페이지의 cf-ray ID.

• http://yourdomain.com/cdn-cgi/trace의 출력 결과.

• HAR 파일 두 개(개발자 도구 → 네트워크 → 내보내기). 하나는 Cloudflare를 켠 상태, 다른 하나는 끈 상태에서 기록한 것.