ingress controller for K8s

Clone this repo:
  1. 561708f test: add e2e test cases for referer-restriction plugin (#375) by Yuelin Zheng · 18 hours ago master
  2. 2a4885d ci: add codeql (#382) by Alex Zhang · 3 days ago
  3. 43e4d11 fix: correctly translate ingress in extensions/v1beta1 group version (#380) by Vincent · 3 days ago
  4. 3a7eb8c fix: add compatibility logic for empty array when unmarshal json string to route (#374) by okaybase · 3 days ago
  5. 98d0162 feat:add labels for resources (#378) by Alex Zhang · 4 days ago

Apache APISIX for Kubernetes

Go Report Card

Use Apache APISIX for Kubernetes Ingress.

All configurations in apisix-ingress-controller are defined with Kubernetes CRDs (Custom Resource Definitions). Such as configure plugins, Support service registration discovery mechanism for upstreams, load balancing and more in Apache APISIX.

apisix-ingress-controller is an Apache APISIX control plane component. Currently it serves for Kubernetes clusters. In the future, we plan to separate the submodule to adapt to more deployment modes, such as virtual machine clusters.

The technical architecture of apisix-ingress-controller:


This project is currently considered experimental.


  • Declarative configuration for Apache APISIX with Custom Resource Definitions(CRDs), using k8s yaml struct with minimum learning curve.
  • Hot-reload during yaml apply.
  • Native Kubernetes Ingress (both v1 and v1beta1) support.
  • Auto register k8s endpoint to upstream (Apache APISIX) node.
  • Out of box support for node health check.
  • Support load balancing based on pod (upstream nodes).
  • Plug-in extension supports hot configuration and immediate effect.
  • Ingress controller itself as a pluggable hot-reload component.
  • Multi-cluster configuration distribution.

Internal Architecture


Apisix ingress controller requires Kubernetes version 1.14+.

Get started


  • Support UDP definition. #116
  • Support TCP definition. #115
  • Support GRPC definition. #114
  • Add a complete demo. #9
  • More todos will display in issues



User stories


We welcome all kinds of contributions from the open-source community, individuals and partners.




  • Ingress APISIX: the whole service that contains the proxy (Apache APISIX) and ingress controller (apisix ingress controller).
  • apisix-ingress-controller: the ingress controller component.


Apache License 2.0