外观模式
Windows 终端(Git / npm / pip / curl)不走代理完整配置指南
直接结论:大多数开发工具与终端命令行不会自动读取 Windows 浏览器的“系统代理”设置,因此常出现“浏览器秒开 Google,终端一跑
git clone或pip就超时”的现象。彻底解决只有两条路径:① 开启 Clash Verge Rev 的 TUN 虚拟网卡模式,从系统网卡层面强制接管全部进程;② 保持轻量系统代理,在当前终端或工具中注入http://127.0.0.1:7897(注意:即使变量名是HTTPS_PROXY,右侧协议头也必须写http://而非https://)。
一、第一步:核对本机客户端真实监听端口
不同客户端默认的本地监听端口各不相同,照抄固定数字极易连不上。操作前请先打开你的代理软件查看真实端口:
- Clash Verge Rev / FlClash:进入 【设置】 → 查看 【混合端口(Mixed Port)】,默认多为
7897(老用户手动改过或从 CFW 迁移过来的可能是7890); - v2rayN:查看软件主界面最底部状态栏,通常同时显示本地 HTTP 端口
10809与 SOCKS 端口10808; - 开启
Allow LAN/ 局域网共享注意:本机终端连接自己电脑上的客户端一律填写127.0.0.1:<端口>即可。下文以7897为例演示,若你的端口为7890或10809请自行替换数字。
二、五大常见命令行工具精确配置命令
1. PowerShell(仅当前窗口即时生效,关闭自动清理最干净)
powershell
$env:HTTP_PROXY="http://127.0.0.1:7897"
$env:HTTPS_PROXY="http://127.0.0.1:7897"
# 用 curl.exe 测试外网连通性(注意 Windows PowerShell 中直接敲 curl 其实是 Invoke-WebRequest 别名)
curl.exe -I https://www.google.com如果同一个窗口临时需要撤销代理(例如切回拉取国内内网仓库):
powershell
Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue2. 传统 CMD 命令提示符
cmd
set http_proxy=http://127.0.0.1:7897
set https_proxy=http://127.0.0.1:7897(同样在关闭当前 CMD 黑框后自动失效,不会污染全局系统环境。)
3. Git 仅针对 GitHub 走代理(强烈推荐,不影响国内 Gitee 与内网 GitLab)
把整个 http.proxy 设为全局容易导致平时访问公司内网 GitLab 报错,最佳实践是按域名精确配置:
bash
# 仅针对 github.com 走本地代理(支持 HTTPS 克隆与推送)
git config --global http.https://github.com.proxy http://127.0.0.1:7897
# 若习惯用 SSH 方式 ([email protected]:user/repo.git) 拉取代码,在 ~/.ssh/config 加入:
# Host github.com
# HostName ssh.github.com
# Port 443
# ProxyCommand connect -H 127.0.0.1:7897 %h %p
# 如以前配过全站代理想彻底清理掉,执行:
git config --global --unset http.proxy
git config --global --unset https.proxy4. Python pip / uv 与 Node npm / pnpm
- Python
pip单次加速:无需改系统变量,直接临时传参:pip install <包名> --proxy=http://127.0.0.1:7897; - 现代包管理器
uv/npm:同样建议优先在当前 PowerShell 窗口注入$env:HTTP_PROXY与$env:HTTPS_PROXY,拉取完 HuggingFace 模型、GitHub 依赖或海外私有包即可。切忌把本地代理端口死写入~/.npmrc或系统永久环境变量里,否则哪天忘记开代理软件,执行任意安装命令都会直接报ECONNREFUSED 127.0.0.1:7897。
三、高频 AI CLI 与容器开发场景:为什么直接开 TUN 更省心?
如果你日常重度使用 Docker Desktop 拉取镜像、Claude Code、Gemini CLI、OpenAI SDK、Go modules 或 Homebrew / WSL2,手动一个个去改每个工具的代理配置极其繁琐,甚至部分子进程完全不理会 HTTP_PROXY 变量:
- 这种开发工作流的最优解是直接在 Clash Verge Rev → 服务模式 → 打开【TUN 模式】,把流量拦截下沉到操作系统虚拟网卡层;
- 同时结合 Clash AI 专属策略组教程,将国内代码镜像站放进直连规则、将海外模型 API 与 GitHub 稳定路由至低风控的新加坡或美国节点(如 光速云、一翻云 等支持标准 YAML 规则的专线机场)。
常见问题 FAQ
为什么 Clash Verge 的混合端口有时是 7897,有时教程里写 7890?
7890 是早年 Clash for Windows 的默认端口,而新版 Clash Verge Rev 为避免冲突通常默认使用 7897。配置任何终端命令前,请先打开你的软件【设置】页面查看当前显示的“混合端口(Mixed Port)”真实数字。
设定了环境变量后,为什么 npm install 或 git clone 报 SSL certificate problem 错误?
通常是因为错误把 HTTPS_PROXY 写成了 https://127.0.0.1:7897(协议头多了一个 s)!本地代理监听接口是明文 HTTP 协议转发加密隧道,因此无论是 HTTP_PROXY 还是 HTTPS_PROXY,值都必须写成 http://127.0.0.1:7897。
为什么我已经把 $env:HTTP_PROXY 设好了,还是提示连接被拒绝(Connection refused)?
请按顺序检查三处:1)Clash Verge Rev、FlClash 或 v2rayN 是否真正在后台运行;2)设置的端口号是否与客户端内“混合端口/Mixed Port”完全一致;3)Windows 环境变量是只在当前终端会话注入的,如果新开了一个终端窗口需要重新注入,或改用 TUN 虚拟网卡全局接管。