Struct HostArgs 

pub struct HostArgs {

    pub listen: String,
    pub profile: ProfileChoice,
    pub display: DisplayMode,
    pub takeover: Takeover,
    pub display_quality: u8,
    pub browser: BrowserChoice,
    pub browser_bin: Option<PathBuf>,
    pub token: Option<String>,
    pub ops_enabled: bool,
    pub health_enabled: bool,
    pub health_public: HealthPublic,
    pub engine_envs: Vec<(String, String)>,
    pub browser_args: Vec<String>,
    pub proxy: Option<String>,
    pub recent_requests_cap: usize,
}

Parsed command-line arguments for afhttp host. The CLI layer in cli::cmd::host builds this struct from clap.

Fields

listen: String

profile: ProfileChoice

The single browsing identity bound to this host.

display: DisplayMode

takeover: Takeover

display_quality: u8

Display-takeover image quality as a percentage (0-100), mapped to KasmVNC’s 0-9 quality tiers. Higher is crisper but uses more bandwidth. Only meaningful when takeover is KasmVnc.

browser: BrowserChoice

browser_bin: Option<PathBuf>

token: Option<String>

ops_enabled: bool

health_enabled: bool

health_public: HealthPublic

engine_envs: Vec<(String, String)>

Explicit environment variables to propagate into the backend subprocess. The host never silently forwards the parent process’s HTTP_PROXY, XDG_*, BROWSER, etc. — agents that genuinely need an env var inside the browser pass it here.

browser_args: Vec<String>

Raw command-line arguments appended to the backend subprocess after the host’s curated defaults. Used for backend-specific surfaces the host does not model first-class (e.g. --fingerprint-brand=Chrome for fingerprint-chromium). Chromium honors last-wins for duplicate flags, so an explicit entry here overrides any default the host applied.

proxy: Option<String>

Explicit upstream HTTP/HTTPS proxy for all browser traffic in this host instance. Per the isolation invariant (design.md “Browsing environments are isolated”), the host never honors ambient HTTP_PROXY/HTTPS_PROXY — this flag is the ONLY way to route browser traffic through a proxy. Format: http://user:pass@host:port or socks5://host:port.

recent_requests_cap: usize

Maximum number of recent requests to keep in the ring. 0 (default) disables the /recent-requests endpoint entirely.

Trait Implementations

impl Clone for HostArgs

fn clone(&self) -> HostArgs

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HostArgs

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

Formats the value using the given formatter.