Clash 开发者 Git、SSH 与 Homebrew 代理设置
开发者为什么不能只靠系统代理
不少人头一回配 Clash,只在客户端里打开「系统代理」,拿浏览器访问 GitHub 一看能开,就觉得开发环境搞定了。等到执行 git clone、git fetch、ssh -T [email protected] 或 brew install,毛病又冒出来:网页加载得好好的,拉仓库却停在连接那一步;HTTPS 仓库能克隆,换成 SSH 地址就一直超时;Homebrew 能搜到软件包,下源码或预编译文件时却失败。
原因是系统代理主要是给那些会读系统代理设置的图形界面程序用的,终端里的程序多半看自己的环境变量、配置文件或者传输层参数。Git 能通过全局配置用 HTTP 代理,SSH 得靠 ProxyCommand 或专门的跳转方式转发,Homebrew 背后则还会用到 Git、curl 和 GitHub Releases。同样是「开发时要连外网」,它们实际走的却是不同的路。Clash 的规则、shell 里的变量、Git 和 SSH 各自的设置,四样都得对上,才能得到一套每次都能复现的流程。
浏览器打不开 GitHub,先查 Clash 的节点、规则和 DNS;浏览器正常、终端不行,重点看 HTTP_PROXY、HTTPS_PROXY、Git 配置和 SSH 配置;只有某个仓库出错,再去看仓库地址、组织权限和 GitHub 那边的访问策略。
先给 GitHub 和开发相关的服务配好分流
开发者配代理,第一步不是一股脑开全局,而是给要稳定出口的服务建清楚的策略组。最基础的几个是 github.com、githubusercontent.com、githubassets.com 和 github.io。GitHub 的网页、Git 操作、Release 下载、Raw 文件和项目里的静态资源,可能各用各的主机名,只代理 github.com 是管不全的。
订阅里要是已经有「国外媒体」「漏网之鱼」之类的组,可以先看看 GitHub 相关域名实际落进了哪一个。熟练一点的用户可以在自定义规则上面单独加一个开发用的组。组名随你起,关键是规则要排在前面,并且让 Git、SSH 和 Homebrew 都走同一组稳定的出口。调试期间别直接用那种频繁换节点的自动选优组,不然同一个仓库的 HTTPS、SSH 和 Release 下载可能短时间内各走各的出口,问题很难复现。
rules:
- DOMAIN-SUFFIX,github.com,DEV
- DOMAIN-SUFFIX,githubusercontent.com,DEV
- DOMAIN-SUFFIX,githubassets.com,DEV
- DOMAIN-SUFFIX,github.io,DEV
- MATCH,DIRECT
上面这段规则只是演示结构,别默认你的配置里一定有一个叫 DEV 的组。导入以后去 Clash 面板里看看实际的组名,按情况改成能用的 select、url-test 或者别的代理组。公司代码托管、私有 GitLab、Docker Registry、各语言的包仓库这类服务,也要按域名分别确认。别图省事把所有流量都塞进同一个代理组,不然国内的代码托管、单位局域网和本机上跑的服务也可能被转错地方。
- GitHub 主站:看仓库、提 Issue、开 Pull Request、登录都靠它。
- GitHub 内容域名:存放 Raw 原始文件、README 里的图、Actions 用到的配置,以及各项目要拉的依赖。
- Release 与包下载:有些文件会跳到对象存储或 CDN 上,要照着 Clash 日志把域名补进去。
- 企业内网域名:大多该走直连或公司 VPN 的规则,不能直接套用公网代理那一套。
在终端里设 HTTP 和 HTTPS 代理
Clash 的混合端口一般 HTTP 和 SOCKS5 都支持,常见的是 7890,但实际端口一定要看客户端设置页上显示的值。终端工具最容易认的是 HTTP 代理的环境变量。很多命令发的虽然是 HTTPS 请求,HTTPS_PROXY 指向的却还是一个 HTTP 代理,所以别把请求用的协议和代理服务器用的协议搞混了。
在 macOS 或 Linux 当前的终端会话里,可以先临时设一下变量:
export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
export ALL_PROXY="socks5://127.0.0.1:7890"
export NO_PROXY="localhost,127.0.0.1,::1"
设好以后,先发个简单请求试试,别马上去跑大型安装:
curl -I https://github.com
curl -I https://raw.githubusercontent.com
env | grep -i proxy
curl 有返回,说明当前 Shell 起码能经代理访问目标网站;还是超时的话,同时去看 Clash 的连接日志。日志里看四样:请求的主机名、匹配到的规则、用的策略组、最终的节点。变量设了、日志里却根本没有这条请求,可能是程序没读这些变量;日志显示请求走了 DIRECT,就得调整规则顺序;请求进了代理但 TLS 失败,就换个节点或者查查系统时间。
想每次开终端都自动挂上代理,可以把变量写进 Shell 的配置文件。macOS 和多数 Linux 发行版用 zsh 时,一般是 ~/.zshrc,用 bash 的可能是 ~/.bashrc。不过最好先确定代理端口长期不变,再往启动文件里写。出差、换到公司网络或者关掉 Clash 的时候,写死的变量会让所有命令看起来都像「断网了」。
# Add only when Clash is always running
export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
export NO_PROXY="localhost,127.0.0.1,::1,*.local"
HTTP_PROXY 要填的是本机的监听地址,比如 http://127.0.0.1:7890,不能填机场的订阅 URL。订阅负责把节点和规则发下来,本地端口才是 Git、curl 等程序连进 Clash 的入口。
配置 Git 的 HTTPS 与 SSH 访问
Git 的远程地址常见两种:https://github.com/user/repo.git 和 [email protected]:user/repo.git。前一种一般可以直接用 Git 的 HTTP 代理设置,后一种是 SSH 流量,不会自动沿用 http.proxy。所以先确认仓库现在用的是哪一种:
git remote -v
git config --global --get http.proxy
git config --global --get https.proxy
HTTPS 仓库可以设一个全局代理:
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890
只想让 GitHub 走代理、不想牵连公司 GitLab 或局域网仓库的,可以按域名单独配:
git config --global http.https://github.com.proxy http://127.0.0.1:7890
git config --global https.https://github.com.proxy http://127.0.0.1:7890
这种写法适合手上同时有国内镜像、公司仓库和 GitHub 项目的开发者。设好以后,可以打开详细输出,看连接过程是怎么走的:
GIT_CURL_VERBOSE=1 git ls-remote https://github.com/example/project.git
习惯用 SSH 的,得先让 SSH 经由 Clash 的 SOCKS5 端口建连。OpenSSH 一般能调用本机的 nc,不过各系统自带的 netcat 参数不尽相同。比较常见的写法是这样:
Host github.com
HostName github.com
User git
Port 22
ProxyCommand nc -X 5 -x 127.0.0.1:7890 %h %p
ServerAliveInterval 30
ServerAliveCountMax 3
写进 ~/.ssh/config 以后,先把文件权限改对,再试一下握手:
chmod 600 ~/.ssh/config
ssh -T [email protected]
ssh -vT [email protected]
要是你系统里的 nc 不认 -X 5,可以换一个支持 SOCKS5 的工具,或者用 Clash 的 HTTP 混合端口再加一层 CONNECT 转发。别以为随手把 SSH 的 Port 22 改成 443 就一定能好;GitHub 有没有开放对应的入口、当前节点放不放行这个端口,都得看实际连接结果。调试时,ssh -vT 输出里的 Executing proxy command、密钥有没有加载上、最后握手成没成功,这几行最有参考价值。
团队已经统一用 SSH 密钥、签名和权限管理的,先把 SSH 调通;个人项目或者临时环境,用 HTTPS 搬来搬去更省事。不管选哪种,出口都要保持稳定,节点换得太勤,可能让 GitHub 弹出异常登录或要求重新认证。
让 Homebrew 的下载和更新也走 Clash
Homebrew 干的活不只是下一个安装包。跑 brew update 时,它可能要连 Homebrew 的 Git 仓库;跑 brew install 时,又可能去项目的 Release、镜像站或者源码地址拉文件。就算 GitHub 网页已经能正常打开,各个包实际从哪个域名下载、能不能不经代理直接连、会不会落进同一条规则,都说不准。
最省事的办法,是在同一个终端里先设好代理变量,再跑 Homebrew 命令:
export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
brew update
brew doctor
brew install wget
装之前可以先执行 brew config 看一下环境,重点核对 Homebrew 的路径、Git 和 curl 的版本、系统架构。更新卡住了,别一遍遍重复执行,失败多了可能留下下载到一半的缓存。打开详细输出,看具体停在哪个 URL,再回 Clash 日志里对规则。
- 卡在更新索引:先查 GitHub 仓库能不能访问、Git 的代理配置对不对。
- 卡在下载 bottle:看看实际是从哪个域名下的,可能是项目的 Release 或 CDN,并不是主站。
- 源码编译失败:先分清是网络出错、编译器报错还是依赖版本不对,别一律去换节点。
- 终端变量无效:看看 Homebrew 是不是被别的脚本、后台服务或图形界面拉起来的,确认它拿到了当前 Shell 的环境。
CI、远程开发机或者自动化脚本里,最好别把代理地址直接写死在仓库中。可以借助 CI 的 Secret、运行时的环境变量,或者机器层面的服务配置来注入。特别要留意,GitHub Actions、Docker 构建容器和你本机的终端不在同一个网络里:127.0.0.1 在容器里指的是容器自己,在远程 Runner 上更不会指向你的电脑。这种情况下要按运行环境给一个真正连得到的代理地址,同时把监听范围收窄,别让本地代理端口暴露到公网上。
验证、排错和安全上的底线
配完以后,从简单到复杂一步步验,别直接上来就拉一个大项目。第一步看 Clash 的本地端口有没有在监听;第二步用 curl 访问 GitHub;第三步试 Git 的只读请求;第四步试 SSH 握手;第五步再跑 Homebrew 的更新或安装。每一步都把终端输出和 Clash 规则匹配情况记下来,出了问题就能很快判断是客户端、规则、节点还是程序自己的配置有毛病。
- 到 Clash 面板看一眼:当前配置是启用的、mixed-port 处于监听状态,然后先锁住一个延迟和稳定程度都还行的节点。
- 执行
curl -I https://github.com,同时看连接日志,确认请求没被错误地分到DIRECT规则上。 - 执行
git ls-remote,HTTPS 仓库和 SSH 仓库各试一次,看两种协议是不是都走了你预想的路径。 - 跑一次
brew update,或者装一个小一点的软件,看会不会在索引、Release 或 bottle 下载哪一步失败。 - 都试通了,再决定要不要把代理变量写进 Shell 启动文件,或者把策略组从锁定节点改回自动选择。
Git 报 Could not resolve host 的,先看 DNS 和 Clash 的增强模式;提示 Failed to connect 或者连接超时的,查端口、节点和代理变量;出现 Permission denied (publickey) 的,那是 SSH 密钥或账号权限的问题,换节点解决不了;Homebrew 报校验和对不上的,别把校验关掉,先清掉没下完的缓存,再确认下载源有没有被替换过。
代理配置还牵涉到凭据安全。带用户名、密码或访问令牌的代理 URL,不要写进 Git 仓库、Shell 历史或者公开的 CI 日志;不要为了让 SSH 不报错就关掉主机密钥检查;也不要从来路不明的脚本里整段复制所谓「一键配好代理」的命令。临时的活干完了,可以把留下来的配置检查一遍、清理掉:
git config --global --unset http.proxy
git config --global --unset https.proxy
unset HTTP_PROXY HTTPS_PROXY ALL_PROXY
如果是在单位网络里,或者登在远程主机上干活,还得守单位的安全规定。代理只是让连接换条路走,权限审批、代码审查、密钥保管、核实依赖从哪来,它一样都替代不了。私有仓库要讲清楚哪些地址走单位的 VPN、哪些外部服务交给 Clash,需要时用 NO_PROXY 把内网地址排除在外,免得代码请求意外从第三方出口出去。
客户端、节点、端口、DNS、Git 配置,别一起换。先锁定节点,再看规则匹配;规则定了,再验终端变量;最后才去比 HTTPS 和 SSH。这样得出的结论,换个项目、换台设备也能用。
有些代理工具只做浏览器扩展,或者只支持一种协议,开发者一到 Git、SSH、Homebrew 和容器环境里,就常碰到配置散在各处、端口对不上、换了节点连接就断、出了故障又没日志可查这些麻烦。Clash 的规则和连接日志能帮你看清 GitHub、Release 和依赖下载各自从哪个出口出去。想少在这些重复的代理细节上花时间,可以先去下载页装好客户端,再照上面的步骤把 Git、SSH 和 Homebrew 一个个接上。