终端走代理教程(2026):命令行、Git、npm、pip、Docker 代理设置
终端走代理教程:开了代理,Git、npm、pip、Docker 仍连不上,是因为命令行工具不读系统代理。本文讲 macOS、Linux、Windows 终端怎么设置代理,Git、npm、pip、Docker 的代理写法,编辑器内置终端的处理,以及终端代理不生效的报错对照。
这篇终端走代理教程先说结论:命令行工具大多不读系统代理,要么用 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
三个常见的坑:
- **镜像源和代理别叠加。**如果你已经把 npm 或 pip 的源换成了国内镜像,再让它走代理,就变成绕到境外再回来访问国内服务器,反而更慢。两者选一个:用官方源配代理,或者用国内镜像不配代理。
- **pip 遇到 SOCKS 报错。**环境里设置了
all_proxy=socks5://...时,pip 可能提示缺少 SOCKS 支持的依赖。办法是临时unset all_proxy,只保留 HTTP 的两个变量,或者安装带 SOCKS 支持的依赖。 - **包管理器里的「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 使用教程。
终端代理怎么永久生效,又不留后遗症
「每次开终端都要重新设置」是最常见的抱怨。想让终端代理长期可用,又不想在客户端关掉时所有命令都报错,可以按这个思路:
- 写函数,不写死变量。把上文的
proxy_on、proxy_off两个函数放进~/.zshrc、~/.bashrc或 PowerShell 的$PROFILE,需要时手动开。 - 想自动开启时加一个判断。在配置文件里先检测本地端口有没有程序在监听,有才执行
proxy_on。这样客户端没开时,终端保持直连,不会出现连接被拒绝。检测的写法因系统而异,可以用nc -z 127.0.0.1 7890这类命令判断。 - 工具级配置只给需要的域名。Git 按域名设置代理,比全局设置留下的隐患少得多。
- 定期清点。执行
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 之前确认四件事,可以避免「开了之后整台电脑断网」或「公司内网连不上」。
- 权限:TUN 要创建虚拟网卡,Windows 上需要管理员权限或客户端的服务模式,macOS 和 Linux 需要授权或 root。没有权限的设备只能用环境变量。
- 其他虚拟网卡:公司 VPN、虚拟机软件、其他加速器也会创建虚拟网卡或改路由,先关掉它们再开 TUN。
- 内网网段:公司内网、家里的 NAS、虚拟机网段要保证直连。规则里一般已经包含常见的局域网地址,公司使用特殊网段的,需要在客户端里把它排除,具体选项以软件当前版本界面为准。
- DNS 设置:TUN 模式通常会接管 DNS,内网域名需要公司 DNS 才能解析的,要在客户端的 DNS 设置里为这些域名单独指定。
在桌面客户端中启用 TUN 并检查
以 Clash 系客户端为例,一般步骤是:
- 在设置里找到 TUN 或虚拟网卡相关的开关,首次开启时按提示安装服务或授权。
- 打开 TUN 后,关掉系统代理,避免两条路同时生效、排查时分不清。
- 在一个没有设置任何代理环境变量的新终端里执行
curl -s https://www.cloudflare.com/cdn-cgi/trace,loc=显示节点地区,说明 TUN 已经接管了终端流量。 - 执行一次
git clone或ssh -T git@github.com,在客户端的连接列表里能看到对应的连接,说明 Git 和 SSH 也被接管了。 - 访问一个公司内网地址或局域网设备,确认仍然直连可用。
内网异常与安全回滚
开 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 是否还需要。