终端 / 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 基础设置 |
| FlClash | 7890 | 设置 → 网络 |
下文示例都以 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 / pnpm | npm 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 |
| pip | pip 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 设置代理,两者混用反而可能变慢。
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 即可恢复直连。
使用教程 · 继续阅读
机场怎么选:按预算、用途和线路挑到合适的机场
先定预算和每月用量,再看线路(优先 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 在当前节点故障时自动切换。