binding (proxy)
Zilla runtime proxy binding
Defines a binding with proxy protocol support, with server or client behavior.
The server kind proxy binding decodes Proxy v2 protocol on the inbound network stream, producing higher level application streams for each request.
The client kind proxy binding receives inbound application streams and encodes each as a network stream via Proxy v2 protocol.
Conditional routes based on the network transport type or network addresses are used to route these streams to an exit binding.

Example

"proxy_server0":
{
"type" : "proxy",
"kind": "server",
"routes":
[
{
"when":
[
{
"transport": "stream",
"family": "inet4",
"destination":
{
"port": 443
}
}
],
"exit": "tls_server0"
}
]
}

Configuration

Binding with support for proxy protocol.

Properties

Name (* = required)
Type
Description
type*
const "proxy"
Support proxy protocol.
kind*
enum [ "client", "server" ]
Behave as proxy client or server
routes
array of route​
Conditional proxy-specific routes
exit
string
Default exit binding when no conditional routes are viable

route

Routes for proxy protocol.

Properties

Name
Type
Description
guarded
object as named map of string array
List of roles required by each named guard to authorize this route
when
array of condition​
List of conditions (any match) to match this route
exit*
string
Next binding when following this route

condition

Conditions to match routes for proxy protocol.

Properties

Name
Type
Description
transport
enum [ "stream", "datagram" ]
Transport type
family
enum [ "inet", "inet4", "inet6", "unix" ]
Address family
source
​address​
Source address
destination
​address​
Destination address

address

Address for proxy protocol.

Properties

Name
Type
Description
host
string
Hostname or IP address
port
integer
Port number
Copy link
On this page
Example
Configuration
route
condition
address