42 lines
2.0 KiB
Markdown
42 lines
2.0 KiB
Markdown
# 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
|