spring-cloud/spring-cloud-gateway

어떤 프로젝트인가요?

핵심 기능

• 01경로, 메서드, 헤더, 호스트 및 기타 요청 속성을 기준으로 라우트 매칭
• 02일치하는 개별 라우트에만 적용되는 필터
• 03요청 및 응답의 헤더, 파라미터, 경로를 수정하는 필터
• 04내장 필터를 통한 서킷 브레이커 지원
• 05API나 설정으로 라우트를 구성하거나 Spring Cloud DiscoveryClient에서 가져오기

활용 사례

• 여러 Spring Boot 마이크로서비스 앞단의 요청 라우팅
• 요청이 백엔드 서비스에 도달하기 전에 헤더와 경로 추가 또는 변경
• 서비스 디스커버리를 연동해 등록된 서비스에 따라 라우트 관리

빠른 시작

1. 1

   프로젝트 저장소를 클론합니다

2. 2

   JDK 17을 설치하고 Maven Wrapper로 소스를 빌드합니다

   ./mvnw install

사용 전 알아둘 점

• !빌드하려면 JDK 17이 필요합니다.
• !일부 테스트를 실행하려면 로컬에서 Docker가 실행 중이어야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

spring-cloud-gateway은(는) 무엇인가요?

마이크로서비스 환경에서 HTTP 요청을 라우팅하고 필터링하는 Spring Framework 및 Spring Boot 기반 API 게이트웨이입니다. Spring Cloud Gateway는 Spring Framework 6과 Spring Boot 3을 기반으로 하고 Java 17에서 실행되는 Java 애플리케이션용 API 게이트웨이입니다. 백엔드 서비스 앞단에서 들어오는 HTTP 요청을 받아 경로, HTTP 메서드, 헤더, 호스트 등의 일치 규칙에 따라 서비스로 라우팅합니다.

spring-cloud-gateway은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

spring-cloud-gateway은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

spring-cloud-gateway은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. spring-cloud-gateway의 마지막 커밋은 2026년 11월 6일입니다.

spring-cloud-gateway은(는) 어디에 사용할 수 있나요?

여러 Spring Boot 마이크로서비스 앞단의 요청 라우팅 요청이 백엔드 서비스에 도달하기 전에 헤더와 경로 추가 또는 변경 서비스 디스커버리를 연동해 등록된 서비스에 따라 라우트 관리

spring-cloud-gateway는 어떻게 설치하나요?

프로젝트 저장소를 클론합니다 JDK 17을 설치하고 Maven Wrapper로 소스를 빌드합니다: ./mvnw install

spring-cloud-gateway은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/spring-cloud/spring-cloud-gateway