Packages¶
Paduraksa's PROXY protocol support is also published on its own, for other .NET projects. They are the only parts of this repository built as NuGet packages. Both target .NET 10 and .NET 8.
| Package | What it is |
|---|---|
Paduraksa.ProxyProtocol |
A strict, allocation-free parser for the HAProxy PROXY protocol (v1 text and v2 binary), with the address types it uses. It has no dependency beyond the .NET base class library |
Paduraksa.ProxyProtocol.AspNetCore |
A Kestrel UseProxyProtocol connection middleware over it. It makes the client behind a load balancer the connection's remote address. Secure by default: no trusted proxies means every connection is refused |
Their READMEs are the package documentation:
Paduraksa.ProxyProtocolREADME: parsing a buffer, reading a header off a pipe, what it accepts, and trust.Paduraksa.ProxyProtocol.AspNetCoreREADME:UseProxyProtocol, its options and behaviour, and the rule to call it beforeUseHttps.
The parser is fuzzed (coverage-guided, with its corpus replayed on every commit) and tested against the specification's edge cases.
The packages ship on their own tag, proxyprotocol-v*, when they change, not with every release of the app. How a release is published is in Working on the code.
Paduraksa itself uses the same parser for its PROXY protocol listeners: see Client addresses.