proxyctl coordinator
0f4c122eff
- 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.
1.8 KiB
Protocol Probe
Decisions
-
Probe semantics. The Protocol Probe is a user-initiated handshake check against the Single proxy URL endpoint. It reports which proxy protocols the endpoint speaks (HTTP, SOCKS5, or both). It never forwards traffic through the proxy and never contacts anything beyond the endpoint itself.
-
Trigger. Ctrl+D starts a probe only when:
- the Profile form is in Single mode, and
- the active field is the Single proxy URL field. It does not run on the Name or Bypass fields, and it does not run when saving with Ctrl+S.
-
Bare host:port default. A typed endpoint without a scheme is treated as
http://for parsing and dialing, matching the curl convention used elsewhere in the app. -
Mapping table. After detection, the Single proxy URL field is rewritten as follows:
- HTTP detected (alone or with SOCKS5):
http://<host:port> - SOCKS5 only:
socks5h://<host:port> - Unrecognized protocol: status message only; the field is left untouched.
- Dial failure: status message only; the field is left untouched.
- HTTP detected (alone or with SOCKS5):
-
Userinfo preservation. The exact bytes of any typed
user:pass@userinfo are preserved, including special characters such as@and spaces. Only the scheme is replaced. -
Stale-result safety. A probe started on the form is tagged with a generation ID. If the user leaves the form (Esc or a successful Ctrl+S) before the probe completes, the result is ignored and cannot mutate the abandoned form or the profiles page status.
-
Failure UX. A failed or unrecognized probe shows a status message and leaves the typed field unchanged so the user can correct the input and still save the Profile.
-
Documentation. README and CONTEXT already describe the Protocol Probe, its privacy boundary, and the
socks5hGNOME caveat.