11号登机口GATE 11 · 机场推荐与选购笔记
使用教程 · 开发者

终端走代理教程(2026):命令行、Git、npm、pip、Docker 代理设置

终端走代理教程:开了代理,Git、npm、pip、Docker 仍连不上,是因为命令行工具不读系统代理。本文讲 macOS、Linux、Windows 终端怎么设置代理,Git、npm、pip、Docker 的代理写法,编辑器内置终端的处理,以及终端代理不生效的报错对照。

更新于 约 7915 字 · 18 分钟读完11号登机口编辑
快速结论

这篇终端走代理教程先说结论:命令行工具大多不读系统代理,要么用 http_proxy、https_proxy、all_proxy 环境变量把它们指向客户端的本地端口,要么在 Git、npm、pip 里单独配置;端口以客户端显示的混合端口为准,常见如 7890 或 7897。Docker 拉镜像要配在守护进程上,SSH 要用 ProxyCommand。不想逐个设置,就直接打开客户端的 TUN 模式。 终端代理不生效时,先用 curl -x 测本地端口,再用 env | grep -i proxy 看变量有没有在当前窗口生效,最后才查具体工具的配置。

终端走代理教程:为什么开了代理,终端还是连不上

代理客户端打开「系统代理」后,做的事情只是把一个本地地址写进操作系统的网络设置。浏览器和大多数图形界面软件会主动读取这项设置,但命令行工具通常不会。git、curl、npm、pip 各有各的网络库,它们只认环境变量或者自己的配置文件。

所以让终端走代理,一共三条路:

方式 作用范围 优点 缺点
环境变量 当前终端里启动的、愿意读取变量的程序 一处设置,多数工具生效,随开随关 有的工具不认;SSH、Docker 守护进程不吃这一套
工具自己的代理配置 单个工具 精确,不影响别的程序 每个工具都要配,容易忘记取消
TUN 模式 整台电脑的所有流量 一个开关全部解决 需要管理员权限,偶尔和其他 VPN 类软件冲突

前提是代理客户端已经装好并能正常使用。还没配好的话,先看 Clash Verge Rev 教程或 v2rayN 教程;Linux 服务器上没有图形界面,见 mihomo 命令行教程。

第一步:确认端口,学会验证

**找端口。**在客户端的设置页找「混合端口」或「端口设置」。混合端口的意思是同一个端口同时接受 HTTP 和 SOCKS5 两种代理请求。端口以客户端显示的混合端口为准,常见如 7890、7897。下文统一写 7890,照抄时换成你自己的数字。有些客户端把 HTTP 和 SOCKS 分成两个端口,那就分别对应填写。

**验证方法。**不要用 ping,它走的是 ICMP,任何代理设置都管不到它,ping 不通不说明代理有问题。用 curl:

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

返回 HTTP 状态行就是通了。想单独测试代理端口本身、不依赖环境变量,可以显式指定:

curl -I -x http://127.0.0.1:7890 https://www.google.com

第二条通、第一条不通,说明端口没问题,是环境变量没生效。两条都不通,问题在客户端或节点,按节点超时怎么办排查。

Windows 的旧版 PowerShell 里,curl 是另一个命令的别名,行为不同,请写成 curl.exe。

macOS 和 Linux 终端怎么设置代理:环境变量

在终端里执行:

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export all_proxy=socks5://127.0.0.1:7890
export no_proxy=localhost,127.0.0.1,::1

四个变量的含义:

变量 作用
http_proxy 访问 http:// 地址时使用的代理
https_proxy 访问 https:// 地址时使用的代理。注意它的值仍然以 http:// 开头,表示用 HTTP 方式连接本地代理
all_proxy 其他协议的兜底代理,一般填 SOCKS5 地址
no_proxy 不走代理的地址列表,本机和内网地址写在这里

几个细节:

  • **大小写。**不同工具认的写法不一样,有的只认小写,有的只认大写。稳妥的做法是两种都设,即再加一组 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY、NO_PROXY。
  • **只在当前窗口有效。**关掉终端就没了,新开的窗口也没有。这其实是优点,不会留下后遗症。
  • **socks5 和 socks5h。**前者由本机解析域名,后者把域名交给代理去解析。域名解析结果不对时,把 all_proxy 的开头换成 socks5h:// 试试。背后的原理见 DNS 泄漏。
  • **内网地址。**公司内网的代码仓库、私有镜像源要加进 no_proxy,否则这些请求会被送到境外节点,要么连不上,要么白白消耗流量。

想随时开关,把下面两个函数写进 ~/.zshrc 或 ~/.bashrc,保存后执行 source ~/.zshrc,之后输入 proxy_on、proxy_off 即可:

proxy_on() {
  export http_proxy=http://127.0.0.1:7890
  export https_proxy=http://127.0.0.1:7890
  export all_proxy=socks5://127.0.0.1:7890
  export HTTP_PROXY=$http_proxy HTTPS_PROXY=$https_proxy ALL_PROXY=$all_proxy
  export no_proxy=localhost,127.0.0.1,::1 NO_PROXY=localhost,127.0.0.1,::1
}
proxy_off() {
  unset http_proxy https_proxy all_proxy no_proxy
  unset HTTP_PROXY HTTPS_PROXY ALL_PROXY NO_PROXY
}

不建议把 export 直接写进配置文件让它永久生效。客户端一旦没开,所有命令都会报连接被拒绝,而你很可能想不起来是这几行造成的。

另外,sudo 默认不继承当前用户的环境变量。需要时用 sudo -E 带上,或者给对应的工具单独配置。

终端代理环境变量是约定,不是标准

结论:http_proxy 这组变量没有一个统一的规范,各工具认哪几个、认大写还是小写、怎么理解 no_proxy,都由各自的网络库决定。所以「设了变量但某个工具不生效」很常见,不一定是你写错了。

几个有代表性的差异(以各工具当前版本的官方文档为准):

工具或运行环境 读取环境变量的情况
curl http:// 地址只认小写 http_proxy,不认大写;https_proxy、all_proxy 大小写都认
wget 读小写变量,也可以在 ~/.wgetrc 里配置
Git(HTTPS 地址) 读 http_proxy、https_proxy、all_proxy,http.proxy 配置优先
Python 的 requests 等库 大小写都读,也读 no_proxy
Go 程序 读 HTTP_PROXY、HTTPS_PROXY、NO_PROXY,大小写都认;访问本机地址时不走代理
Node.js 自带网络模块 传统上不读环境变量,需要程序自己处理,较新版本是否提供相关选项以官方文档为准

最后一行是很多人的困惑来源:npm 自己会读代理配置,但你写的 Node.js 脚本里直接用 fetch 访问外网,可能完全不理会环境变量。这种情况要么在代码里显式配置代理,要么开 TUN。

http、socks5 与 socks5h:域名在哪里解析

结论:三种写法的区别在于「谁来解析域名」和「用什么方式连接本地代理」。日常用 http:// 最省事,遇到解析问题再换 socks5h://。

写法 连接本地代理的方式 域名由谁解析 适合
http://127.0.0.1:7890 HTTP 代理(HTTPS 请求用 CONNECT 隧道) 由代理解析 绝大多数工具
socks5://127.0.0.1:7890 SOCKS5 本机先解析,再把 IP 交给代理 支持 SOCKS 的工具,且本机 DNS 正常
socks5h://127.0.0.1:7890 SOCKS5 把域名原样交给代理解析 本机解析结果被污染或不准确时

socks5:// 的问题在于,本机解析出的地址可能已经不对,代理拿到错误的 IP 也无能为力,表现为连接超时或证书错误。socks5h 这个写法并非所有工具都认识,不认识时会直接报错,换回 http:// 即可。

no_proxy 怎么写:各家解析规则不同

结论:no_proxy 里写域名后缀和具体 IP 最稳妥,网段(CIDR)、通配符和前导点的写法在不同工具里支持程度不一,写了不生效时先换成最朴素的写法。

  • 域名后缀:写 example.com 通常会匹配它本身和子域名;部分工具对 .example.com 这种前导点写法的理解不同,两种都写上最稳妥。
  • IP 和网段:127.0.0.1、::1 基本都认;192.168.0.0/16 这样的网段写法,有的工具支持,有的只把它当成普通字符串。
  • 通配符:单独写一个 * 在多数工具里表示「全部不走代理」,常被用来临时关闭代理。
  • 内网域名:公司内部的代码仓库、镜像源、*.local 这类域名都要写进来,避免被送去境外节点。

不确定某个工具怎么解析时,用它访问一个应该直连的内网地址,同时看代理客户端的连接列表里有没有出现这个请求,有就说明 no_proxy 没生效。

不同 shell 的终端代理写法:zsh、bash 与 fish

结论:export 写法适用于 zsh 和 bash,fish 的语法不同,函数要放进各自的配置文件才会在新窗口里可用。先执行 echo $SHELL 确认自己用的是哪一种。

shell 设置变量的写法 函数放在哪个文件
zsh(macOS 默认) export http_proxy=http://127.0.0.1:7890 ~/.zshrc
bash(多数 Linux 默认) 同上 ~/.bashrc,登录 shell 可能读 ~/.bash_profile
fish set -gx http_proxy http://127.0.0.1:7890,取消用 set -e http_proxy ~/.config/fish/config.fish 或 functions 目录

bash 有一个容易踩的坑:macOS 上的终端默认以登录 shell 启动,读的是 ~/.bash_profile 而不是 ~/.bashrc,函数写错文件就会「新窗口里找不到命令」。常见做法是在 ~/.bash_profile 里加一行加载 ~/.bashrc。改完配置文件后,执行 source 或新开一个窗口才会生效。

Windows 终端怎么设置代理:PowerShell、CMD 与 WSL

PowerShell 里这样写,同样只对当前窗口有效:

$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:ALL_PROXY = "socks5://127.0.0.1:7890"
$env:NO_PROXY = "localhost,127.0.0.1"

取消:

Remove-Item Env:HTTP_PROXY, Env:HTTPS_PROXY, Env:ALL_PROXY, Env:NO_PROXY

传统的命令提示符(CMD)语法不同:

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

想做成开关,可以把设置和取消分别写成两个函数,放进 PowerShell 的配置文件里,文件路径用 $PROFILE 查看。不建议通过系统的「环境变量」对话框永久写入,理由同上。

**WSL 要多留意一点。**WSL 2 默认的网络模式下,子系统里的 127.0.0.1 指的是子系统自己,不是 Windows。代理客户端运行在 Windows 上时有两种做法:在客户端里打开「允许局域网连接」,然后在 WSL 里把代理地址写成 Windows 主机的地址;或者启用 WSL 的镜像网络模式,让两边共用 127.0.0.1。后者对系统版本有要求,具体配置以微软官方文档为准。更省事的是在 Windows 的客户端里打开 TUN,WSL 的流量通常会一并被接管。

Git 设置代理:HTTPS 和 SSH 是两回事

先看仓库地址是哪一种:https:// 开头的走 HTTPS,git@ 开头的走 SSH。两者的代理设置完全不同。

HTTPS 方式会读取环境变量,也可以写进 Git 自己的配置:

git config --global http.proxy http://127.0.0.1:7890

这会让所有仓库都走代理,包括国内的代码托管平台和公司内网仓库。更推荐只对需要的域名设置:

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

查看和取消:

git config --global --get-regexp proxy
git config --global --unset http.proxy
git config --global --unset http.https://github.com.proxy

SSH 方式不理会上面任何一项,也不读环境变量,要在 ~/.ssh/config 里用 ProxyCommand 指定。macOS 和多数 Linux 的写法:

Host github.com
    User git
    ProxyCommand nc -X 5 -x 127.0.0.1:7890 %h %p

这里的 nc 需要是支持 -X、-x 参数的版本,macOS 自带的可以,Linux 上一般要装 netcat-openbsd。Windows 上使用 Git for Windows 的话,它自带一个 connect 工具,对应写法是:

Host github.com
    User git
    ProxyCommand connect -S 127.0.0.1:7890 %h %p

连接其他海外服务器的 SSH 同理,把 Host 换成对应的主机名即可。注意不要写成 Host *,否则连内网机器也会绕道代理。

配完用 ssh -T git@github.com 测试。如果所在网络封锁了 22 端口,GitHub 官方文档还提供了通过 443 端口连接 SSH 的办法,可以去查阅。

npm 和 pip 设置代理(含 pnpm)

这几个包管理器都能读取环境变量,设置了 proxy_on 的终端里一般可以直接用。想固定下来,再用它们各自的配置。

npm:

npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890
# 取消
npm config delete proxy
npm config delete https-proxy

pnpm 使用同名的配置项,命令把 npm 换成 pnpm 即可,细节以 pnpm 官方文档为准。

pip:

# 单次使用
pip install --proxy http://127.0.0.1:7890 包名
# 写入配置
pip config set global.proxy http://127.0.0.1:7890
# 取消
pip config unset global.proxy

三个常见的坑:

  1. **镜像源和代理别叠加。**如果你已经把 npm 或 pip 的源换成了国内镜像,再让它走代理,就变成绕到境外再回来访问国内服务器,反而更慢。两者选一个:用官方源配代理,或者用国内镜像不配代理。
  2. **pip 遇到 SOCKS 报错。**环境里设置了 all_proxy=socks5://... 时,pip 可能提示缺少 SOCKS 支持的依赖。办法是临时 unset all_proxy,只保留 HTTP 的两个变量,或者安装带 SOCKS 支持的依赖。
  3. **包管理器里的「proxy」不一定是网络代理。**例如 Go 的 GOPROXY 指的是模块镜像地址,和本文讲的不是一回事,不要把本地端口填进去。

用 Claude Code、Codex 这类命令行 AI 工具时也是同样的道理,它们依赖终端里的环境变量或 TUN,见 Claude Code 使用说明和 Codex 使用说明。AI 工具对出口 IP 比较敏感,节点怎么选见 AI 网络环境与节点选择。

Docker 代理设置:拉镜像要配守护进程

docker pull 是最容易配错的。你在终端里敲的 docker 只是客户端,真正去下载镜像的是后台的 Docker 守护进程,它不读你终端里的环境变量。Docker 实际上有三处不同的代理设置:

场景 在哪里配
拉取、推送镜像 守护进程
构建镜像时,构建步骤里的命令要联网 构建参数,例如 --build-arg HTTPS_PROXY=...
容器运行时,容器里的程序要联网 容器的环境变量,或客户端配置文件里的代理设置

Linux 上的 Docker Engine,按 Docker 官方文档有两种写法。一种是在守护进程的配置文件 daemon.json(通常位于 /etc/docker/)里加入下面的内容,这种写法需要较新的 Docker 版本:

{
  "proxies": {
    "http-proxy": "http://127.0.0.1:7890",
    "https-proxy": "http://127.0.0.1:7890",
    "no-proxy": "localhost,127.0.0.0/8"
  }
}

然后重启:

sudo systemctl restart docker

另一种是 systemd 的附加配置,新建 /etc/systemd/system/docker.service.d/http-proxy.conf:

[Service]
Environment="HTTP_PROXY=http://127.0.0.1:7890"
Environment="HTTPS_PROXY=http://127.0.0.1:7890"
sudo systemctl daemon-reload
sudo systemctl restart docker

两处都配了的话,官方文档说明以 daemon.json 为准。

Docker Desktop(Windows 和 macOS)不使用 daemon.json 里的代理设置,要在它的设置界面里找到代理相关的选项填写,位置以当前版本界面为准。

容器内部有一个关键点:容器里的 127.0.0.1 是容器自己,不是宿主机。要让容器里的程序用宿主机上的代理,地址得写成宿主机的地址(Docker Desktop 提供了 host.docker.internal 这个名字),同时客户端要打开「允许局域网连接」。原理和局域网共享代理相同。

其他常用工具的代理写法

除了上面几样,开发和运维时还经常用到下面这些工具。能读环境变量的,在 proxy_on 之后一般直接就能用;需要单独配置的,写法如下,细节以各工具的官方文档为准:

工具 是否读环境变量 单独配置的方法
curl 读 单次用 -x http://127.0.0.1:7890;长期写进 ~/.curlrc 的 proxy = ...
wget 读 写进 ~/.wgetrc:https_proxy = http://127.0.0.1:7890 和 use_proxy = on
Homebrew 读 它下载时调用 curl,设置好环境变量即可
apt(Debian、Ubuntu) sudo 下默认不继承 新建 /etc/apt/apt.conf.d/95proxies,写入 Acquire::http::Proxy "http://127.0.0.1:7890"; 和对应的 https 一行
Go 模块下载 读 HTTPS_PROXY 不要把端口填进 GOPROXY,那是模块镜像地址
Cargo(Rust) 读 在 ~/.cargo/config.toml 的 [http] 段写 proxy = "127.0.0.1:7890"
conda 读 在 ~/.condarc 的 proxy_servers 里分别写 http 和 https
Yarn 1.x 读 npm 的配置 新版本用 yarn config set httpProxy、httpsProxy

apt 的配置写进系统目录后会长期生效,代理客户端没开时 apt update 就会失败。临时用的话,更推荐单次执行 sudo -E apt update,让它带上你当前终端里的环境变量。

dnf、yum 等系统包管理器的代理设置

结论:Fedora、RHEL、Rocky 等发行版的 dnf 和 yum,长期配置写在主配置文件里,临时使用同样可以借助 sudo -E。

dnf 的主配置文件通常是 /etc/dnf/dnf.conf,在 [main] 段加一行:

proxy=http://127.0.0.1:7890

yum 对应 /etc/yum.conf,写法相同。和 apt 一样,这类系统级配置会长期生效,代理客户端没运行时软件源会全部失败,用完记得删除这一行。服务器在境内、软件源也有境内镜像时,直接换镜像源通常比走代理更合适,见下文「另一条路:国内镜像源」。

Yarn 1.x 和 Yarn 2+ 的代理写法不同

结论:Yarn 的两个大版本配置方式完全不同,先用 yarn --version 看版本,再选写法。

版本 配置命令 配置保存位置
Yarn 1.x yarn config set proxy http://127.0.0.1:7890 和 yarn config set https-proxy http://127.0.0.1:7890 用户目录下的 .yarnrc,也会参考 npm 的配置
Yarn 2 及以后 yarn config set httpProxy http://127.0.0.1:7890 和 yarn config set httpsProxy http://127.0.0.1:7890 .yarnrc.yml

新版本不再读取 npm 的代理配置,从 Yarn 1 升级后突然连不上,多半是这个原因。取消时,1.x 用 yarn config delete proxy,新版本用 yarn config unset httpProxy,细节以 Yarn 官方文档为准。

另一条路:国内镜像源

结论:如果你要下载的依赖本身有国内镜像,换镜像源往往比走代理更快、也不消耗机场流量。代理和镜像源是两种思路,同一个工具里二选一,不要叠加。

工具 换源的方式 适合换源的情况
npm、pnpm npm config set registry 镜像地址 只装公开的 npm 包
pip pip config set global.index-url 镜像地址 只装 PyPI 上的公开包
Go 模块 设置 GOPROXY 为模块镜像地址 依赖都是公开模块
Docker 镜像 在 daemon.json 的 registry-mirrors 里配置 主要拉官方仓库的公开镜像
apt、dnf 修改软件源列表 服务器在境内,系统软件包更新

镜像地址由国内云厂商、高校等机构提供,具体地址以各镜像站的说明为准。换源的局限也要清楚:镜像有同步延迟,最新发布的版本可能暂时拉不到;私有仓库、GitHub 上的源码、部分二进制下载并不在镜像里,这些仍然需要代理。实际工作中常见的组合是:包管理器用镜像源,Git 和其他境外地址走代理。

Java、Gradle、Maven 怎么走代理

结论:Java 系的工具基本不读 http_proxy 环境变量,要用 JVM 系统属性或各自的配置文件,这是开发者在终端里最容易漏掉的一类。

工具 配置方法
直接运行 Java 程序 启动参数加 -Dhttps.proxyHost=127.0.0.1 -Dhttps.proxyPort=7890,HTTP 对应 http.proxyHost、http.proxyPort
Gradle 在用户目录的 gradle.properties 里写 systemProp.https.proxyHost=127.0.0.1 和 systemProp.https.proxyPort=7890,http 同理
Maven 在用户目录 .m2/settings.xml 的 proxies 段添加一个 proxy 条目,填协议、主机和端口
Android Studio 等 IDE 在 IDE 的 HTTP Proxy 设置里填写,IDE 可能会询问是否同步给 Gradle

不走代理的地址,JVM 系统属性用 http.nonProxyHosts,多个地址之间用竖线分隔,写法和 no_proxy 不同。Gradle 的代理写进用户目录后会长期生效,代理客户端没开时构建会失败,换网络环境时记得检查这个文件。和其他包管理器一样,Maven 和 Gradle 也可以改用国内镜像仓库,二者选一种即可。

终端代理不生效:常见报错对照

报错信息是判断问题出在哪一层的最快线索。下面按常见的报错原文归类,对应的处理思路:

报错里的关键词 说明了什么 处理
Connection refused、connect: connection refused 加上 127.0.0.1:7890 本地端口上没有程序在监听 客户端没开,或端口写错;核对混合端口
Failed to connect ... Timed out、ETIMEDOUT 请求没走代理,直连被阻断,或节点不通 先用 curl -x 测端口;确认变量在当前窗口生效
Could not resolve host 本机解析不了域名 把 all_proxy 改成 socks5h://;或检查 DNS
Proxy CONNECT aborted、Received HTTP code 502 from proxy 已经连到本地代理,但代理到目标这一段失败 换节点;看客户端日志里这条连接的报错
SSL certificate problem、certificate verify failed 证书校验失败 校准系统时间;确认没有开 HTTPS 解密类功能;公司网络可能有中间人设备
Missing dependencies for SOCKS support pip 读到了 SOCKS 代理变量 临时 unset all_proxy ALL_PROXY
kex_exchange_identification、SSH 连接被关闭 22 端口被封锁,或 SSH 没走代理 配 ProxyCommand;或按 GitHub 文档改走 443 端口
proxyconnect tcp 加 connection refused Docker 守护进程连不到你填的代理地址 检查守护进程里的代理地址;容器、WSL 里不能直接用 127.0.0.1

一个通用的排查顺序:先 curl -I -x http://127.0.0.1:7890 https://www.google.com 确认端口本身可用,再 env | grep -i proxy 看当前窗口里实际生效的变量,最后再看具体工具的配置。三层逐一排除,比反复改配置快得多。

VS Code、JetBrains 等编辑器里怎么走代理

很多人的命令行其实是编辑器里的内置终端,还有编辑器自己的插件市场、AI 补全插件也要联网。这几样各管各的:

要联网的部分 读不读系统代理 怎么处理
编辑器的内置终端 继承编辑器启动时的环境变量 在内置终端里执行 proxy_on;或者从已经设置好变量的终端启动编辑器
VS Code 的插件市场和扩展 通常会读系统代理 不行时在设置里搜索 http.proxy 填写本地地址
JetBrains 系列的插件和更新 有自己的代理设置 在设置里找 HTTP Proxy 一项,选自动检测或手动填写
编辑器里的 Git 操作 用的是 Git 自己的配置 按上文 Git 一节设置
AI 补全、对话类插件 各插件实现不同 先试系统代理,不行再开 TUN

菜单位置随编辑器版本略有差异,以当前界面为准。

VS Code 终端代理不生效怎么办

一个常见的误会是:在系统终端里设好了变量,VS Code 的内置终端却不生效。原因是编辑器早在你设置变量之前就已经启动了,它的终端继承的是启动那一刻的环境。重启编辑器,或者直接在内置终端里再执行一次即可。想让内置终端每次打开都自带代理,可以在 VS Code 设置里用 terminal.integrated.env.osx(Linux 用 .linux,Windows 用 .windows)写入 http_proxy 和 https_proxy 两个变量,端口填客户端里显示的那个,改完新开一个终端标签生效。

编辑器类 AI 工具的网络设置有专门的说明,见 Cursor 使用教程和 GitHub Copilot 使用教程。

终端代理怎么永久生效,又不留后遗症

「每次开终端都要重新设置」是最常见的抱怨。想让终端代理长期可用,又不想在客户端关掉时所有命令都报错,可以按这个思路:

  1. 写函数,不写死变量。把上文的 proxy_on、proxy_off 两个函数放进 ~/.zshrc、~/.bashrc 或 PowerShell 的 $PROFILE,需要时手动开。
  2. 想自动开启时加一个判断。在配置文件里先检测本地端口有没有程序在监听,有才执行 proxy_on。这样客户端没开时,终端保持直连,不会出现连接被拒绝。检测的写法因系统而异,可以用 nc -z 127.0.0.1 7890 这类命令判断。
  3. 工具级配置只给需要的域名。Git 按域名设置代理,比全局设置留下的隐患少得多。
  4. 定期清点。执行 env | grep -i proxy、git config --global --get-regexp proxy、npm config get proxy,看看有没有早就忘了的残留设置。

真正需要「所有程序永远走代理」的,与其在每个工具里写配置,不如直接用 TUN。

怎么确认流量真的走了代理

能连上不一定是走了代理,有时候只是那个地址本身直连就能访问。想确认,可以用这几种办法:

  • 看 curl 的详细输出。执行 curl -v https://www.google.com -o /dev/null,输出开头如果出现连接到 127.0.0.1 加你的端口,说明请求确实交给了本地代理。

  • 看出口地区。执行 curl -s https://www.cloudflare.com/cdn-cgi/trace,loc= 一行显示的是出口地区代码,和你在客户端里选的节点地区一致才对。

  • 看客户端的连接列表。Clash 系客户端的「连接」页会实时列出请求的域名、命中的规则和使用的节点。执行一次 git clone 或 npm install,在列表里找对应的域名,就知道它走了哪条路。

  • 开关前后对比。先执行 proxy_off 再访问一次上面的 trace 地址,记下 ip= 和 loc=;再执行 proxy_on 访问一次。两次结果不同,说明环境变量确实改变了这个终端的出口;结果一样,说明变量没有生效,或者你开着 TUN,流量本来就被接管了。

用 Claude Code 这类命令行 AI 工具时,出口地区这一项尤其值得确认,地区不受支持时的表现见 Claude 提示地区不支持。

远程服务器借用本机的代理

常见的情况是:你在自己电脑上开着代理客户端,通过 SSH 登录一台访问不了外网的服务器,想让服务器上的 git clone、pip install 也能用上代理。不必在服务器上再装一套客户端,用 SSH 的远程端口转发就行:

ssh -R 7890:127.0.0.1:7890 用户名@服务器地址

登录后,服务器上的 127.0.0.1:7890 就会被转回你本机的代理端口。在这个 SSH 会话里照常设置环境变量:

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
curl -I https://www.google.com

几点说明:

  • Windows 自带的 OpenSSH 客户端、macOS 和 Linux 的 ssh 命令写法相同,端口换成你客户端的混合端口。
  • 转发只在这个 SSH 连接存活期间有效,断开就失效,不会在服务器上留下长期开放的端口。
  • 默认情况下,转发出来的端口只监听服务器的本机地址,服务器上的其他用户和外部网络连不到。不要为了方便去修改服务器的 GatewayPorts 设置。
  • 服务器上的流量会算进你本机代理的流量里,大体积的镜像和依赖要留意套餐用量。
  • 需要长期使用、或者服务器要独立运行时,更合适的做法是在服务器上单独部署,见 Linux 命令行使用 mihomo。

什么时候直接开 TUN 更省事

TUN 模式在系统里建一块虚拟网卡,从网络层接管所有流量,程序认不认代理都无所谓。出现下面的情况时,开 TUN 比逐个配置划算:

  • 用到的工具很多,或者有些工具根本没有代理选项。
  • 同时用到 Docker、WSL、虚拟机,每一层都要单独处理。
  • 程序走 UDP,HTTP 代理处理不了。
  • 只是临时装个依赖,不想改任何配置文件。

更适合用环境变量的情况:

  • 只想让某一个终端窗口走代理,其余保持直连。
  • 电脑上有公司 VPN 或其他会创建虚拟网卡的软件,容易和 TUN 冲突。
  • 没有管理员权限。
  • 在远程服务器上操作,TUN 配错会把 SSH 连接切断。

无论哪种方式,流量都按订阅里的规则分流。大体积的依赖和镜像会消耗机场流量,下载前留意节点倍率,见倍率与流量。TUN 的原理见规则、全局与 TUN 模式,打不开见 TUN 开不了怎么办。

开 TUN 让终端走代理前先确认什么

结论:开 TUN 之前确认四件事,可以避免「开了之后整台电脑断网」或「公司内网连不上」。

  1. 权限:TUN 要创建虚拟网卡,Windows 上需要管理员权限或客户端的服务模式,macOS 和 Linux 需要授权或 root。没有权限的设备只能用环境变量。
  2. 其他虚拟网卡:公司 VPN、虚拟机软件、其他加速器也会创建虚拟网卡或改路由,先关掉它们再开 TUN。
  3. 内网网段:公司内网、家里的 NAS、虚拟机网段要保证直连。规则里一般已经包含常见的局域网地址,公司使用特殊网段的,需要在客户端里把它排除,具体选项以软件当前版本界面为准。
  4. DNS 设置:TUN 模式通常会接管 DNS,内网域名需要公司 DNS 才能解析的,要在客户端的 DNS 设置里为这些域名单独指定。

在桌面客户端中启用 TUN 并检查

以 Clash 系客户端为例,一般步骤是:

  1. 在设置里找到 TUN 或虚拟网卡相关的开关,首次开启时按提示安装服务或授权。
  2. 打开 TUN 后,关掉系统代理,避免两条路同时生效、排查时分不清。
  3. 在一个没有设置任何代理环境变量的新终端里执行 curl -s https://www.cloudflare.com/cdn-cgi/trace,loc= 显示节点地区,说明 TUN 已经接管了终端流量。
  4. 执行一次 git clone 或 ssh -T git@github.com,在客户端的连接列表里能看到对应的连接,说明 Git 和 SSH 也被接管了。
  5. 访问一个公司内网地址或局域网设备,确认仍然直连可用。

内网异常与安全回滚

开 TUN 后出现内网打不开、SSH 远程断开、DNS 解析异常时,按这个顺序回滚:先在客户端里关闭 TUN;仍然异常,退出客户端;再不行,Windows 上执行 ipconfig /flushdns 清理 DNS 缓存,macOS 和 Linux 检查 /etc/resolv.conf 或系统的 DNS 设置是否被改动后没有恢复。在远程服务器上尝试 TUN 之前,确保你有控制台或其他不依赖 SSH 的登录方式,否则配错路由可能把自己锁在外面。

终端代理配置检查清单

结论:配完之后按下表逐项核对一遍,能覆盖绝大多数「为什么这个命令还是不走代理」的问题。

检查项 命令或方法 正常的结果
本地端口可用 curl -I -x http://127.0.0.1:7890 https://www.google.com 返回 HTTP 状态行
当前窗口的变量 printenv http_proxy HTTPS_PROXY(PowerShell 用 Get-ChildItem Env:*proxy*) 能看到你设置的地址
出口地区 curl -s https://www.cloudflare.com/cdn-cgi/trace loc= 和节点地区一致
Git 配置 git config --global --get-regexp proxy 只有你需要的域名设置
SSH 配置 查看 ~/.ssh/config 只对境外主机写了 ProxyCommand
包管理器 npm config get proxy、pip config list 和你的预期一致,没有残留
Docker docker info 输出里的代理一项 显示你填的地址
内网直连 访问一个内网地址并看客户端连接列表 列表里没有这条请求

不同国家和地区对代理工具的规定不同,请遵守当地法律;在公司设备上操作前,先确认符合公司的网络规定。

常见问题

终端设置了代理,为什么 ping google.com 还是不通?

ping 使用 ICMP 协议,HTTP 和 SOCKS5 代理都不处理这种流量,所以环境变量对它没有任何作用。验证终端代理是否生效要用 curl -I https://www.google.com,能返回状态行就说明通了。

Clash 的终端代理端口是多少,7890 还是 7897?

没有固定答案,不同客户端的默认值不同,也可以自己改。以客户端设置页里显示的混合端口为准,7890 和 7897 只是比较常见的两个数字。照抄教程里的端口而不核对,是终端代理不生效最常见的原因。

git clone 提示连接超时或者 Connection refused 怎么办?

先分清仓库地址是 HTTPS 还是 SSH。HTTPS 地址检查 http.proxy 或环境变量;SSH 地址要在 ~/.ssh/config 里配置 ProxyCommand。提示 Connection refused 多半是端口写错了或者客户端没有运行;提示超时则先用 curl -x 测试代理端口本身通不通。

怎么取消 Git 和 npm 的代理设置?

Git 执行 git config --global --unset http.proxy,如果针对域名设置过,也要一并 unset。npm 执行 npm config delete proxy 和 npm config delete https-proxy。环境变量用 unset 清除,或者直接关掉终端窗口。关掉代理客户端后各种命令突然连不上,基本都是某处残留了代理配置。

docker pull 设置了 http_proxy 还是拉不下来怎么办?

终端里的环境变量对 docker pull 无效,因为下载镜像的是 Docker 守护进程。Linux 上按官方文档把代理写进 daemon.json 或 systemd 的附加配置并重启 Docker;Docker Desktop 在设置界面里配置。配置之后仍然失败,先用 curl -x 确认代理端口本身可用,再用 docker info 查看输出里有没有出现你填的代理地址。

apt 和 Homebrew 怎么走代理?

Homebrew 下载时调用 curl,设置了 http_proxy、https_proxy 的终端里直接就能用。apt 通常要 sudo 执行,而 sudo 默认不继承环境变量,临时用 sudo -E apt update;需要长期生效,就在 /etc/apt/apt.conf.d/ 下新建一个文件写入 Acquire::http::Proxy,不用时记得删掉。

终端代理和 TUN 模式可以同时开吗?

可以,一般不会出错,但没有必要。TUN 已经接管了全部流量,再设环境变量只是让请求多经过一次本地代理端口。排查问题时建议只保留一种,便于判断是哪一层出了问题。

Node.js 脚本里用 fetch 访问外网,为什么设了环境变量也不走代理?

Node.js 自带的网络模块传统上不读取 http_proxy 这类环境变量,npm 能走代理是因为 npm 自己做了处理。脚本需要代理时,要么在代码里显式配置代理,要么打开客户端的 TUN 模式。较新的 Node.js 版本是否提供读取环境变量的选项,以官方文档为准。

WSL2 里的终端怎么走 Windows 上的代理?

WSL2 默认网络模式下,子系统里的 127.0.0.1 指向子系统自己。可以在 Windows 客户端里打开「允许局域网连接」,再把 WSL 里的代理地址写成 Windows 主机地址;或者启用 WSL 的镜像网络模式;也可以直接在 Windows 客户端里打开 TUN。三种做法的系统要求以微软官方文档为准。

设置了 no_proxy,内网地址还是走了代理怎么办?

先确认写法:域名后缀和具体 IP 最稳妥,网段写法在部分工具里不被支持。再确认变量在当前窗口生效,并且大小写两组都设了。仍然不行,看代理客户端的连接列表里有没有这条内网请求,必要时给这个工具单独写直连配置。

终端走代理会额外消耗机场流量吗?

会。走代理的下载都会计入机场套餐,安装大型依赖、拉取容器镜像、克隆大仓库时消耗尤其明显,高倍率节点还会按倍数扣。能用国内镜像源的包管理器优先换源,只让 Git 和境外地址走代理;必须走代理时选低倍率节点,规则见倍率与流量。不用时执行 proxy_off,避免国内源也被绕到境外。

终端代理配置改乱了,怎么一次恢复成直连?

关掉当前终端窗口,新开一个,环境变量就恢复了。再依次清理工具级配置:git config --global --unset http.proxy,npm config delete proxy 和 npm config delete https-proxy,pip config unset global.proxy,以及 apt、dnf、Gradle 等写进文件的代理行。最后检查 ~/.ssh/config 里的 ProxyCommand 是否还需要。