chimurai/http-proxy-middleware

Node.js에서 HTTP 요청을 쉽게 다른 서버로 전달하는 미들웨어

개발 재료맘대로 써도 됨 · MIT웹·Next.js·풀스택난이도
11,131+0이번 주87924TypeScript
중간맛 분석

TypeScript로 작성된 경량 프록시 미들웨어입니다. Express, Next.js, Hono, Fastify, Polka 등 주요 Node.js 프레임워크를 지원하며, 설정만으로 경로 재작성, 동적 라우팅, WebSocket 프록싱이 가능합니다. 내부적으로 유지보수되는 httpxy 라이브러리를 기반하여 안정성이 높습니다. 플러그인 시스템으로 요청/응답 가로채기도 간단하게 구현할 수 있으며, 개발 서버에서 서버를 따로 실행할 때 유용합니다.

이런 레포예요

이럴 때 쓰면 좋아요

  • 개발 중 별도 백엔드 서버의 API를 로컬 프론트엔드에서 호출할 때
  • 마이크로서비스 환경에서 API 게이트웨이 역할 수행
  • 기존 API의 경로를 변경하거나 요청을 동적으로 라우팅할 때

핵심 기능

경로별 프록시 필터링 (pathFilter)URL 경로 재작성 (pathRewrite) 및 동적 라우팅 (router)요청/응답 가로채기 및 조작 가능한 플러그인 시스템

대안 대비 차별점

TypeScript 완전 지원과 함께 Express, Next.js, Hono, Fastify 등 다양한 프레임워크를 하나의 라이브러리로 지원하며, 유지보수되는 httpxy 기반으로 안정성이 보장됩니다.

준비물
  • Node.js
바로 시작하기
  1. npm에서 http-proxy-middleware 설치
npm install --save-dev http-proxy-middleware
  1. Express 앱에서 프록시 미들웨어 생성 및 마운트
import express from 'express';
import { createProxyMiddleware } from 'http-proxy-middleware';

const app = express();

const apiProxy = createProxyMiddleware({
  target: 'http://www.example.org/api',
  changeOrigin: true,
});

app.use('/api', apiProxy);
app.listen(3000);
  1. 서버 실행 후 테스트
node app.js
  1. 프록시 확인 (http://127.0.0.1:3000/api/foo/bar는 http://www.example.org/api/foo/bar로 전달됨)
별 추이 · 7일
11,131+0 / 7일
활용성 · 따라 만들기 좋은가
따라 하기 좋음샘플 점수 50/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2015년 생성

AI가 README 기반으로 요약했습니다 · 원문 보기