开发者用Clash打通Git、SSH与Homebrew代理
先找对 Clash 端口:终端走代理和浏览器走代理是两回事
浏览器里 GitHub 打得开,不说明终端里的 git、ssh 和 brew 也经过了 Clash。浏览器一般会读系统代理设置,命令行程序用不用代理,要看它自己的配置、当前 shell 里的环境变量,以及客户端有没有开放一个本机程序能连的代理端口。所以经常是这样:网页好好的,git clone 却连接超时;或者仓库拉下来了,Homebrew 下载 bottle 时还在一遍遍重试。
动手前,先在 Clash Verge、Clash Verge Rev 或别的 Mihomo 客户端里确认代理核心已经跑起来,再看配置里的 mixed-port、port 或 socks-port。下面拿本机 HTTP 代理端口 7890 举例;你实际用的不是这个,就把所有示例里的端口一起换掉。混合端口一般 HTTP 和 SOCKS 都能收,具体还是以你客户端当前的配置为准。别把控制面板的端口当成代理端口,也别直接抄别的电脑上的端口号。
macOS 或 Linux 上,可以先在终端里临时挂上代理,再发一个简单请求看通不通:
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:7890"
export NO_PROXY="localhost,127.0.0.1,::1"
curl -I https://github.com
这几个变量只是让当前 shell 和它启动的子进程去试着用代理,Clash 的分流规则并不会因此改变。HTTP_PROXY 和 HTTPS_PROXY 是给常见 HTTP 客户端看的;ALL_PROXY 有没有用,要看具体是哪个程序。socks5h 里那个 h 的意思是域名交给代理那边去解析,适合想让请求和 DNS 查询都沿着代理走的情况。命令还是失败的话,先看 Clash 连接记录里有没有这条请求,再判断问题出在端口、规则、节点还是客户端。
别一上来就把代理写进各种配置。先只在眼前这个终端里设好环境变量,拿 curl -I 试连接,再依次试 Git、SSH 和 Homebrew。这样能分清是「代理端口本身不通」,还是「某个工具没继承到代理」。
给 Git 挂代理:HTTPS 仓库和 SSH 仓库分开处理
Git 的远程地址常见两种写法:HTTPS 的,比如 https://github.com/组织/项目.git;SSH 的,比如 [email protected]:组织/项目.git。两者传输方式不一样,所以配好一种代理,不能默认另一种也跟着生效。先跑一下 git remote -v,看清这个仓库用的是哪种地址,再对症去配。
仓库用的是 HTTPS 地址,可以先单独给 Git 设代理:
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890
git config --global --get http.proxy
git config --global --get https.proxy
这是 Git 自己的设置,可以和 shell 里的环境变量同时存在。排查时别留下好几份互相打架的设置,比如 shell 指着一个端口,Git 配置里又指着另一个早就关掉的端口。想恢复默认,就把对应的配置项删掉,别把代理地址设成空字符串:
git config --global --unset http.proxy
git config --global --unset https.proxy
HTTPS 仓库连上以后,再用 git ls-remote 看能不能读到远程的引用。如果只有某一个仓库要走代理,进到那个仓库目录里设置时去掉 --global,就只对这个项目生效。工作电脑经常在几个网络之间换,按仓库单独配更好控制影响面;自己的电脑就看个人习惯,全局配也行。不管哪种,都要确认最后起作用的配置到底来自哪里,免得仓库里一条旧设置把全局的盖掉了。
还要清楚,Git 代理只管连接怎么走,SSH 密钥、访问令牌和仓库权限它都不管。报错要是权限被拒、密钥没加载或者仓库不存在,再怎么换节点也没用。可以用 git config --show-origin --get-regexp 'http\..*proxy|https\..*proxy' 查代理配置是写在哪个文件里的,再分别核对远程地址和认证方式。
让 SSH 通过 Clash 连出去:ProxyCommand 加 443 端口
设了 HTTPS_PROXY,SSH 也不一定会自己去用 HTTP 代理。用 SSH 地址访问代码托管平台时,Git 最后调用的是 SSH 客户端,所以得在 SSH 配置里明确写上代理命令。macOS 自带的 nc 在常见版本里能通过 HTTP CONNECT 代理建连;可以先在终端执行 nc -h,看看你这台机器上的版本认不认 -X 和 -x 这两个参数。
打开 ~/.ssh/config,加一段针对 GitHub 的配置。这里端口写的是 7890,请改成你 Clash 里实际能用的 HTTP 代理端口:
Host github.com
HostName github.com
User git
Port 22
ProxyCommand nc -X connect -x 127.0.0.1:7890 %h %p
ServerAliveInterval 30
ServerAliveCountMax 3
ProxyCommand 的作用是让 SSH 先经由本地代理连到目标主机和端口,%h、%p 会被 SSH 换成真实的主机名和端口号。加好以后先跑 ssh -T [email protected] 试一下,通了再去克隆仓库。第一次连接时 SSH 可能让你确认主机指纹,要通过可信的途径核对过再接受,别为了不看提示就把主机校验关掉。
有些网络会封掉 SSH 默认的 22 端口。GitHub 提供了一种走 ssh.github.com 443 端口的 SSH 连接方式,可以给它单独起一个主机别名,不碰原来 github.com 那段配置:
Host github.com-443
HostName ssh.github.com
User git
Port 443
ProxyCommand nc -X connect -x 127.0.0.1:7890 %h %p
ServerAliveInterval 30
ServerAliveCountMax 3
然后把仓库的远程地址改成用这个别名,比如 [email protected]:组织/项目.git。走 443 并不等于所有网络、代理和代码托管服务都吃这一套;连不上的话,先用 ssh -vT 看 SSH 实际读到了哪段配置、连的哪台主机、用的什么代理命令,再看 Clash 有没有记下到对应域名的请求。公司网络还可能规定必须走指定出口或认证代理,这种限制先找网管问清楚。
代理要用户名密码的,别把凭据直接写进公开仓库、共享脚本,或者会同步到云上的 SSH 配置。有组织给的认证方式就按那个来;排查时贴日志,也别把带令牌、私钥路径或敏感主机名的完整调试输出原样贴出去。
Homebrew 下载超时:让命令和下载走同一条路
Homebrew 装软件时,除了连软件源和 API,还可能用 Git 拉仓库,再从发布页或对象存储下载 bottle。只给 Git 挂代理,未必能管到所有下载;只开浏览器那套系统代理,也不能保证 Homebrew 用的网络组件会跟着走。排查时就在执行 brew 的那个终端里设代理,先确认最基本的连接没问题。
在 macOS 或 Linux 当前的 shell 里,可以直接用前面设好的变量,然后看一下 Homebrew 自己的状态,顺便更新元数据:
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:7890"
brew update
brew install wget
下载还是失败,别马上换 Homebrew 的源,更别去跑来历不明的安装脚本。先把出错 URL 的主机名、报错类型和卡在哪一步记下来:解析失败一般查 DNS 和规则;连接超时要确认终端有没有走代理、目标域名是不是进了该进的策略;证书报错就核对系统时间、证书链,以及网络里有没有做 TLS 检查,别图省事把证书校验关掉。Homebrew 安装一次可能要连好几个域名,得照着实际日志一个个确认,别指望一条域名规则就能管住全部下载。
用 zsh 的话,可以把常用的代理变量写进 ~/.zshrc,要用时再手动打开;bash 用户就放进对应的启动文件。最好写两个小函数,一个开、一个关,免得代理长期挂着把内网开发环境也带偏。单位自建的 Git、内部的包源、局域网里的服务、本机 Docker 的网络,未必都该经过 Clash。确认 NO_PROXY 里有本机地址和确实要直连的内部域名,换了网络之后再重新试一遍。
Homebrew 自己也会调用 Git 和别的下载工具,所以出了问题要分清是「仓库更新失败」还是「软件包文件没下下来」。前一种去看 Git 代理和 SSH 配置;后一种看下载阶段的终端输出和 Clash 连接记录。安装途中来回换节点,可能导致连接被重置、下载断断续续。调试期间就锁定一个能用的策略组和节点,更新、安装都确认没问题了,再决定要不要交给自动选优的组。
验证分流和日常维护:照着请求找问题,别靠一遍遍试节点
一套好维护的开发者代理用法,重点不在于让所有流量都走代理,而是让要代理的请求稳稳地落到合适的策略上,内网和本地服务照常走它们该走的路。可以按这个顺序验:先确认 Clash 核心和代理端口能用;再用 curl -I 试当前 shell;接着跑 HTTPS 仓库的 git ls-remote、SSH 的 ssh -T;最后执行 Homebrew 的更新或安装。每一步都把结果和时间记下来,对照 Clash 日志看域名、匹配到的规则、策略组和最终用的节点。
规则上,优先用你现有配置里已经有的策略组,别另建一个重名或者里面空空的组。确实要自己写,可以给代码托管平台相关的域名写明确的规则,并确认它们排在那些可能抢先匹配的宽规则前面。规则只决定 Clash 收到请求后往哪儿送,替代不了命令行工具自己的代理设置;反过来,终端变量只是让程序连上本地端口,也保证不了目标域名最终会去到你想要的节点。这两层都验过了,才算真正通了。
出故障时按症状缩小范围。所有命令都连不出去的,先看客户端在不在跑、端口有没有监听、系统网络和节点是否正常;只有 Git 的 HTTPS 不行,就查 Git 配置和相关规则;HTTPS 没问题、SSH 不行,重点看 ~/.ssh/config、nc 的参数、密钥和目标端口;只有 Homebrew 下大文件失败,就看出错 URL 对应的域名,以及下载工具有没有继承代理。浏览器和终端表现不一样也不奇怪,浏览器的系统代理和 shell 里的环境变量本来就是两套东西。
平时别把完整配置、访问令牌、SSH 私钥,或者带敏感内容的终端输出贴到公开论坛。升级客户端或改了代理端口之后,回头看看环境变量、Git 的 global 配置和 ~/.ssh/config 是不是还指着现在的端口;不需要代理了,就撤掉临时变量、删掉旧配置,并确认私有仓库和内网开发服务没被意外改走别的路。比起在每个工具里反复试错,把用哪个端口、敲哪些命令、写了哪些规则、怎么验证整理成团队内部的一页说明,更容易复现,换新电脑时也方便迁过去。
有些同类工具把命令行相关的设置散落在好几个页面里,或者全靠手改配置文件,换了网络以后很难看出 Git、SSH 和软件包下载各自走的是哪条路。Clash 的好处是本地代理入口和域名分流能集中在一处管理,再配合终端自己的代理设置一项项去验。如果想看看有哪些版本、怎么获取,可以去下载页。