Skip to content

docs: cover proxy precedence, proxy auth and corporate CAs per OS - #276

Merged
Gorka Gonzalo (d0ubl3g) merged 2 commits into
devfrom
fix/25-proxy-tls
Nov 12, 2026
Merged

Gorka Gonzalo (d0ubl3g) merged 2 commits into
devfrom
fix/25-proxy-tls

Conversation

@d0ubl3g

Copy link
Copy Markdown
Contributor

Summary

Extends the README section "Networking: proxies and TLS inspection":

  • Proxy variables: precedence (upper case wins, a set-but-empty variable still counts), ALL_PROXY fallback, NO_PROXY syntax (domains, IPs, CIDR), proxy URL form and Basic authentication in the URL (percent-encoding), and the hosts to allow, including api.github.com for the daily update check.
  • TLS inspection: installing a corporate CA in the system store on Linux (Debian and RHEL families, plus SSL_CERT_FILE/SSL_CERT_DIR without admin rights), macOS and Windows. A custom CA affects TLS trust only, never checksum or signature verification.
  • Diagnosis: --verbose and a table of common errors with their fix.

No code change: all HTTP clients already honour the proxy variables and use the platform verifier, and certificate verification is never disabled. The behaviour is covered by the existing proxy-tls workflow (mitmproxy on Linux, macOS and Windows).

Refs #25: the real-macOS check behind a proxy is still open, so this PR does not close the issue.

Extend the networking section of the README: hosts to allow (including the
daily update check), variable precedence and NO_PROXY syntax, authentication
in the proxy URL, installing a corporate CA on Linux, macOS and Windows, and
a table of common errors with their fix. A custom CA only changes TLS trust;
it does not affect checksum or signature verification of downloads.

Refs #25

Signed-off-by: d0ubl3g <48954024+d0ubl3g@users.noreply.github.com>
Signed-off-by: d0ubl3g <48954024+d0ubl3g@users.noreply.github.com>
@d0ubl3g
Gorka Gonzalo (d0ubl3g) merged commit 7e3e490 into dev Nov 12, 2026
20 checks passed
@d0ubl3g
Gorka Gonzalo (d0ubl3g) deleted the fix/25-proxy-tls branch November 12, 2026 18:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant