先分清三条网络路径:Git、SSH 和 Homebrew 不共用一种代理
开发者遇到的典型问题往往不是「Clash 没启动」,而是浏览器可以打开代码托管平台,终端里的 git clone 却卡在连接阶段;HTTPS 仓库能拉取,切换成 SSH 地址后又报超时;或者 Git 已经配置代理,brew install 下载软件包仍然失败。原因在于这些命令可能由不同程序发起网络请求,也不会自动共享同一套代理设置。
可以先把工作流分成三条:Git over HTTPS 通常由 Git 调用的 HTTP 客户端处理;Git over SSH 使用独立的 SSH 连接,不会因为设置了 HTTPS_PROXY 就自动走代理;Homebrew 除了访问 Git 仓库,还可能通过 Ruby、curl 或其他下载流程获取 API 元数据、压缩包和瓶装二进制文件。只修好其中一条,不代表另外两条也通了。
开始排查前,先确认 Clash 客户端显示内核正在运行,并记下本机的 HTTP、SOCKS 或 mixed-port 端口。不同配置的端口并不固定,常见示例值不能直接当成你的实际值。以下命令都以 127.0.0.1:7890 作为 HTTP/mixed 端口示例;如果你的 Clash 配置使用其他端口,必须替换成实际监听端口。还要确认系统代理、TUN 和其他 VPN 没有同时以互相冲突的方式接管连接。
选择代理入口:从规则模式开始,按需补齐终端进程
对多数个人开发机,建议先使用规则模式,并给代码托管平台和必要的软件源配置清晰的去向。这样,GitHub 等目标可以按规则进入合适的策略组,其他开发服务与日常网页则继续遵循现有规则,而不是让所有流量长期走同一个出口。排查期间可以临时切换节点或策略组验证,但不宜把「全局模式一直开着」当作正式解决方案:它会扩大影响范围,也容易掩盖究竟是哪条规则没有命中。
终端能否自动使用系统代理,取决于操作系统、终端应用和具体命令是否读取系统设置。桌面浏览器能代理,并不能证明外部终端、IDE 集成终端、容器或远程 SSH 会话也能代理。最直接的验证方式,是在同一个终端窗口中临时设置环境变量,再执行轻量的 HTTPS 请求:
export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
export ALL_PROXY="socks5h://127.0.0.1:7891"
curl -I --max-time 15 https://github.com/
这里的 7891 只是 SOCKS 端口示例;如果你的 Clash 没有监听该端口,不要照搬这行设置。某些工具只读取大写变量,另一些也会读取小写的 http_proxy、https_proxy,遇到表现不一致时可以检查当前进程实际继承了哪些环境变量。socks5h 通常会让域名解析请求也经由 SOCKS 代理转发;使用普通 socks5 时,解析行为则可能不同。若代理不可达,先检查端口与监听地址,再检查规则和节点,不要一开始就修改一整套 DNS 配置。
如果临时设置有效,再决定是否把变量写入 shell 配置文件。共享开发机、公司设备和自动化构建环境不一定适合全局注入;尤其不要把带账号密码的代理地址直接写进会提交到仓库的脚本、Dockerfile 或项目配置。需要临时恢复直连时,可以在当前会话清除变量,避免误以为应用仍在使用 Clash。
Git over HTTPS:单独检查 Git 配置、环境变量与命中规则
Git 仓库地址以 https:// 开头时,优先检查命令运行环境与 Git 自身配置。环境变量可覆盖一部分常见命令行客户端的代理行为,但 Git 也可能设置专用的 http.proxy,并因此出现「其他 curl 请求正常,Git 仍失败」或相反的情况。先查看当前生效设置,不要急着叠加多个不同来源的代理地址:
git config --show-origin --get-regexp 'http\..*proxy|http.proxy'
env | grep -i proxy
如需给 Git 单独指定本机 HTTP 代理,可先在当前用户配置中测试:
git config --global http.proxy http://127.0.0.1:7890
git ls-remote https://github.com/OWNER/REPOSITORY.git
请把示例仓库替换成你确实有权访问的地址。git ls-remote 可以用来验证 Git 连接和远端引用读取,比每次都完整克隆大型仓库更轻便。如果命令返回认证错误,说明连接可能已经到达服务器,问题要转向凭据、权限或双重验证,而不是继续盲目更换代理。若卡在 DNS、连接超时或 TLS 握手阶段,再回到 Clash 内核日志确认目标主机、命中的规则和策略组。
代理规则也不应只凭「主站能打开」来判断完整。克隆、登录、查看发行版和下载附件可能涉及不同主机名或重定向目标。建议先在日志中记录失败请求的实际域名,再将确有需要的目标纳入相应规则;不要未经验证就把某个大型域名后缀整体导入代理组。规则从上到下匹配,前置的宽泛规则可能先行命中,让你后来添加的精确规则根本没有机会生效。
如果同一台机器上配置过多个 Git 代理来源,可以按输出中的文件路径判断设置来自系统、用户还是仓库级配置。结束测试后,删除不再需要的全局项,避免它覆盖下一次终端环境或另一套网络方案:
git config --global --unset http.proxy
git config --show-origin --get-regexp 'http\..*proxy|http.proxy'
不要把代理凭据写入 Git 仓库的远程地址,也不要把包含令牌的终端输出贴到公开问题帖。对共享项目来说,个人电脑上的代理属于本地网络设置,不应成为项目成员必须复制的仓库配置。
Git over SSH:SSH 不读取 HTTPS 代理,需要单独建立通道
以 [email protected]:OWNER/REPOSITORY.git 形式访问时,连接由 SSH 客户端建立。前面设置的 Git HTTPS 代理或 HTTPS_PROXY 通常不会自动接管它,所以「HTTPS 地址正常、SSH 地址超时」并不矛盾。先用 ssh -T 测试认证和连通性,并观察终端提示与 Clash 日志;如果连接连握手阶段都到不了,优先处理网络路径,若服务器已经返回公钥或认证提示,再检查 SSH key、账号权限和密钥代理。
SSH 代理的实现方式取决于你本机可用的工具。若安装了支持 HTTP CONNECT 的 ncat,可以在 SSH 配置中为特定主机指定代理命令。以下示例使用 HTTP/mixed 端口,并应将地址及端口替换为本机实际值:
Host github.com
HostName github.com
User git
ProxyCommand ncat --proxy 127.0.0.1:7890 --proxy-type http %h %p
将这段内容放在用户目录下的 ~/.ssh/config,并确认该文件仅对当前用户可读写。并非所有系统都预装 ncat,其参数也可能因发行版或版本而不同;如果命令提示参数无效,先用 ncat --help 核对安装版本,不要误把某个实现的选项照搬到另一个 nc 程序。另一种常见方案是使用支持 HTTP CONNECT 的代理辅助工具,并在 ProxyCommand 中调用它。若 Clash 提供 SOCKS 端口,也可以选择明确支持 SOCKS5 的辅助程序,关键是让代理命令与监听协议一致。
配置完成后执行 ssh -T [email protected],再用一个轻量 Git 操作复核。首次连接可能询问是否信任服务器主机密钥;应先核对主机指纹来源,再决定是否接受。若代理日志显示连接已送往预期策略组,但 SSH 仍失败,可通过 SSH 的详细输出定位发生在代理命令启动、TCP 建连、密钥协商还是公钥认证阶段。不同阶段对应不同问题,调整私钥权限并不能修复代理端口不可达,换节点也不能替代缺失的 SSH key。
远程开发还有一层容易遗漏:在本机启动的 SSH 连接与登录远程主机后执行的命令,是两台机器上的不同网络路径。本机 Clash 不会自动代理远端服务器发出的 Git 或软件包请求。需要远端也访问外部资源时,应按远端环境自身的网络政策配置,不要把本机代理地址误当作远端可直接访问的地址。
Homebrew 与排错顺序:看清失败发生在哪个请求
Homebrew 的安装与更新不是单一的 Git 操作。它可能先获取仓库或 API 数据,再从不同主机下载配方所需的归档文件与预编译包。因此,配置了 git config http.proxy,不等于 Homebrew 触发的所有 HTTPS 请求都会使用同一代理;反过来,环境变量生效也不代表所有底层 Git 操作都采用了你预期的配置。先在同一终端中设置必要的 HTTP/HTTPS 代理变量,再用 Homebrew 的常规检查命令观察具体失败位置。
测试时可先尝试查询版本或更新元数据,而不是连续重复安装大型软件包。若错误信息出现连接超时、TLS 握手失败或下载中断,记录对应 URL 的主机名,并在 Clash 内核日志中对照是否有连接、命中了哪个策略组、最终由哪个出站处理。若命令已经取得配方信息但在归档下载时失败,故障点就可能是下载域名或重定向目标,而不是 Homebrew 仓库本身。不要只看到「brew 失败」就推断整个代码托管平台都不可访问。
可以按下面的顺序把排错范围逐步缩小:
- 核对监听端口:确认 Clash 内核运行中,HTTP 或 SOCKS 端口与命令中的地址一致,且该监听允许本机连接。
- 分开测试传输协议:先用
curl测 HTTPS,再用ssh -T测 SSH,不要以浏览器成功代替终端验证。 - 查看规则命中:在失败请求发生时打开内核日志,核对实际目标域名、规则顺序、策略组与出站结果。
- 按错误层次处理:连接超时看路由与端口,证书错误检查本机时间和证书链,认证失败检查密钥、令牌或仓库权限。
- 清理临时改动:移除过期的 Git 代理、shell 环境变量和测试用规则,再进行一次干净的复测。
如果规则组显示为直连,先检查目标域名是否确实匹配规则、是否被更靠前的规则截获,以及命令是否经过 Clash;如果显示代理但依然超时,再检查节点可用性、目标服务状态、企业防火墙或二次 VPN。切换到全局模式可以作为短暂对照实验,但如果全局有效而规则模式失败,应回头修正规则,而不是把全局模式当作唯一答案。若命令返回的是权限拒绝、仓库不存在或 API 限流,则代理可能已经完成传输层工作,后续应按服务端响应处理。
与只会代理浏览器的桌面工具相比,Clash 配合终端环境变量、Git 的独立 HTTPS 设置以及 SSH 的显式代理命令,可以把 Git 拉取、SSH 访问和 Homebrew 下载分别纳入可检查的工作流,同时保留规则分流与日志定位能力。对于只支持单一应用、无法解释终端请求去向的方案,这种分层配置更容易发现问题并按需回滚。如果你希望先确认适合自己系统的 Clash 客户端,再逐步整理开发机网络,可以从下载页选择对应平台版本。