终端 Git 与 curl 走 Clash:Windows http_proxy 环境变量(2026)
症状:浏览器一切正常,终端里的 git、curl 却一直超时
不少开发者都遇到过这种分裂:Edge / Chrome 打开 GitHub、npm registry 或境外文档站都没问题,桌面上的 Clash(或 Verge / Meta 系图形客户端)也显示正在运行;可一切到 PowerShell、CMD 或 Git Bash,跑 git clone、curl https://... 或者某些语言的包管理器下载,要么半天没动静,要么干脆提示超时。不少人以为「开了系统代理」或者「勾了 TUN」就该管到整台电脑的所有进程——可终端里的程序多半根本不看浏览器用的那份 PAC 脚本,也不一定理会你在图形界面里设的「只对浏览器生效」的扩展;它们更常见的做法,是去读进程环境中的 HTTP 代理变量,或者用各自的配置文件(比如 Git 的 http.proxy)。这一环没接上,就会出现「浏览器能上外网,脚本和仓库却一直在直连」的落差。
这里只讲原生 Windows 会话(宿主机上直接开的终端):怎么把流量明确指到本机 Clash 监听的 mixed-port(常见的例子是 7890,以你自己的配置为准)。它和站里第 21 篇 WSL2 里让 apt、git 走宿主机 Clash 正好互补:那篇处理的是WSL 里怎么找到宿主机的地址;这篇处理的是Windows 自己的终端怎样经 127.0.0.1 连到那个 mixed-port,两边的变量别混在一起查。
HTTP_PROXY / HTTPS_PROXY;给 Git 单独配代理,或者让它跟全局变量保持一致,并且能用一条 curl 命令验证,再按情况分头排查。 系统代理已经打开,终端为什么还是不走 Clash
Windows「设置 → 网络和 Internet → 代理」这里,不管填的是手动代理还是脚本地址(PAC),主要是给走 WinHTTP / 系统代理那一套的应用用的(不少 Chromium 内核的浏览器就接的这一套)。可很多控制台程序历来更接近 Unix 的习惯:先去看那些大小写不完全统一的 HTTP_PROXY、HTTPS_PROXY、http_proxy、ALL_PROXY 环境变量;有的工具只认其中几个,个别的甚至不理全局变量,非得你在参数里明确传进去。Clash 开了TUN 模式、或者用虚拟网卡接管了路由时,确实能让更多进程在 IP 层「看起来像全局走代理」,但不是每一种命令行场景都能不经调试就立刻生效——版本差异、DNS、IPv6,还有进程到底走没走虚拟网卡,都会影响你看到的结果。所以更稳的做法依然是:在你正在用的这个终端窗口里,把代理明明白白写进去,排查时再去对照连接日志。
想全面了解「路由层接管」和策略分流,可以同时看 Clash TUN 模式详解;这一篇有意只停在本地 HTTP 端口、环境变量和 Git 设置这一层,方便直接复制粘贴,团队里也好统一做法。
先确认:mixed-port、监听地址和本机能不能连上
填任何代理地址之前,先在 Clash 图形客户端或者配置文件里看清mixed-port(或单独开的 HTTP 端口)是几号,再核实这个端口上真有程序在听。要是客户端报端口被占、内核起不来,先照 端口 7890 被占、mixed-port 冲突的处理办法 解决,免得你在这边改环境变量,那边端口压根没起来。
对只在同一台 Windows 上开的终端来说,代理地址一般写 http://127.0.0.1:端口 就行:跟 WSL2 不同,这里不需要去算宿主机的 IPv4。前提是 Clash 在本机回环地址上接受入站连接——大部分默认配置都是这样。如果你在客户端里把监听改成了只监听某块网卡或某个指定 IP,就以实际监听的地址为准。
PowerShell:只在当前会话生效的变量(临时)
适合「只在这个窗口里克隆或调试一下」的情况:打开 PowerShell,先设几个只有这个窗口看得见的环境变量(窗口一关就没了):
# Replace 7890 with your Clash mixed-port
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:ALL_PROXY = "http://127.0.0.1:7890"
HTTPS 流量之所以也常写成 http://127.0.0.1:端口,原因是它指向的是本机代理用 CONNECT 方法开隧道的那个口子,并不是「用明文 HTTP 直接连境外」。curl、Git 和大多数包管理器都是这个惯例。
然后在同一个窗口里验证:
curl.exe -v https://www.google.com/generate_204
能看到 TLS 握手完成、返回码也正常,就说明curl 已吃到代理变量。还是直连失败的话,可以再对比一下:curl.exe -v -x http://127.0.0.1:7890 https://...,强制指定代理,好分清是「变量没生效」还是「端口连不上」。
PowerShell:写进用户环境变量(新开的终端也有效)
想让从桌面或开始菜单打开的终端默认就带着代理,可以把变量写进当前用户的环境变量(很多时候连管理员权限都用不着):在 PowerShell 里运行 [Environment]::SetEnvironmentVariable(...),或者到「系统属性 → 环境变量」里手动加上 HTTP_PROXY、HTTPS_PROXY 两项。有个坑:写之前就开着的 IDE 和终端读不到新值,关掉再开才行。
团队里如果要在「整天开代理」和「只在某个会话里翻墙」之间切换,大家更常干脆不往系统里写永久变量,改成在项目文档里放一组开会话时敲的命令;或者让脚本第一行就用 $env:... 设好,这样同事拉内网仓库时就不会被误塞进隧道。
CMD:set 与 setx
在命令提示符里只对当前窗口生效:
set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890
想用 setx 写用户级持久变量的话,要知道 setx 的几个脾气:对眼下这个 CMD 窗口不起作用,得另开一个;值太长还可能被截掉一截,微软的文档里写了上限。写之前最好先备份原来的用户变量,或者先去图形界面里看一眼。
NO_PROXY:别让内网和国内镜像也被送进隧道
把全局代理指向境外节点的时候,一定要同时维护一份例外列表:在 NO_PROXY(或 no_proxy)里写上公司的 Git、私有 npm/registry、局域网里的主机名等等。示例如下(按需增删):
# PowerShell session example
$env:NO_PROXY = "localhost,127.0.0.1,::1,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16,.corp.example.com"
不然很容易碰到「国外网站能上,自家镜像反倒拉不下来」这种反常的故障——毛病不在 Clash,而是该直接连的流量被错送去了代理出口。
Git 代理:git config 和环境变量怎么共存
远端仓库用 https:// 地址时,Git 会参考 http.proxy / https.proxy,也会继承环境里的代理变量(谁优先在不同 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 --local http.proxy ""
git config --local https.proxy ""
如果你用的是 [email protected]:user/repo.git 这种 SSH 地址,HTTP 代理变量不会接管 SSH 的 TCP 连接;想让 SSH 也走本地代理,得另外配 ProxyCommand 或类似的办法——这就不是「填个 mixed-port 就完事」的范围了,很多主要克隆海外公开仓库的团队,干脆把远端改成 HTTPS,省得多操心。
Git Bash / MSYS:继承 Windows 变量与 export
Git Bash 要是从开始菜单打开,通常能拿到写在 Windows 用户环境变量里的 HTTP_PROXY 这些值;可你若只在某个 PowerShell 窗口里临时设了 $env:...,Git Bash 不会自动共享那个会话里的设置。要在 Bash 里生效,可以直接这样:
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
这两行也能放进 ~/.bashrc,但它会持续作用于这个环境里的每个交互 shell。CI 和自动化脚本更适合在调用前临时 export,别指望个人登录会话里的设置。
验证按这个次序:curl、Git、最后才是业务脚本
别急着去 clone 体积很大的仓库,先拿最小命令把链路试通:用 curl 或 curl.exe(Git Bash 下想避开 MSYS 改写路径,多半直接敲 curl.exe),接着跑 git ls-remote https://...,都过了再执行要拉外部源的构建脚本。哪一步卡住,就去看 连接日志与规则命中,确认请求有没有进到 Clash、落在哪条规则上,这样定位比怀疑账号或 SSH key 快得多。
常见误区小结
误以为 mixed-port「只能 SOCKS」
按主流内核的定义,mixed-port 会在一个端口上同时提供 HTTP 和 SOCKS 两种入站。curl、Git 和大部分开发工具填 http://127.0.0.1:端口 指过去就行。碰到只认 SOCKS 的工具,再换成 socks5://127.0.0.1:端口,并照它的文档逐项核对。
只依赖浏览器插件
插件接管的基本只是浏览器标签里的 HTTP(S) 请求,终端里的进程本来就不经过插件。命令行想稳定走代理,就靠系统环境变量或 Git 自身的配置,别盼着插件规则能管到浏览器外面。
代理变量忘了撤,内网访问出问题
写成用户级持久变量的 HTTP_PROXY,在你连上公司 VPN 或回家用局域网时照样会生效。哪天内部仓库忽然打不开,先查有没有残留的代理设置,再看 NO_PROXY 写得对不对。
Windows 客户端还没装好的话先看安装教程
要是 mixed-port 和订阅导入都还没弄好,先照 Clash Verge Rev Windows 教程 把最基础的流程跑通,再回来配终端变量。不然很容易遇到变量全写对了、内核却根本没在监听的情况,看起来像成功其实没通。
和东拼西凑几个临时工具比,开源内核在长连接和分流细度上更省心。多人协作的仓库、CI 里统一代理写法时,事先约定好一个固定的 HTTP 代理端口,能少很多来回解释。想让浏览器以外的程序也走同一个出口,与其在脚本里写死境外 IP,不如团队都认本机 mixed-port 这一个入口,境内外怎么分交给规则文件。
要查 YAML 字段或策略组的含义,翻本站 使用文档中心 就行;给这台电脑挑一款持续更新的图形客户端和内核,去 Clash 客户端下载页 看对应平台的安装说明,安装包取自官方 GitHub 发布页,不必只盯着 Release 页面。→ 去下载页挑选 Clash 客户端