IngressReverse Proxy

An Easy, Powerful, Flexible Reverse Proxy

🚀

Easy to Use

Simple configuration with YAML files. Get started in minutes with minimal setup.

🔒

Built-in authentication support (Basic, Bearer, JWT, OAuth2, OIDC) and SSL/TLS termination.

⚡

Efficient routing with caching support (in-memory or Redis) for optimal performance.

🎯

Support for exact, regex, and wildcard host matching with path-based routing.

🏥

Built-in health check support for both outer and inner service monitoring.

🛠️

Optional embedded UI and API for routes, logs, TLS, cache, and config validate / publish / reload.

Install Ingress:

bash

go install github.com/go-zoox/ingress@latest

Start the server:

bash

# Start with default configuration (port 8080)
ingress run

# Start with custom configuration file
ingress run -c ingress.yaml

Basic configuration example:

yaml

version: v1
port: 8080

rules:
  - host: example.com
    backend:
      service:
        name: backend-service
        port: 8080

Same routing outcome without backend.type, or with type: service — runnable comparisons live in examples/basic/ingress.yaml.

backend.type is optional: Ingress infers service, handler, or redirect when exactly one of those blocks is configured.

For more details, see the Getting Started Guide.