gatel-core 0.1.2

A high-performance, KDL-configured reverse proxy and web server
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

# Gatel

**A high-performance, KDL-configured reverse proxy and web server built with Rust.**

Gatel is a modern reverse proxy and web server inspired by Caddy, powered by Hyper and Tokio. It uses [KDL](https://kdl.dev/) as its configuration language, providing a clean and expressive way to define sites, routes, and middleware.

## Features

- **KDL Configuration** — Human-friendly config format with intuitive nesting
- **Reverse Proxy** — Weighted load balancing, health checks, passive health monitoring, and automatic retries
- **TLS / ACME** — Automatic HTTPS via ACME (Let's Encrypt), manual certificate support, and mTLS
- **HTTP/1.1, HTTP/2, HTTP/3** — Full protocol support including QUIC-based HTTP/3
- **Compression** — Gzip, Zstd, and Brotli encoding
- **Static File Serving** — Efficient file server with configurable root directories
- **Rate Limiting** — Per-route request rate limiting
- **Stream Proxy** — TCP/UDP stream proxying
- **Admin API** — Runtime management endpoint

## Quick Start

```bash
# Build
cargo build --release

# Run with a config file
gatel run --config gatel.kdl
```

### Minimal Configuration

```kdl
global {
    http ":8080"
}

site "localhost" {
    route "/*" {
        respond "Hello from Gatel!" status=200
    }
}
```

### Reverse Proxy

```kdl
global {
    http ":80"
}

site "example.com" {
    route "/api/*" {
        proxy {
            upstream "127.0.0.1:3001" weight=3
            upstream "127.0.0.1:3002" weight=1
            lb "weighted_round_robin"
            health-check uri="/health" interval="10s"
        }
    }
    route "/*" {
        root "/var/www/html"
        file-server
    }
}
```

## Documentation

See the [docs/en](docs/en/) directory for full English documentation, or [docs/zh](docs/zh/) for Chinese documentation.

## License

Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for details.