Repolode
spring-cloud

spring-cloud/spring-cloud-gateway

API-шлюз на Spring Framework и Spring Boot для маршрутизации и фильтрации HTTP-запросов в микросервисных системах.

Звёзды
4,919
Форки
3,481
Открытые issues
565
Последний коммит
23 часа назад

Что это?

Spring Cloud Gateway — API-шлюз для Java-приложений на Spring Framework 6 и Spring Boot 3, работающий на Java 17. Он располагается перед серверными сервисами и направляет к ним входящие HTTP-запросы по заданным правилам: например, по пути, HTTP-методу, заголовку или хосту.

Фильтры привязаны к маршрутам: каждый фильтр применяется только к запросам, соответствующим его маршруту. Фильтры могут добавлять, удалять и переписывать заголовки и параметры, переписывать или задавать путь запроса, а также включать такие возможности, как circuit breaker. Маршруты можно задавать через API или конфигурацию, а также получать из Spring Cloud DiscoveryClient.

Проект собирается с помощью Maven и входящего в комплект wrapper-скрипта ./mvnw; требуется JDK 17. Для запуска тестов, зависящих от middleware вроде Redis, нужен работающий локальный экземпляр Docker.

Ключевые возможности

  • 01Сопоставление маршрутов по пути, методу, заголовку, хосту и другим атрибутам запроса
  • 02Фильтры, привязанные к отдельным маршрутам
  • 03Фильтры могут изменять заголовки, параметры и пути запросов и ответов
  • 04Поддержка circuit breaker среди встроенных фильтров
  • 05Настройка маршрутов через API или конфигурацию, а также получение их из Spring Cloud DiscoveryClient

Сценарии использования

  • Маршрутизация входящих запросов к группе микросервисов на Spring Boot
  • Добавление или переписывание заголовков и путей до того, как запросы попадут в серверные сервисы
  • Интеграция с обнаружением сервисов, чтобы маршруты соответствовали зарегистрированным сервисам

Быстрый старт

  1. 1

    Клонируйте репозиторий проекта

  2. 2

    Установите JDK 17 и соберите исходный код с помощью Maven Wrapper

    ./mvnw install

Что важно знать

  • Для сборки требуется JDK 17.
  • Для некоторых тестов Docker должен быть запущен локально.

В подборках

Темы

Частые вопросы

Что такое spring-cloud-gateway?
API-шлюз на Spring Framework и Spring Boot для маршрутизации и фильтрации HTTP-запросов в микросервисных системах. Spring Cloud Gateway — API-шлюз для Java-приложений на Spring Framework 6 и Spring Boot 3, работающий на Java 17. Он располагается перед серверными сервисами и направляет к ним входящие HTTP-запросы по заданным правилам: например, по пути, HTTP-методу, заголовку или хосту.
spring-cloud-gateway можно использовать бесплатно? Какая у него лицензия?
spring-cloud-gateway распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
spring-cloud-gateway всё ещё поддерживается?
Активно поддерживается. Последний коммит в spring-cloud-gateway — 6 нояб. 2026 г..
Для чего можно использовать 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

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты