Proxy

A single upstream proxy endpoint. Referenced by static pool members[].proxy_id or discovered via labels for dynamic pools.

Kind: Proxy · Version: v1

Spec fields

You must use either url or the explicit protocol + host + port form (not a mix of incomplete fields).

Field	Type	Required	Description
url	string	one mode	Shorthand URL, e.g. http://user:pass@host:port
protocol	string	if no url	Upstream protocol
host	string	if no url	Upstream host / IP
port	number	if no url	Upstream port (must be ≠ 0)
auth	object	no	Basic credentials when not embedded in url

auth (optional)

Field	Type	Required	Description
user	string	no	Username
pass	string	no	Password

Validation & notes

• Schema: if url is set → accepted; otherwise protocol, host, and non-zero port are required.
• Domain accepts protocols such as http, https, socks5 (MVP traffic path is HTTP proxying; SOCKS5 is on the roadmap).
• Scheme-less URLs are treated as http when parsed.
• Labels belong under metadata.labels, not spec.

Examples

URL shorthand

kind: Proxy
version: v1
metadata:
  name: proxy-1
  labels:
    provider: example
    region: us-east
spec:
  url: http://user:pass@1.2.3.4:8080

Explicit fields

kind: Proxy
version: v1
metadata:
  name: proxy-2
spec:
  protocol: http
  host: 1.2.3.4
  port: 8080
  auth:
    user: user
    pass: pass