Struct OutboundProxies 

pub struct OutboundProxies { /* private fields */ }

The process-wide outbound proxy configuration, resolved once at startup.

Two independent proxies rather than one: an estate that proxies only its TLS egress is ordinary, and select returning None for https because only http_url was set is a decision an operator made, not a gap.

Implementations

impl OutboundProxies

pub fn from_config(cfg: &ProxyConfig) -> Result<Self>

Resolves [proxy], falling back to the conventional environment variables for any key left empty.

Precedence, highest first:

key	then	then
proxy.http_url	$http_proxy	—
proxy.https_url	$https_proxy	$HTTPS_PROXY
proxy.no_proxy	$no_proxy	$NO_PROXY

An empty string is “unset” in both sources: config cannot tell an absent environment variable from one a ${VAR:-} shell default left empty, and neither can a shell.

Uppercase HTTP_PROXY is deliberately not read. Under CGI a client-supplied Proxy: request header lands in the environment as HTTP_PROXY (httpoxy, CVE-2016-5385 and friends). This server is never a CGI process, so the vector does not reach it — but Go’s net/http dropped the variable for exactly this reason, matching it costs nothing, and honouring a variable purely because everyone does is the kind of thing that is only ever wrong. HTTPS_PROXY has no such history and is honoured.

Every failure here is fatal: a proxy that cannot be understood must stop the process, never quietly leave egress going somewhere else.

pub fn direct() -> Self

Nothing configured: every connection dials the origin directly.

pub fn is_configured(&self) -> bool

Whether any proxy is configured at all.

Trait Implementations

impl Clone for OutboundProxies

fn clone(&self) -> OutboundProxies

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OutboundProxies

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

Formats the value using the given formatter.

impl Default for OutboundProxies

fn default() -> OutboundProxies

Returns the “default value” for a type.