• 홈페이지
  • 조항
  • 가이드
  • CDN은 GZIP을 제거하고 파일 이름에 mojibake를 생성하고 손상된 다운로드를 수정하는 문자 세트 헤더 적용을 생성했습니다.

CDN은 GZIP을 제거하고 파일 이름에 mojibake를 생성하고 손상된 다운로드를 수정하는 문자 세트 헤더 적용을 생성했습니다.

게시 됨: 2025-11-21

대규모 웹사이트가 콘텐츠를 안정적이고 효율적으로 전달하기 위해 글로벌 인프라에 의존하는 경우 CDN(콘텐츠 전송 네트워크)이 중요한 역할을 합니다. CDN은 단순히 사용자에게 더 가까운 자산을 캐싱하는 것 외에도 파일 압축, 다운로드 가속화 및 사용자 경험 개선을 지원합니다. 그러나 특정 조건에서는 실수로 새로운 문제가 발생할 수 있습니다. 그러한 사건 중 하나는 GZIP 압축 및 문자 집합을 잘못 처리하여 다운로드가 손상되고 파일 이름에 mojibake(깨진 텍스트)가 발생하는 것과 관련이 있었습니다. 이는 개발자와 운영자 모두에게 어려운 현상이었습니다.

핵심요약: CDN 서비스의 잘못된 구성으로 인해 다운로드 가능한 파일에서 GZIP 압축 헤더가 제거되고 파일 이름의 문자 인코딩이 잘못 이해되었습니다. 이로 인해 파일 이름이 손상되었거나 읽을 수 없는 다운로드(mojibake)가 발생했습니다. 이 문제는 HTTP 헤더에 올바른 charset 강제 적용하여 파일 이름 인코딩과 콘텐츠가 모두 브라우저에서 올바르게 해석되도록 함으로써 궁극적으로 해결되었습니다. 이 사례는 특히 HTTP 헤더를 수정할 수 있는 CDN을 사용할 때 콘텐츠 인코딩의 일관성이 중요함을 강조합니다.

무엇이 잘못됐나요? 압축 관리가 잘못됐나요?

문제의 핵심은 CDN의 Content-Encoding 헤더에 대한 부적절한 처리였습니다. 원본 서버는 GZIP을 사용하여 파일을 올바르게 압축하고 다음 헤더로 레이블을 지정했습니다.

 Content-Encoding: gzip

그러나 전송 최적화를 목적으로 하는 CDN은 이 헤더를 제거하고 콘텐츠를 압축되지 않은 것처럼 제공하기로 결정했습니다. 이는 CSS 또는 JavaScript와 같은 원시 파일을 기대하는 브라우저에서는 제대로 작동했지만 사용자가 CSV, PDF 또는 ZIP 아카이브와 같은 파일을 다운로드하려고 하면 손상된 다운로드를 받았습니다. 이러한 파일의 압축을 풀면 완전히 실패하거나 읽을 수 없거나 불완전한 것처럼 보이는 데이터가 생성됩니다.

바이너리 손상 외에도 훨씬 더 신비한 문제가 나타났습니다. 특히 Chrome이나 Firefox와 같은 브라우저를 사용하여 다운로드할 때 일부 파일 이름이 이상한 기호로 왜곡되어 나타났습니다. 이 현상을 mojibake 라고 하며 프로그램이 의도하지 않은 문자 인코딩을 사용하여 일련의 바이트를 해석할 때 발생합니다.

문자 인코딩의 혼란

다운로드한 파일 이름의 Mojibake는 일반적으로 다음과 같은 경우에 발생합니다.

  • 파일 이름에 ASCII가 아닌 문자(예: 악센트 문자 또는 아시아 스크립트)가 포함되어 있습니다.
  • 브라우저는 어떤 문자 세트를 사용해야 할지 모릅니다.
  • Content-Disposition 또는 Content-Type 헤더에 적절한 문자 세트 선언이 부족합니다.

잘못 추측한 브라우저는 ISO-8859-1과 같은 기본 또는 대체 인코딩을 사용하여 파일 이름을 해석하려고 시도하므로 읽을 수 있는 문자 대신 횡설수설이 발생합니다. 이는 일반적으로 특수 문자가 널리 사용되는 일본어, 러시아어 또는 독일어와 같은 언어로 된 파일 이름을 가진 파일을 다운로드하는 사용자에게 영향을 미칩니다.

원래 개발자는 애플리케이션 서버에서 다음과 같은 적절한 헤더를 설정했습니다.

 Content-Type: application/octet-stream; charset=utf-8 Content-Disposition: attachment; filename="resume.pdf"

그러나 이번에도 CDN은 이러한 헤더를 제거하거나 교체하여 이러한 헤더를 변경하여 문자 세트 힌트 없이 다운로드하게 되었습니다. 파일 이름이 잘못된 인코딩으로 해석되었기 때문에 이로 인해 잘못된 브라우저 동작이 발생했습니다.

수정 사항: HTTP 헤더에 문자 집합 적용

많은 디버깅과 로그 추적 후에 개발자는 다음을 확인했습니다.

  • 원본 서버에서는 파일이 손상되지 않았습니다.
  • 컬 및 직접 IP 액세스를 통해 다운로드가 성공했습니다.
  • 문제는 CDN을 통해 제공될 때만 발생했습니다.

따라서 적절한 솔루션은 두 가지였습니다.

  1. 브라우저가 GZIP 콘텐츠를 올바르게 수신하고 압축을 풀 수 있도록 CDN에서 Content-Encoding 헤더를 유지하도록 강제합니다.
  2. 적절한 국제 파일 이름 디코딩을 보장하려면 Content-Type 과 Content-Disposition 헤더 모두에 명시적인 charset 설정하십시오.

최종 작업 헤더 구성은 다음과 같습니다.

 Content-Type: application/octet-stream; charset=utf-8 Content-Disposition: attachment; filename*=UTF-8''r%C3%A9sum%C3%A9.pdf Content-Encoding: gzip

UTF-8'' URL 인코딩 구문과 함께 filename* 사용하면 브라우저가 RFC 5987에 따라 파일 이름을 해석할 수 있습니다. 이는 특히 크로스 플랫폼 동작을 조정하는 최신 브라우저에서 지원됩니다.

CDN이 헤더를 변경하는 이유

CDN은 성능 최적화, 중복성 감소, 응답 표준화를 목표로 하는 경우가 많습니다. 이를 위해 그들은 다음을 수행할 수 있습니다.

  • 압축 지시어 제거 또는 교체
  • 콘텐츠 유형 표준화
  • 보안 필터나 캐싱 규칙을 통과하지 못하는 헤더를 제거하세요.

그러나 이러한 최적화는 콘텐츠 렌더링이나 파일 다운로드에 중요하게 설정된 신중하게 설정된 매개변수를 재정의할 때 역효과를 낳을 수 있습니다. 이 사건에서 CDN이 올바른 Content-Encoding 및 charset 유지하지 못한 것은 유용성과 국제화 모두에 해로운 것으로 입증되었습니다.

배운 교훈

이 문제는 분산 환경에서 작업하는 개발자에게 다음과 같은 중요한 알림을 제공합니다.

  • 항상 콘텐츠 전달을 처음부터 끝까지 테스트하세요. 서버에서 작동하는 파일은 CDN 뒤에서 다르게 동작할 수 있습니다.
  • 헤더에 명시적으로 작성하세요. 기본 동작에 대해 아무 것도 가정하지 마십시오. 항상 콘텐츠 유형, 인코딩 및 문자 집합을 선언하십시오.
  • 구성을 통해 CDN 동작을 제어합니다. 대부분의 CDN에서는 헤더를 보존하기 위한 재정의 또는 규칙을 허용합니다. 그것들을 활용하세요.
  • 여러 브라우저 및 로캘에서 다운로드 동작을 확인합니다. 국제화 버그는 종종 이러한 조건에서만 나타납니다.

FAQ

모지바케란?

Mojibake는 문자 인코딩 불일치로 인해 문자가 왜곡되거나 잘못 표시되는 현상을 설명하는 데 사용되는 용어입니다. 소프트웨어가 텍스트 데이터를 저장하거나 보내는 데 사용되는 문자 인코딩을 잘못 해석할 때 종종 발생합니다.

gzip은 파일 다운로드에 어떤 영향을 미치나요?

올바르게 사용하면 GZIP은 파일을 압축하여 다운로드 시간을 줄입니다. 그러나 적절한 Content-Encoding: gzip 헤더가 없는 상태에서 파일이 GZIP 압축으로 제공되는 경우 브라우저가 파일의 압축을 풀지 못해 다운로드가 손상되거나 읽을 수 없게 될 수 있습니다.

CDN 스트립 헤더가 Content-Encoding 또는 charset과 같은 이유는 무엇입니까?

CDN은 성능과 보안을 우선시합니다. 그렇게 하면서 헤더를 정규화하거나 잠재적으로 안전하지 않거나 불필요한 정보를 제거하는 정책을 적용하는 경우가 많습니다. 이로 인해 올바른 콘텐츠 처리에 필요한 중요한 메타데이터가 실수로 제거될 수 있습니다.

다운로드 시 ASCII가 아닌 파일 이름을 지정하는 올바른 방법은 무엇입니까?

RFC 5987에 지정된 대로 UTF-8 인코딩 및 백분율 이스케이프 형식을 사용하여 filename* 속성과 함께 Content-Disposition 헤더를 사용합니다. 예:

Content-Disposition: attachment; filename*=UTF-8''r%C3%A9sum%C3%A9.pdf

개발자는 앞으로 이러한 문제를 어떻게 방지할 수 있습니까?

CDN 계층을 통해 테스트를 수행하고, 헤더를 명시적으로 지정하고, 필요한 모든 메타데이터를 보존하거나 전달하는 CDN 구성을 사용해야 합니다. 또한 디버깅 단계에서 CDN이 트래픽을 변경하는 방법에 대한 문서를 유지하는 것이 필수적입니다.