# Proxy Configuration

This context describes how one active proxy configuration is coordinated across independently switchable Linux configuration surfaces.

## Language

**Proxy Profile**:
A named, reusable set of proxy connection details and bypass rules.
_Avoid_: Proxy, configuration preset

**Active Profile**:
The Proxy Profile currently selected as the source for every Enabled Target; it may be absent when no Proxy Profiles exist.
_Avoid_: Current proxy, selected preset

**Target**:
A configuration surface that can independently receive proxy settings, such as the Shell environment, APT, or the Docker daemon.
_Avoid_: Application, service

**Available Target**:
A Target detected as applicable to the current system and therefore shown on the main switch panel.
_Avoid_: Installed application, supported Target

**Enabled Target**:
A Target whose actual configuration matches the Active Profile; a Target cannot be enabled when there is no Active Profile.
_Avoid_: Active application, proxied app

**Drifted Target**:
A Target whose managed configuration exists but no longer matches the Active Profile, whether because an update failed or an external change occurred.
_Avoid_: Broken Target, partially enabled Target

**External Target**:
A Target for which a recognized proxy configuration exists outside this tool's ownership; absence of detected external configuration is treated as Disabled.
_Avoid_: Unknown Target, unmanaged error

**Drift Resolution**:
The explicit choice to resolve a Drifted Target either by reapplying the Active Profile or, when ownership evidence permits, restoring the configuration that existed before proxyctl managed it.
_Avoid_: Toggle drift, automatic repair

**Protocol Probe**:
A user-initiated handshake check against a Proxy Profile's endpoint that reports which proxy protocols (HTTP, SOCKS5) the endpoint speaks; it never forwards traffic through the proxy or contacts anything beyond the endpoint itself.
_Avoid_: Connectivity test, latency check