最近复核 2026-11-18测速批次 2026-08-11收录 71 家 · 实测 17 家

终端 / git / npm 代理设置:命令行走机场代理的完整方法

使用教程 · 发布 2026-09-16 · 更新 2026-11-18 · 约 7 分钟读完

快速答案

命令行工具默认不读系统代理。临时生效可执行 export https_proxy=http://127.0.0.1:7897 等环境变量(端口以客户端为准);git、npm、pip 也可单独写入配置。最省事的办法是在客户端开启 TUN 模式,所有程序自动走代理。

目录为什么终端不走代理先找到本地代理端口macOS / Linux:设置环境变量Windows:PowerShell 与 CMDgit 代理npm、pnpm、yarn、pip 与 DockerAI 编程工具的代理常见报错与排查小结常见问题

为什么终端不走代理

浏览器能翻墙、终端里 git clone 却卡住,这是最常见的困惑之一。原因是:客户端的“系统代理”只是修改了操作系统的代理设置,大多数命令行工具不读取这个设置,而是看 http_proxy、https_proxy、all_proxy 这几个环境变量,或者各自的配置文件。

解决方法有两类:

  • 设置代理环境变量 / 工具配置:精确控制,适合开发者。
  • 开启 TUN 模式:一劳永逸,所有程序都被接管,见规则 / 全局 / TUN 模式。

先找到本地代理端口

环境变量需要填写客户端监听的本地端口:

客户端默认端口(截至 2026 年常见默认)查看位置
Clash Verge Rev混合端口 7897设置 → 端口设置
Mihomo Party混合端口 7890 左右内核设置
v2rayN本地 HTTP / SOCKS 端口(如 10808、10809)参数设置 → Core 基础设置
FlClash7890设置 → 网络

下文示例都以 7897 为例,请替换成你客户端里显示的端口。端口被占用的问题见端口冲突。

macOS / Linux:设置环境变量

当前终端临时生效:

export https_proxy=http://127.0.0.1:7897
export http_proxy=http://127.0.0.1:7897
export all_proxy=socks5://127.0.0.1:7897

取消:

unset https_proxy http_proxy all_proxy

想每次方便开关,可以在 ~/.zshrc(或 ~/.bashrc)里写两个函数:

proxy_on() {
  export https_proxy=http://127.0.0.1:7897 http_proxy=http://127.0.0.1:7897 all_proxy=socks5://127.0.0.1:7897
  export no_proxy=localhost,127.0.0.1,::1
  echo "proxy on"
}
proxy_off() {
  unset https_proxy http_proxy all_proxy no_proxy
  echo "proxy off"
}

保存后执行 source ~/.zshrc,之后输入 proxy_on 即可。验证是否生效:

curl -I https://www.google.com

返回 HTTP/2 200 或 301/302 等状态码就说明通了。Clash Verge Rev 的界面里通常也有“复制环境变量”按钮,可以直接粘贴。

Windows:PowerShell 与 CMD

PowerShell 当前窗口:

$env:HTTP_PROXY="http://127.0.0.1:7897"
$env:HTTPS_PROXY="http://127.0.0.1:7897"

CMD 当前窗口:

set http_proxy=http://127.0.0.1:7897
set https_proxy=http://127.0.0.1:7897

想永久生效,可在“系统属性 → 环境变量”里新增用户变量,但这样关掉客户端后命令行会连不上网,建议只在需要时开启。Windows 客户端选择见 Windows 机场客户端。

git 代理

git 的 HTTPS 方式会读取环境变量,也可以单独配置:

git config --global http.proxy http://127.0.0.1:7897
git config --global https.proxy http://127.0.0.1:7897
# 取消
git config --global --unset http.proxy
git config --global --unset https.proxy

只给 GitHub 设置代理、其他仓库直连:

git config --global http.https://github.com.proxy http://127.0.0.1:7897

SSH 方式([email protected]:)不读这些设置,需要在 ~/.ssh/config 里配置:

Host github.com
  HostName ssh.github.com
  Port 443
  User git
  ProxyCommand nc -X 5 -x 127.0.0.1:7897 %h %p

Windows 下可以把 nc 换成 Git 自带的 connect 命令。

npm、pnpm、yarn、pip 与 Docker

工具设置命令
npm / pnpmnpm config set proxy http://127.0.0.1:7897 和 npm config set https-proxy http://127.0.0.1:7897
yarn(v1)yarn config set proxy http://127.0.0.1:7897
pippip install 包名 --proxy http://127.0.0.1:7897
Homebrew读取环境变量,先 proxy_on 再执行
Docker 拉镜像在 Docker Desktop 的 Resources → Proxies 中填写,或给 dockerd 配置代理

取消 npm 代理:npm config delete proxy 和 npm config delete https-proxy。如果你本来就使用国内 npm 镜像,就不需要给 npm 设置代理,两者混用反而可能变慢。

Docker 容器内部访问宿主机代理时,127.0.0.1 指的是容器自己,要改用 host.docker.internal,并在客户端开启“允许局域网连接”。

AI 编程工具的代理

Claude Code、Codex CLI、Gemini CLI 等命令行 AI 工具同样依赖环境变量。启动前先 proxy_on,并选择 AI 服务支持地区的节点(避开香港)。详细配置见 Claude Code 安装与代理配置、Codex 使用教程,编辑器类工具见 Cursor 代理设置。

这类工具长时间保持连接、请求频繁,对线路稳定性要求较高。程序员用户可以参考品牌资料中说明了 AI 场景的品牌,例如定位“AI 工具优先”的速界(25 元/月 150GB),或 18 元/月的光年梯;品牌资料显示覆盖 AI 使用场景,实际可用性受节点 IP、地区和平台策略影响。

常见报错与排查

报错原因处理
Failed to connect to 127.0.0.1 port 7897客户端没开或端口不对确认客户端运行、核对端口
Connection timed out没设代理或节点不可用检查环境变量、换节点
SSL certificate problem代理或公司网络中间人证书不要关闭证书校验,先换网络或检查代理设置
关掉客户端后命令行全断代理配置写成了永久执行 unset 或删除 git / npm 代理配置

小结

终端代理的关键是“环境变量 + 工具单独配置”,或者干脆开启 TUN 模式。设置一次 proxy_on / proxy_off 函数,日常开发就很顺手了。如果你是重度开发者、经常使用 AI 编程工具,选择一家线路稳定的机场同样重要,可以看AI 机场推荐或机场推荐总榜。

常见问题

为什么开了机场浏览器能用,终端却不行?

系统代理只对读取系统代理设置的程序生效,终端工具通常只看 http_proxy、https_proxy 等环境变量。设置环境变量或开启 TUN 模式即可。

git clone 很慢怎么设置代理?

HTTPS 方式执行 git config --global http.proxy http://127.0.0.1:端口;SSH 方式需要在 ~/.ssh/config 中用 ProxyCommand 指定代理。

代理端口是多少?

以客户端设置为准,Clash Verge Rev 常见默认混合端口为 7897,FlClash 常见为 7890,v2rayN 在参数设置中查看。

Claude Code 怎么走代理?

启动前在终端设置 https_proxy 和 http_proxy 环境变量,并选择支持地区的节点。详细步骤见Claude Code 安装与代理配置。

npm 设置代理后关掉客户端就装不了包?

因为代理写进了 npm 配置,执行 npm config delete proxy 和 npm config delete https-proxy 即可恢复直连。

还没选好机场?看 2026 机场推荐总榜,或按需求:便宜 · 稳定 · ChatGPT / Claude · 新手

使用教程 · 继续阅读

机场怎么选:按预算、用途和线路挑到合适的机场

先定预算和每月用量,再看线路(优先 IEPL 专线)、运营年限和付费方式:月预算 10 元以内选年付专线老牌,15–20 元选月付 IEPL,AI 重度用户选标明 AI 场景的品牌。首次购买建议先月付或买最小套餐试用一个月。

机场注册购买全流程:注册、选套餐、优惠码、支付、导入一次讲清

机场购买分六步:用邮箱注册账号 → 在商店选择套餐和付费周期 → 结算页填写优惠码 → 用支付宝 / 微信 / USDT 付款 → 在仪表盘复制订阅链接 → 导入 Clash、Shadowrocket 等客户端并更新。全程约 10 分钟。

机场订阅链接导入与更新:Clash、Shadowrocket、v2rayN 全平台步骤

在机场面板复制订阅链接,打开客户端的“订阅 / 配置”页,新建订阅并粘贴链接,点击更新即可看到节点。建议把自动更新间隔设为 12–24 小时,换节点或续费后手动更新一次。

订阅转换:把机场订阅转成 Clash、sing-box 等格式的方法

订阅转换就是把机场提供的订阅格式(如 Base64 通用订阅)转成目标客户端能识别的格式(如 Clash YAML、sing-box JSON)。优先使用机场面板自带的对应格式;确需转换时,建议在本地运行 subconverter,而不是把订阅交给陌生在线网站。

规则 / 全局 / 直连 / TUN 模式:机场客户端代理模式怎么选

日常用“规则模式 + 系统代理”即可:国内网站直连、境外网站走代理。全局模式让所有流量走代理,仅在排查问题时临时用。TUN 模式通过虚拟网卡接管不走系统代理的程序(终端、游戏、部分桌面软件),需要时再开。

节点切换与自动选择:手动选节点、url-test、fallback 一次讲清

日常按用途手动选节点:网页视频选香港,AI 工具选日本、新加坡或美国,并固定使用同一节点。想省心可用 url-test 策略组自动选延迟最低的节点,或用 fallback 在当前节点故障时自动切换。