클라우드플레어가 512MB 넘는 파일을 캐시하지 않을 때 BYPASS

먼저 결론

겪은 일: 클라우드플레어 R2 공개 주소로 내려주는 541,758,542바이트 설치 파일이 cf-cache-status: BYPASS 로 매번 원본에서 나갔고, 조각(Range) 요청이 가끔 200 으로 통째 왔습니다.

원인: Free, Pro, Business 요금제는 512MB(536,870,912바이트)를 넘는 파일을 캐시하지 않습니다. 파일이 한도를 약 5MB 넘었습니다.

이렇게 했다: 조각 받기 업데이트를 쓰는 설치본은 한도 아래로 두고, 캐시 상태는 HEAD 가 아니라 GET 으로 잽니다.

두 파일을 나란히 재 보니

데스크톱 앱 설치 파일을 R2 에 올려 공개 주소로 내려주고 있었습니다. 앱은 업데이트 때 파일 전체가 아니라 바뀐 조각만 받도록 되어 있어서, 조각 요청이 제대로 206 으로 오는지가 중요했습니다. 판마다 크기가 조금씩 달랐는데, 같은 방법으로 재도 결과가 크기에 따라 갈렸습니다.

파일 크기 cf-cache-status 조각 요청 응답
541,758,542바이트 (한도 넘음) 매번 BYPASS 대개 206, 가끔 200 으로 통째
512,409,232바이트 (한도 안) MISS 다음 HIT 첫 요청부터 206

200 으로 통째 온 것은 수십 분 동안 조각 요청이 없던 뒤의 첫 요청에서 두 번 보았습니다. 왜 그때만 그런지는 확인하지 못했습니다. 다만 한도 안 파일에서는 한 번도 보지 못했습니다.

한도는 요금제 문서에 있다

클라우드플레어 공식 문서 "Default cache behavior" 에는 Free, Pro, Business 고객의 캐시 한도가 512MB 라고 적혀 있습니다. Enterprise 만 5GB 입니다. EXE 는 기본으로 캐시하는 확장자인데도, 크기가 한도를 넘으면 확장자와 상관없이 캐시하지 않습니다.

바이트로 바꾸면 536,870,912입니다. 541,758,542바이트 파일은 이 선을 약 5MB 넘었고, 그래서 엣지가 매번 그냥 원본으로 넘겼습니다. BYPASS 는 "캐시를 찾았는데 없다"는 MISS 와 달리, 처음부터 캐시에 넣을 생각이 없다는 표시입니다. 몇 번을 받아도 HIT 으로 바뀌지 않습니다. 541MB 라고 부르면 넘는 줄 알아도, 판을 올리며 몇 MB 씩 커질 때는 놓치기 쉽습니다.

여러 조각을 한 번에 달라면 400

조각 요청에는 한 번에 여러 구간을 달라는 모양도 있습니다. R2 공개 주소는 이것을 400 으로 거절했습니다. 같은 요청을 직접 운영하는 nginx 에 보내면 206 multipart 로 잘 왔습니다.

curl -s -o /dev/null -w '%{http_code}\n' -H 'Range: bytes=0-9,5000-5009' https://files.example.com/app-setup.exe
# R2 공개 주소: 400
# 자체 nginx: 206 (multipart)

업데이트 도구 electron-updater 에는 여러 구간을 한 요청에 묶어 보내는 동작을 끄는 설정이 있습니다. 그래서 앱 설정에 useMultipleRangeRequest: false 를 넣어 구간마다 따로 요청하게 했습니다.

재는 법: HEAD 는 거짓말을 한다

처음에는 curl -I 로 머리만 보았습니다. 그러면 크기와 상관없이 늘 DYNAMIC 이 나와 "이 주소는 아예 캐시가 안 된다"고 잘못 읽게 됩니다. HEAD 가 캐시를 타지 않는 것이 클라우드플레어의 일반 규칙인지는 공식 문서로 확인하지 못했고, 이 주소에서 여러 번 본 결과입니다. 캐시 상태는 반드시 GET 으로 잽니다.

# 조각 GET 으로 캐시 상태와 응답 코드를 함께 본다
curl -s -r 1000-1009 -o /dev/null --max-time 3 -D - \
  -w '%{http_code} %{size_download}\n' https://files.example.com/app-setup.exe \
  | grep -iE 'cf-cache-status|^[0-9]{3} '

# 앞 1KB 만 GET
curl -r 0-1023 -D - -o /dev/null https://files.example.com/app-setup.exe

첫 명령은 10바이트만 받으므로 큰 파일도 부담 없이 여러 번 잴 수 있습니다. 끝 줄에 206 과 10 이 찍히면 조각 요청이 제대로 된 것이고, 200 과 큰 숫자가 찍히면 통째로 온 것입니다. 같은 주소를 두 번 재서 MISS 다음 HIT 이 나오면 캐시되는 파일입니다. curl 로 확인할 때 흔히 하는 다른 착각은 curl 로 라이브 반영을 확인할 때 저지른 실수에 정리했습니다.

한도 아래로 두었을 때 생기는 일

한도 아래 파일은 실제로 캐시됩니다. 그러면 판 번호 없는 같은 이름으로 새 판을 덮어쓸 때 한동안 옛 판이 나갈 수 있습니다. 이 문제와 올릴 때 붙이는 설정은 파일을 고쳤는데 옛 파일이 계속 보일 때에 적었으니 여기서는 되풀이하지 않습니다.

확인한 환경 값
저장소와 캐시 클라우드플레어 R2 공개 주소, 클라우드플레어 엣지 캐시
업데이트 도구 electron-updater (조각 받기)
잰 날 2026년 9월 14일

이 글의 내용은 2026년 10월 20일에 마지막으로 확인했습니다. 틀린 곳을 발견하시면 연락처로 알려 주세요.