Skip to main content

Crate masque

Crate masque 

Available on crate feature masque only.
Expand description

MASQUE support for rama: proxying traffic other than TCP through HTTP.

It implements UDP proxying (RFC 9298, CONNECT-UDP) and IP proxying (RFC 9484, CONNECT-IP). connect_ip exposes packet/control sessions and explicit forwarding policy using rama_net::ip, without host interface changes. CONNECT-UDP runs over every HTTP version: HTTP/1.1 upgrades a GET request, HTTP/2 and HTTP/3 use Extended CONNECT. UDP payloads travel as HTTP Datagrams, in QUIC DATAGRAM frames on HTTP/3 when both peers support them and in DATAGRAM capsules otherwise. This crate owns the tunnel semantics (targets, URI templates, Context IDs, target policy), the proxy service, the client connector and the tunnel socket; Capsules, HTTP Datagrams and Extended CONNECT live in the rama HTTP crates and sockets in rama-udp.

§Rama

Crate used by the end-user rama crate and rama crate authors alike.

Learn more about rama:

Modules§

budget
Shared rates and principal budgets. Shared packet rates and principal budgets for MASQUE tunnels.
connect_ip
IP proxying over HTTP (RFC 9484), using rama_net::ip packet primitives.
connect_udp
Proxying UDP in HTTP (RFC 9298).
context
Shared MASQUE context identifiers.
limits
Shared admission accounting for MASQUE tunnels.