🗜️ NestJS Compression – 응답 속도 향상을 위한 압축 전략 완벽 가이드

🗜️ NestJS Compression – 응답 속도 향상을 위한 압축 전략 완벽 가이드

---

웹 서비스의 응답 속도는 사용자 경험과 SEO에 직접적인 영향을 미칩니다.
NestJS는 compression 미들웨어를 통해 모든 HTTP 응답을 gzip, deflate 등으로 압축하여 전송할 수 있습니다.

이번 글은 NestJS 공식 문서 Compression을 기반으로
gzip 압축 설정, 조건부 압축 처리, 실무 적용 전략까지 완전 정복해보겠습니다.

---

✅ 1. compression 미들웨어 설치

npm install compression

---

✅ 2. 전역 압축 설정 (main.ts)

// main.ts
import * as compression from 'compression';

const app = await NestFactory.create(AppModule);
app.use(compression());
await app.listen(3000);

☑️ 설정 후 모든 HTTP 응답이 압축되어 클라이언트로 전송됩니다.
☑️ 클라이언트가 Accept-Encoding: gzip 헤더를 보내야 적용됩니다.

---

 

반응형

✅ 3. 압축 옵션 조정

app.use(
  compression({
    level: 6,              // 압축 수준 (0~9)
    threshold: 1024,       // 최소 크기 이상일 때만 압축 (1KB)
    filter: (req, res) => {
      if (req.headers['x-no-compress']) {
        return false; // 조건에 따라 압축 비활성화
      }
      return compression.filter(req, res);
    },
  }),
);

주요 옵션 정리

옵션 설명

level	압축 레벨 (0=무압축 ~ 9=최대압축)
threshold	지정된 크기 이상에서만 압축 수행
filter	요청별 압축 여부를 조건부로 설정 가능

---

✅ 4. 적용 확인 방법

• 클라이언트에서 요청 시 Accept-Encoding: gzip 헤더 포함
• 응답 헤더에 Content-Encoding: gzip 확인
• 브라우저 DevTools > Network > Size 탭에서 확인 가능

---

✅ 5. 실무 적용 팁

• 정적 리소스는 웹 서버(Nginx 등) 또는 CDN 압축이 더 효율적
• JSON 응답, HTML, 텍스트 리소스에 가장 큰 압축 효과
• SSR 환경에서 압축은 TTFB 영향을 줄 수 있으니 레벨을 조정해야 함

---

🧠 성능 비교 예시

응답 데이터 압축 전 (크기) 압축 후 (gzip) 절감율

100KB JSON	100KB	18KB	-82%
HTML 텍스트	50KB	9KB	-82%
이미지(PNG)	200KB	200KB (변화 없음)	0%

☑️ 이미지, 비디오 등은 이미 압축된 포맷이라 다시 압축해도 효과 없음

---

 

NestJS Compression,NestJS 응답 압축,NestJS gzip 설정,NestJS 성능 최적화,NestJS compression 미들웨어,NestJS 응답속도 개선,NestJS HTTP 압축,NestJS 브라우저 압축 적용,NestJS threshold 설정,NestJS 실무 압축 전략

---