As an open-source project, apache/shenyu has picked up 8.9k stars on GitHub (Java). Apache ShenYu is a Java native API Gateway for service proxy, protocol conversion and API governance.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Apache ShenYu is a Java-based gateway for service proxying, protocol conversion, and API governance. An extensible plugin chain processes requests, while ShenYu Admin manages and distributes configuration to gateway replicas.
Core Capabilities
Area
What ShenYu provides
Plugin routing and extensions
An ordered plugin chain for HTTP requests, with selector and rule matching where applicable. Spring Boot starters select plugins; custom Java plugins, SPI implementations, and WASM plugin APIs extend the gateway.
Protocols and upstreams
HTTP and Spring Cloud services, WebSocket connections, and Apache Dubbo and gRPC backends. Optional TCP and MQTT listeners provide additional ingress; SOFA and Tars gateway plugins are available as external plugin-store starters.
Registration and discovery
Client SDKs register service addresses and API metadata with Admin. Registry integrations support discovery; an optional Kubernetes controller reconciles Ingress and Endpoints resources.
Security and traffic control
WAF, signing, authentication plugins, load balancing, rate limiting, and fault tolerance through Resilience4j and Sentinel; deprecated Hystrix remains available as an external plugin (see plugin-store-hystrix).
Caching and transformation
In-memory or Redis-backed response caching, URL rewriting, redirection, and request/response transformation.
Dynamic configuration
Admin persists plugins, selectors, rules, metadata, and authentication data. WebSocket sync is the default; HTTP long polling, ZooKeeper, Nacos, and etcd are available. Apollo remains available during its deprecation release and is planned to move to an external extension (see Apollo migration). Consul sync is available as an external extension (see plugin-store-consul). Gateway replicas apply updates to their local caches.
Observability
Metrics and logging plugins, including Kafka and Elasticsearch destinations; email and DingTalk alerts from Admin.
AI and MCP
AI proxy, prompt processing, token limits, sensitive-word filtering, AI request/response transformation, and an MCP server plugin with SSE and Streamable HTTP.
Architecture
Get Started
Start with the English documentation, 中文文档, or the official downloads.
Docker quick start
Use Docker and OpenSSL to start ShenYu Admin, a gateway, and an example HTTP service. Run the commands below in the same shell.
Admin listens on http://localhost:9095; the gateway listens on http://localhost:9195. Wait for both services to start, then check their health endpoints:
This request updates only this gateway instance; it does not write the route to Admin. For centrally managed, durable routes, configure them in Admin with a persistent database instead of the default in-memory H2 database.
SOFA and Tars support is no longer bundled in the default gateway distribution. To run those protocols, install the matching plugin-store starter in the gateway classpath and keep using the existing Admin metadata, client registration SDKs, and examples for protocol configuration.
Verify the route
curl -i http://localhost:9195/index.html
The response should contain the NGINX welcome page served through ShenYu.
Why Apache ShenYu?
ShenYu (神禹) is an honorific name for Xia Yu, an ancient Chinese ruler also known as Da Yu. He is remembered for crossing the Yellow River three times for the benefit of the people and successfully controlling its floods. Alongside Yao and Shun, he is regarded as one of ancient China's three greatest kings.
The name reflects three ideas:
It promotes the traditional virtues of Chinese civilization.
It echoes a gateway's central role in governing traffic.
It expresses the community's commitment to being fair, just, open, and meritocratic, in tribute to ShenYu and in keeping with the Apache Way.
Community and Support
Contribute to ShenYu
Windows checkout and long-path troubleshooting
Split Java client migration and contribution guide
Join the development mailing list
Known Users
The Known Users page lists registered users in registration order.
Organizations using Apache ShenYu are welcome to register through GitHub issue #68. Registration is for open source users only.
Star History
License
Apache ShenYu is licensed under the Apache License, Version 2.0.
The most recent commit recorded on apache/shenyu was 3 months ago, based on the GitHub push timestamp. The repository has 3.1k forks — one of the better signals of community interest.
How many stars does apache/shenyu have?
apache/shenyu has 8.9k GitHub stars — refresh the page for the live number, or check github.com/apache/shenyu. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What language is apache/shenyu written in?
apache/shenyu is written primarily in Java. GitHub's language field is based on the largest share of bytes in the default branch.
What license does apache/shenyu use?
apache/shenyu is released under the Apache-2.0 license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
What topics is apache/shenyu associated with?
GitHub's repository topics for apache/shenyu: "api-gateway", "dubbo-proxy", "grpc-proxy", "http-proxy", "reactor-java", "sofa-proxy", "spring-cloud-proxy". TopGit's editorial category is open-source.
Where can I see apache/shenyu in action?
The project maintains a homepage at https://shenyu.apache.org/. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about apache/shenyu?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/apache/shenyu is the definitive source.
Read full README in the tab above.
Is shenyu worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of shenyu.