大家好,我是大伟/Wei•Will,深耕软件工程一线,专注AI应用落地与Agent开发。
这是开发环境里很常见的一幕:浏览器打开 GitHub、模型平台或者海外技术网站都正常,终端里的 curl、git clone 和包管理器下载却一直超时。代理客户端明明已经显示“已连接”,浏览器也证明网络能用,为什么终端不通?
很多人遇到这类问题时,第一反应是反复切换代理节点、重启终端,或者怀疑目标网站限制了命令行请求。

问题通常没有那么神秘,核心原因是:
“电脑开了代理”不是一个准确的技术描述。更准确的说法是,某个应用、某个进程,或者某一层网络路由知道代理在哪里,并且决定把请求交给它。
浏览器和终端不是同一个网络入口。浏览器能走代理,只能说明浏览器当前这条请求链路成立,不能证明终端里启动的所有程序都会自动继承这条链路。
思维导图

“开了代理”为什么不是一个总开关
我们平时说“代理已经打开”,背后可能是完全不同的实现方式。
第一种是浏览器扩展代理。扩展通过浏览器提供的能力接管请求,只有这个浏览器或指定的浏览器配置生效。终端里的 curl、Git、Java 程序根本不知道扩展存在。
第二种是系统代理。代理客户端把 HTTP、HTTPS 或 SOCKS 地址写入操作系统的网络设置。Safari、Chrome 等浏览器通常会读取系统代理,但命令行工具是否读取,要看工具自己的实现。系统里有配置,不代表所有程序都遵守,这也是最容易混淆的地方。
第三种是 PAC,也就是 Proxy Auto-Config,代理自动配置。它不是代理服务器,而是一段告诉客户端“什么地址应该怎么走”的规则。浏览器访问不同网址时,可以根据 PAC 的判断选择直连、固定代理,或者另一个代理。
可以把 PAC 理解成一张自动分流表:访问公司内网就 DIRECT,访问外部网站就 PROXY 127.0.0.1:7890。浏览器能够执行这张表,终端里的很多命令行工具却不会解析 PAC 文件,更不会自动把 PAC 转换成环境变量。
一个简化的 PAC 规则大概是这样:
1 | function FindProxyForURL(url, host) { |
这段规则没有转发任何流量,它只是返回一个决定:当前地址直连,还是交给哪个代理。真正发起连接的仍然是浏览器。PAC 的关键价值是自动选路,不是代理本身。
第四种是 Shell 环境变量。我们在终端里设置 http_proxy、https_proxy 或 all_proxy,支持这些变量的命令行程序会在启动时读取它们。这类配置通常只影响当前 Shell 以及它启动的子进程,不会反过来改变浏览器。即使是 DeepSeek Harness 这类从终端启动的应用,也要看它使用的网络库和启动方式是否读取这些变量,不能因为它运行在终端里,就默认它会使用代理。
第五种是 VPN 或 TUN 模式。它不再要求每个应用主动理解代理,而是在更底层修改路由或接管网络流量,所以覆盖范围通常更广。但“更广”也不等于“绝对全部”,分流规则、进程规则、IPv6、DNS 和虚拟网络仍然可能让部分请求绕开代理。
比如使用 Codex 或其他本地 Agent 时,如果日志表现为连续多次重连,而浏览器访问正常,可以把 TUN 模式作为一次对照实验。它有时能解决问题,不是因为 TUN 模式“更快”,而是因为它改变了流量接管的层级。
这类问题在日志里经常表现为:请求已经发起,但连接反复重试,最后仍然无法建立。此时把 TUN 模式作为对照项,比盲目更换节点更容易判断问题到底出在哪一层。

这些方式看起来都叫“开代理”,作用层级却完全不同。
所以排查时,第一个问题不应该是“代理开没开”,而应该是:
现在到底是哪一层在让浏览器走代理?
只要这个问题没回答清楚,后面所有配置都容易变成碰运气。
浏览器为什么能访问,终端却失败
浏览器之所以表现得“更容易成功”,是因为它通常已经和代理配置形成了一条完整链路。
如果使用浏览器扩展,扩展会根据域名规则决定直连还是代理;如果使用系统代理,浏览器可能直接读取系统设置;如果配置了 PAC 文件,浏览器还可以在每次请求前执行规则,为不同域名选择不同出口。
所以,浏览器的优势不只是“拿到了一个代理地址”,还在于它能自动完成选路。命令行工具通常只知道“直接连接”或“使用一个固定代理”,并不知道这张 PAC 分流表,因此它们和浏览器得到不同结果很正常。
终端本身不是网络客户端,它只是一个交互界面。真正发起请求的是里面运行的具体进程,例如:
curl发起 HTTP 请求;- Git 在执行
git clone等命令时,通过自己的 HTTP 传输层访问远程仓库; - npm、Maven、Gradle 等包管理工具下载依赖;
- Java、Node.js、Python 程序使用各自的网络库调用接口;
- Docker 客户端把请求交给 Docker daemon,再由 daemon 拉取镜像。
这些程序来自不同生态,对代理配置的读取方式并不统一。有的读取环境变量,有的读取自己的配置文件,有的读取系统代理,有的只接受启动参数,还有的默认什么都不读。
这就像公司里已经有一辆班车,并不代表每个员工都知道车停在哪里、几点发车。浏览器拿到了路线,终端里的另一个进程没有拿到,最终表现就是一个能访问,一个超时。
还有一种常见情况是:浏览器使用 PAC 自动分流,而命令行工具只认识一个固定代理地址。浏览器知道访问某个域名时应该走哪条线路,终端工具却不会执行 PAC 里的规则,自然无法得到同样的结果。
所以,“浏览器可以打开”只能证明目标站点和代理服务本身大概率可用,不能证明终端已经配置完成。
终端里的请求到底怎么决定走不走代理
一条命令行请求发出去之前,可以从下面几层去看:
1 | 工具自己的代理配置 |
具体顺序会因工具而异,但这个模型足够帮助我们定位问题。
例如,在 Shell 里执行:
1 | export http_proxy=http://127.0.0.1:7890 |
这不是把整个终端“接入代理”,而是给当前 Shell 增加两个环境变量。之后从这个 Shell 启动、并且愿意读取这些变量的进程,才可能使用代理。
这也解释了几个看似奇怪的现象。
如果变量只是赋值,没有 export,它可能只是 Shell 内部变量,子进程看不到。
如果配置写进了 ~/.zshrc,但当前终端没有重新加载,新启动的命令仍然拿不到。
如果某个长期运行的进程、IDE、后台服务或 tmux 会话在设置代理之前就已启动,它也可能继续使用旧环境。
如果使用 sudo 执行命令,提权后的环境可能被清理,原来的代理变量不会自动保留。
这里还要特别注意 no_proxy 和 NO_PROXY。它们不是“代理地址”,而是一张不走代理的例外清单:命令行工具匹配到清单中的地址后,会直接连接目标,不再经过代理。
例如:
1 | export no_proxy="localhost,127.0.0.1,::1,service.internal.example,.corp.example" |
这通常用于避免本机服务、回环地址和企业内网请求绕到外部代理。但 no_proxy 的匹配规则并没有被所有工具完全统一:有的支持前导点表示域名后缀,有的支持通配符,有的支持 CIDR 网段,有的只支持主机名或域名。因此不要把一套复杂写法直接复制给所有语言和工具,应该以实际客户端的文档和测试结果为准。
大小写也不要写成两套不同内容。在 Unix 环境中环境变量区分大小写,而不同客户端对 http_proxy、HTTP_PROXY、no_proxy 和 NO_PROXY 的优先级处理可能不同。最稳妥的做法是,如果需要同时设置大小写,就让它们的值保持一致;排查时也要确认是否有某个旧变量覆盖了新变量。
no_proxy 配得过宽,会产生“明明设置了代理,某个域名却直连”的现象;配得过窄,则可能让本地服务、内网接口走代理,造成访问失败、额外延迟,甚至代理回环。它不是一个可有可无的附加变量,而是代理策略的一部分。
还有一个容易误解的细节:
1 | export https_proxy=http://127.0.0.1:7890 |
变量名里的 https 表示“访问 HTTPS 目标时使用的代理”,代理地址本身仍然可能是 http://。客户端通常通过 HTTP CONNECT 方法建立隧道,再在隧道里完成 TLS 握手。把它想当然地改成 https://127.0.0.1:7890,反而可能因为本地代理端口并不支持 HTTPS 代理协议而失败。
如果代理客户端提供的是 SOCKS 端口,则应该按 SOCKS 协议配置,例如:
1 | export all_proxy=socks5h://127.0.0.1:7891 |
socks5h 中的 h 表示域名解析也交给代理端完成。它和 socks5 的差异,往往正好能解释“代理端口通了,但域名还是解析失败”的问题。
端口号和协议必须以代理客户端实际提供的信息为准。HTTP 端口、SOCKS 端口和混合端口不能靠猜,也不要因为示例里经常写 7890,就默认自己的环境一定相同。
用一条最短链路定位问题
排查这类问题,最有效的方式不是一次改很多配置,而是做一个最小对照实验。
第一步:确认当前进程到底拿到了什么
在 macOS 或 Linux 终端里,可以先看代理环境变量:
1 | env | grep -i proxy |
如果没有任何输出,说明当前 Shell 没有向子进程提供常见代理变量。
如果已经有输出,要继续检查三件事:地址是不是 127.0.0.1 或正确的代理主机,端口是不是代理客户端真实监听的端口,协议是不是 HTTP 或 SOCKS 对应的协议。
同时检查 no_proxy 或 NO_PROXY。它用于指定不走代理的地址,如果范围写得过大,也会让本来应该走代理的域名被强制直连。
第二步:比较直连和显式代理
先直接请求同一个目标:
1 | curl -I -v --connect-timeout 10 https://github.com |
再显式指定代理:
1 | curl -I -v --connect-timeout 10 \ |
如果第一条失败、第二条成功,问题基本已经缩小:网络和代理服务大概率都正常,缺的是终端进程的代理配置。
如果当前环境设置了 no_proxy,要明确禁止 curl 绕过代理,可以使用 --noproxy ""。否则目标地址一旦命中 no_proxy,即使命令行里写了 -x,测试结果也可能不是你以为的“强制走代理”。
1 | curl -I -v --connect-timeout 10 \ |
如果第二条直接提示无法连接 127.0.0.1:7890,先不要继续折腾 Git 或包管理器。应该确认代理客户端是否启动、监听端口是否正确:
1 | nc -vz 127.0.0.1 7890 |
也可以查看本机监听状态:
1 | lsof -nP -iTCP:7890 -sTCP:LISTEN |
如果端口根本没有监听,再多的环境变量也没有意义。
第三步:先做一次性配置,不要急着写进启动文件
为了避免污染长期环境,可以先只给一条命令传递代理:
1 | http_proxy=http://127.0.0.1:7890 \ |
一次性测试成功后,再决定是否导出到当前会话:
1 | export http_proxy=http://127.0.0.1:7890 |
同时设置大小写,是为了兼容不同工具,但要保持对应值一致,也不要因此忽略安全边界。生产脚本、CI 和服务进程应该显式声明需要哪些变量,而不是把个人电脑上的全部代理环境无条件复制过去。
第四步:如果 curl 成功,就检查具体工具自己的配置
curl 成功,Git、npm 或应用程序仍然失败,说明问题已经从“终端有没有代理”进入“具体工具是否使用代理”。
Git 可以先查看配置来源:
1 | git config --show-origin --get-regexp '.*proxy' |
如果确实需要为 Git 单独设置:
1 | git config --global http.proxy http://127.0.0.1:7890 |
npm 也可能保留自己的代理配置:
1 | npm config get proxy |
Java、Maven、Gradle、Node.js 的不同网络库也可能有独立配置方式。这里不要机械地把所有工具都配置一遍,而应该先确认失败发生在哪个进程,再查这个进程实际支持的代理入口。
配了代理,为什么有些命令仍然失败
代理地址正确,只代表完成了第一层配置。真正的请求还可能卡在 DNS、证书和分流规则上。
DNS 解析发生在哪里
有些客户端会先在本地解析域名,再把 IP 地址交给代理;有些客户端会把域名交给代理端解析。
如果本地 DNS 无法解析目标域名,即使 SOCKS 代理本身可用,请求也可能在连接代理之前就失败。此时使用 socks5h:// 而不是 socks5://,往往能帮助我们验证是不是 DNS 位置造成的问题。
浏览器还可能启用了自己的安全 DNS 或 DoH,终端则继续使用操作系统 DNS。于是同一台电脑上,浏览器能解析,命令行却提示 Could not resolve host。这不是代理有没有启动的问题,而是两条链路使用了不同的域名解析入口。
浏览器信任证书,不代表 Java 也信任
在公司网络或带 HTTPS 检查能力的代理环境里,代理可能会重新签发站点证书。
浏览器通常使用系统证书库,安装企业根证书后可以正常访问;Java 可能使用自己的信任库,Node.js 或某些工具也可能有独立的证书处理方式。最终就会出现浏览器正常、终端报 certificate verify failed 或 PKIX path building failed。
这时问题已经不是“不走代理”,而是“已经走到代理,但 TLS 信任链没有建立”。正确做法是把受信任的企业 CA 配置到对应运行时,而不是长期关闭证书校验。
像 curl -k、关闭 Git SSL 校验这类操作,只适合短时间验证问题层级,不应该成为长期方案。否则网络看起来通了,真正的中间人风险却被一起放开了。
分流规则让同一个代理产生不同结果
代理客户端可能按域名、IP、地区、进程或规则集决定直连还是代理。浏览器访问的是网页域名,命令行工具访问的可能是 API 域名、对象存储域名或软件包镜像域名,两者未必命中同一条规则。
例如,浏览器能打开项目主页,不代表 git clone 使用的代码下载域名也会走同一条线路;npm 能打开官网,不代表实际下载依赖的 registry 和 CDN 已经命中代理。
所以排查时一定要比较同一个域名、同一种协议,不要用“浏览器能打开 A”去证明“终端访问 B 也应该成功”。
Docker、SSH、WSL 为什么更容易让人误判
当命令进入另一个执行环境后,代理配置边界会更加明显。
Docker 拉镜像,发请求的可能不是当前 Shell
执行 docker pull 时,真正负责访问镜像仓库的是 Docker daemon。当前终端里的 http_proxy 不一定会自动变成 daemon 的代理配置。
进入容器以后又是另一层边界。容器有自己的环境变量和网络命名空间,容器里的 127.0.0.1 指向容器自己,不一定是宿主机上的代理客户端。
因此,“宿主机 curl 成功,容器 curl 失败”并不矛盾。需要分别确认:
- Docker daemon 是否配置代理;
- 构建阶段是否传入代理;
- 运行中的容器是否拿到代理变量;
- 容器能否访问宿主机代理监听地址;
- 代理客户端是否允许来自非本机回环地址的连接。
SSH 以后,命令已经在远程机器执行
本地浏览器走代理,与 SSH 登录后的远程服务器没有直接关系。
你在远程 Shell 里执行 curl,发请求的是远程服务器。除非显式配置远程代理、端口转发或 VPN,否则它不会借用本地浏览器的代理出口。
IDE Remote、远程开发容器和 Agent 远程执行也一样。界面显示在本地,不代表程序运行在本地。排查前先确认进程到底在哪台机器、哪个容器、哪个用户身份下执行,这一步往往比改代理变量更重要。
WSL(Windows 下面的 Linux 环境)也不是简单复制 Windows 网络
WSL 中运行的是 Linux 进程,它读取的是 Linux 环境变量。Windows 上的代理客户端是否能被 WSL 访问,还取决于网络模式、监听地址、防火墙和代理客户端是否允许局域网连接。
如果把 Windows 代理地址机械写成 127.0.0.1,在某些网络模式下,WSL 连接到的可能只是自己的回环地址。此时应该先确认 WSL 到宿主机代理端口是否可达,而不是继续修改应用配置。
到这里,问题已经可以分成几类:代理变量没有传到进程,具体工具没有读取代理,地址被 no_proxy 绕过,或者请求在 DNS、TLS、容器和远程主机边界上失败。继续把它们都称为“终端不走代理”,排查就会失去方向。
这些场景共同说明了一件事:
代理配置不会自动穿过进程、用户、容器、虚拟机和远程主机边界。
工程上不要只解决“这次能用”
个人临时排查时,手动 export 几个变量就能解决问题。但团队环境、CI、构建机和长期运行服务不能只依赖某个人的终端状态。
我的判断是,代理配置至少要做到三点。
第一,明确配置归属。
浏览器扩展、系统代理、Shell 环境变量、Git 配置、Docker daemon 配置分别解决什么问题,要写清楚。不要把所有入口都配置一遍,最后谁生效、谁覆盖谁都没人知道。
第二,区分临时验证和长期方案。
临时验证优先使用单条命令显式传参,确认路径成立后,再写入 Shell 启动文件、工具配置或服务配置。这样可以避免一次错误配置影响后面所有命令。
第三,保留不走代理的边界。
no_proxy 通常应该包含 localhost、127.0.0.1、::1,企业环境还可能需要加入内网域名和服务网段。但范围不要写得过大,否则外部地址会被意外直连;也不要把敏感代理凭证直接写进仓库、脚本日志和 CI 输出。
如果团队经常遇到这类问题,可以准备一个最小检查清单:
1 | 1. 请求在哪个进程和环境里执行? |
这套顺序的价值,不只是解决一次网络问题,而是避免把不同层级的故障混在一起。
总结:先确认代理作用在哪一层
浏览器走代理、终端却不走,本质上不是浏览器和终端谁更特殊,而是它们拿到的网络配置不同。
浏览器可能通过扩展、系统代理或 PAC 找到了出口;终端里的具体进程则可能没有读取环境变量,也可能被 no_proxy 明确要求直连,或者使用自己的代理配置。即使已经连接代理,请求还可能继续卡在协议、DNS、证书、分流规则和远程环境边界上。
下一次再遇到这个问题,不要先反复重启代理客户端。先做三个动作:
- 用
env | grep -i proxy确认当前进程环境; - 用
curl -x(必要时加--noproxy "")对同一个 URL 做显式代理对照; - 确认命令实际运行在本机、容器、WSL,还是远程服务器。
只要先把“谁发请求、从哪里读配置、在哪一层失败”这三个问题想清楚,大部分代理故障都能很快从玄学变成可验证的工程问题。
我是大伟/Wei•Will,专注 AI 应用落地与 Agent 开发,关注我,我们一起成长。