shenyu

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/apache/shenyu-website/main/static/img/logo-light.svg">
    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/apache/shenyu-website/main/static/img/logo.svg">
    <img alt="Apache ShenYu" src="https://raw.githubusercontent.com/apache/shenyu-website/main/static/img/logo.svg" width="260">
  </picture>
</p>

<p align="center">
  <a href="https://search.maven.org/search?q=g:org.apache.shenyu%20AND%20a:shenyu"><img src="https://img.shields.io/maven-central/v/org.apache.shenyu/shenyu.svg?label=maven%20central" alt="Maven Central release" /></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="Apache 2.0 license" /></a>
  <a href="https://github.com/apache/shenyu/actions/workflows/ci.yml"><img src="https://github.com/apache/shenyu/actions/workflows/ci.yml/badge.svg" alt="CI status" /></a>
  <a href="https://codecov.io/gh/apache/shenyu"><img src="https://codecov.io/gh/apache/shenyu/branch/master/graph/badge.svg" alt="Codecov coverage" /></a>
  <a href="https://hub.docker.com/r/apache/shenyu-bootstrap/tags"><img src="https://img.shields.io/docker/pulls/apache/shenyu-bootstrap" alt="Docker pulls" /></a>
  <a href="https://gitpod.io/#https://github.com/apache/shenyu"><img src="https://img.shields.io/badge/Contribute%20with-Gitpod-908a85?logo=gitpod&amp;color=green" alt="Contribute with Gitpod" /></a>
  <a href="https://deepwiki.com/apache/shenyu"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki" /></a>
</p>

<p align="center">
  <a href="https://shenyu.apache.org/"><img src="https://img.shields.io/badge/Official_Website-Explore-13c46a?style=for-the-badge" alt="Official website" /></a>
  <a href="https://shenyu.apache.org/download/"><img src="https://img.shields.io/badge/QUICK%20DOWNLOAD-393af8?style=for-the-badge" alt="Quick download" /></a>
</p>

<p align="center">
  <a href="https://trendshift.io/repositories/3415"><img src="https://trendshift.io/api/badge/repositories/3415" alt="apache/shenyu on Trendshift" width="250" height="55" /></a>
</p>

## Overview

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](https://shenyu.apache.org/docs/developer/custom-plugin/), 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 gatew