# apache/shenyu

Apache ShenYu is a Java native API Gateway for service proxy, protocol conversion and API governance.

Repository: https://github.com/apache/shenyu
Canonical: https://ross.abutalabs.com/products/shenyu
Homepage: https://shenyu.apache.org/
Language: Java
License: Apache-2.0
License Family: permissive
Topics: api-gateway, http-proxy, dubbo-proxy, sofa-proxy, reactor-java, grpc-proxy, spring-cloud-proxy
Last push: 2026-08-26T08:41:31+00:00

## Health v2 (maintenance only)
Score: 88/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 68, longevity 100
- inputs: {"age_days": 2975, "days_push": 7, "days_rel": 56, "gap_med": 109.0, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 8820, forks 3059 (observed 2026-08-28T04:10:25.878312+00:00)

## What it is
Apache ShenYu is a Java-native, asynchronous, high-performance API gateway for service proxying, protocol conversion, and API governance across microservices. It supports proxying HTTP, Dubbo, Spring Cloud, gRPC, Motan, SOFA, TARS, WebSocket, and MQTT, with hot-swappable plugins for security, rate limiting, and observability.

## Use cases
- expose dubbo services as http apis through a gateway
- convert grpc requests to http for external clients
- add rate limiting and circuit breaking to microservice apis
- authenticate api traffic with jwt or oauth2 at the gateway
- proxy spring cloud services behind a unified endpoint
- manage api routing rules from a visual dashboard
- deploy a scalable api gateway on kubernetes
- add waf protection in front of backend services

## When to choose
- you run a Java/JVM microservices stack needing a unified gateway
- you need protocol conversion between HTTP and RPC frameworks like Dubbo, gRPC, or SOFA
- you want hot-swappable gateway plugins and dynamic traffic control via a dashboard
- you need built-in security, rate limiting, and observability plugins

## When to avoid
- you need a lightweight edge proxy without gateway features (use NGINX or Envoy)
- your stack is non-JVM and you prefer a language-native gateway like Kong (Lua) or KrakenD (Go)
- you only need simple reverse proxying or load balancing
- you want a fully managed cloud API gateway

## Facets
- artifact type: service
- maturity: stable
- function: api-gateway, proxy, middleware, rate-limiting, auth, monitoring, tracing, logging, websocket, rpc
- domain: microservices, apis, backend, web-development, self-hosted
- platform: jvm, windows, cross-platform
- tags: api-gateway, reverse-proxy, protocol-conversion, dubbo, grpc, spring-cloud, reactive, hot-swappable-plugins, traffic-management, waf, oauth2, jwt, apache-project, load-balancing, devops, docker, kubernetes, linux, macos

## Member repositories
- apache/shenyu (main) score 88

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:25.878312+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:25:05.145683+00:00, confidence not recorded.
  - readme: https://github.com/apache/shenyu (fetched 2026-08-28T04:10:25.878312+00:00, sha c79f9afa55cd)
  - homepage: https://shenyu.apache.org/ (fetched 2026-08-29T08:25:16.657222+00:00, sha 1b2ddc6d1171)
  - site_page: https://shenyu.apache.org/docs (fetched 2026-08-29T08:25:16.661270+00:00, sha 03957d03b151)
  - site_page: https://shenyu.apache.org/docs/index (fetched 2026-08-29T08:25:16.663228+00:00, sha 030545e8cd70)
  - site_page: https://shenyu.apache.org/document (fetched 2026-08-29T08:25:16.659620+00:00, sha 03131196529e)
- Data as of 2026-08-30T08:39:29.467469+00:00.