Repolode
spring-cloud

spring-cloud/spring-cloud-gateway

Spring FrameworkとSpring Bootを基盤とし、マイクロサービス環境でHTTPリクエストをルーティング、フィルタリングするAPIゲートウェイです。

スター
4,919
フォーク
3,481
未解決の Issue
565
最終コミット
8 時間前

これは何?

Spring Cloud Gatewayは、Spring Framework 6とSpring Boot 3を基盤とし、Java 17で動作するJavaアプリケーション向けAPIゲートウェイです。バックエンドサービスの前段に配置され、パス、HTTPメソッド、ヘッダー、ホストなどの条件に基づいて、受信したHTTPリクエストを各サービスにルーティングします。

ルートにはそれぞれ専用のフィルターを設定でき、フィルターはそのルートに一致するリクエストにのみ適用されます。フィルターではヘッダーやパラメーターの追加、削除、書き換え、リクエストパスの書き換えや設定のほか、サーキットブレーカーなどの機能を利用できます。ルートはAPIまたは設定ファイルで定義でき、Spring Cloud DiscoveryClientから取り込むこともできます。

このプロジェクトは付属の./mvnwラッパーを使用してMavenでビルドし、JDK 17が必要です。Redisなどのミドルウェアに依存するテストを実行するには、ローカルでDockerを起動しておく必要があります。

主な機能

  • 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 とは?
Spring FrameworkとSpring Bootを基盤とし、マイクロサービス環境でHTTPリクエストをルーティング、フィルタリングする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

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト