Files
proxy/CONTEXT.md
T
proxyctl coordinator 0f4c122eff feat: add Protocol Probe and accept bare host:port in profiles
- Ctrl+D in the Single URL field runs a handshake probe against the typed endpoint. It detects HTTP and/or SOCKS5 without forwarding traffic or contacting external hosts.

- HTTP-capable endpoints map to http://; SOCKS5-only endpoints map to socks5h://. Userinfo is preserved as typed.

- Bare host:port input is accepted and defaults to http:// at save.

- Update README privacy boundary and add .scratch/protocol-probe/spec.md.
2026-07-17 17:36:50 +08:00

38 lines
1.7 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
**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