Documentation
¶
Overview ¶
Package proxycfg 把 handoff 配置里的 proxy 字符串翻译成各消费方要的形态。
职责：
- Validate：取值域校验，供配置加载在启动期硬拒坏值
- Transport：给 net/http 用的 *http.Transport
- GitArgs：给 git 子进程用的 `-c http.proxy=<url>` 前缀参数
- Redact：日志用的脱敏文本
边界：
- 不读配置文件：调用方把字符串给它，它只做翻译
- 不碰网络，不判断代理是否可达（那是消费方真发请求时才知道的事）
- 不决定「谁该走代理」：协调者↔agentd 那条链路永不走代理，这条纪律由 调用方（只有 release 与 agentd 的出网 git 接线）保证，不在本包
- 本包不打日志，日志由调用方在接线点打并须经 Redact（本包是纯翻译函数， 无 I/O、无外部调用、无状态变更）
Index ¶
Constants ¶
This section is empty.
Variables ¶
View Source
var SupportedSchemes = []string{"http", "https", "socks5", "socks5h"}
SupportedSchemes 是 proxy 允许的 scheme。
这四种是 net/http 的 Transport 与 git 的 http.proxy **都**原生支持的交集。 socks4 不在其中：Go 从来没支持过它，配上去的表现是运行期报一句 "unsupported protocol scheme"，而那时早已过了任何人会看的时刻。
Functions ¶
func GitArgs ¶
GitArgs 返回给 git 子进程的代理参数，须插在子命令**之前**。
参数：
- proxy: 代理地址；空串返回 nil
返回：
- 形如 []string{"-c", "http.proxy=socks5://127.0.0.1:1080"}
注意：
- git 的 http.proxy 只对 http(s):// 的 remote 生效，**对 ssh:// 与 git@host:path 无效**。SSH remote 要走代理得配 ssh 的 ProxyCommand， 那会动到用户的 ssh 配置面，不在 handoff 的职责内（见 README）
- 用 -c 而不是注入 HTTPS_PROXY 环境变量：不污染子进程环境，也不会让 本地 git 操作平白多一个配置
func Redact ¶
Redact 返回可安全打进日志的代理文本。
参数：
- proxy: 代理地址；空串返回空串
返回：
- 含 user:pass@ 时凭据部分替换为 ***，其余原样；解析不了时**只返回 scheme 加省略号**，绝不返回原文——解析失败恰恰是最可能把整串密码原样打出去的场合
注意：
- 这不是可选的美化。代理 URL 常含凭据，本仓纪律见 internal/envfile/resolver.go:64
func Transport ¶
Transport 按 proxy 造一个 *http.Transport。
参数：
- proxy: 代理地址；**空串 = 不配**，返回的 Transport 沿用 http.ProxyFromEnvironment（即 HTTPS_PROXY/HTTP_PROXY/NO_PROXY）， 与本功能上线前的行为一字不差
返回：
- 可直接塞进 http.Client 的 Transport
- 错误：proxy 未通过 Validate
注意：
- 非空 proxy 时**固定返回**该地址，不再看 NO_PROXY。显式配置就是显式意图， 而 handoff 自己走代理的出网只有 GitHub 一个域，"某些域不走代理"这个需求 在这里不存在
- 基于 http.DefaultTransport 克隆，因此连接池、HTTP/2、超时等默认值全部保留； 从零 new 一个 &http.Transport{} 会静默丢掉这些，症状是并发下载变慢而无人知晓
Types ¶
This section is empty.
Source Files
Click to show internal directories.
Click to hide internal directories.