Skip to content
Clash 客户端发布:2026-10-19更新:2026-11-19作者:机场一哥编辑部

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 SilentlyContinue

2. 传统 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 方式 (git@github.com: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.proxy

4. 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 虚拟网卡全局接管。
透明度与合规提示: 合规与利益披露:本站部分品牌注册入口含推广链接(rel="nofollow sponsored noopener"),通过链接注册可能为本站带来佣金,不影响用户实际支付价格。商业合作优先级不改变客观事实标注、实测日期与风险提示。