Struct HttpUpstreamRequestPolicy 

pub struct HttpUpstreamRequestPolicy {
    pub strip_hop_by_hop: bool,
    pub strip_connection_nominated: bool,
    pub reject_malformed_connection_nominations: bool,
    pub h1_upgrade: H1UpgradePolicy,
}

Policy for forwarding request headers to HTTP upstreams.

This policy applies to automatically forwarded downstream request headers. Application code may deliberately alter the resulting request in its upstream request filter.

Fields

strip_hop_by_hop: bool

Strip standard hop-by-hop request fields inherited from the downstream request.

Standard hop-by-hop framing fields are removed. If a non-empty request body is unframed after application upstream request filtering, Pingora sends it chunked to an HTTP/1 upstream.

strip_connection_nominated: bool

Strip extension fields identified by tokens in the downstream Connection header field.

Requests nominating Host, forwarding-origin fields, or pseudo-header-shaped fields are rejected rather than forwarded with protected metadata removed when this behavior is enabled.

reject_malformed_connection_nominations: bool

Reject Connection nominations that are not a valid HTTP token (RFC 9110 §5.6.2), such as Connection: "X-Forwarded-For", instead of tolerating them as distinct literal fields.

Defaults to true. Exact nominations of protected fields and pseudo-headers are rejected either way. Only has an effect when strip_connection_nominated is enabled.

h1_upgrade: H1UpgradePolicy

Controls forwarding of HTTP/1 protocol upgrade request fields.

Implementations

impl HttpUpstreamRequestPolicy

pub fn standard() -> Self

Use standards-oriented forwarding with normalized WebSocket upgrade support.

pub fn preserve() -> Self

Preserve the previous HTTP/1 upstream request-header passthrough behavior.

This mode is RFC-non-compliant and is provided only for legacy compatibility. Use it at your own risk: the application’s upstream request filter is solely responsible for ensuring valid hop-by-hop header handling.

pub fn deny_upgrades() -> Self

Strip hop-by-hop fields and do not forward any HTTP/1 upgrade handshake.

Trait Implementations

impl Clone for HttpUpstreamRequestPolicy

fn clone(&self) -> HttpUpstreamRequestPolicy

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for HttpUpstreamRequestPolicy

impl Debug for HttpUpstreamRequestPolicy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for HttpUpstreamRequestPolicy

fn default() -> Self

Returns the “default value” for a type.

impl Eq for HttpUpstreamRequestPolicy

impl PartialEq for HttpUpstreamRequestPolicy

fn eq(&self, other: &HttpUpstreamRequestPolicy) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for HttpUpstreamRequestPolicy