Buzzard

A firewall-enabled reverse proxy server built with .NET Kestrel and YARP (Yet Another Reverse Proxy).

Features

• Reverse proxy powered by YARP
• Path-based request filtering (allow/deny by prefix, suffix, or contains)
• User-Agent based request filtering (allow/deny by prefix, suffix, or contains)
• OpenTelemetry support (logging, metrics, tracing)

Requirements

• .NET 10.0

Supported Platforms

Platform	x64	x86	ARM64
Windows	✓	✓	✓
Linux	✓		✓
macOS	✓		✓

Getting Started

Using Binary

Download the release binary for your platform from the releases page.

# Using default configuration
./Buzzard

# Using custom configuration
./Buzzard --configuration my-config.json

The server will start and listen on the configured ports.

Using Docker

Please see GHCR and examples.

Configuration

See: Configuration Documentation.

Development

See: Development Documentation.

Using Stacks

Name	Description
C#	Programming language
Kestrel	Web server
YARP	Reverse proxy
ZLogger	Structured logging
OpenTelemetry .NET	Observability (logging, metrics, tracing)
xUnit	Testing framework
Moq	Mocking library

License

This code is open source software licensed under the MIT License.