终端源码安装DeepSeek Harness失败,是时候彻底搞懂网络代理了(一文清晰讲清楚网络代理)

大家好,我是大伟/Wei•Will,深耕软件工程一线,专注AI应用落地与Agent开发。

这是开发环境里很常见的一幕:浏览器打开 GitHub、模型平台或者海外技术网站都正常,终端里的 curl、git clone 和包管理器下载却一直超时。代理客户端明明已经显示“已连接”,浏览器也证明网络能用,为什么终端不通?

很多人遇到这类问题时,第一反应是反复切换代理节点、重启终端,或者怀疑目标网站限制了命令行请求。

从github上下载deepseek-harness

问题通常没有那么神秘,核心原因是:

“电脑开了代理”不是一个准确的技术描述。更准确的说法是,某个应用、某个进程,或者某一层网络路由知道代理在哪里,并且决定把请求交给它。

浏览器和终端不是同一个网络入口。浏览器能走代理,只能说明浏览器当前这条请求链路成立,不能证明终端里启动的所有程序都会自动继承这条链路。

思维导图

思维导图

“开了代理”为什么不是一个总开关

我们平时说“代理已经打开”,背后可能是完全不同的实现方式。

第一种是浏览器扩展代理。扩展通过浏览器提供的能力接管请求,只有这个浏览器或指定的浏览器配置生效。终端里的 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
2
3
4
5
6
function FindProxyForURL(url, host) {
if (dnsDomainIs(host, ".internal.example")) {
return "DIRECT";
}
return "PROXY 127.0.0.1:7890";
}

这段规则没有转发任何流量,它只是返回一个决定:当前地址直连,还是交给哪个代理。真正发起连接的仍然是浏览器。PAC 的关键价值是自动选路,不是代理本身。

第四种是 Shell 环境变量。我们在终端里设置 http_proxy、https_proxy 或 all_proxy,支持这些变量的命令行程序会在启动时读取它们。这类配置通常只影响当前 Shell 以及它启动的子进程,不会反过来改变浏览器。即使是 DeepSeek Harness 这类从终端启动的应用,也要看它使用的网络库和启动方式是否读取这些变量,不能因为它运行在终端里,就默认它会使用代理。

第五种是 VPN 或 TUN 模式。它不再要求每个应用主动理解代理,而是在更底层修改路由或接管网络流量,所以覆盖范围通常更广。但“更广”也不等于“绝对全部”,分流规则、进程规则、IPv6、DNS 和虚拟网络仍然可能让部分请求绕开代理。

比如使用 Codex 或其他本地 Agent 时,如果日志表现为连续多次重连,而浏览器访问正常,可以把 TUN 模式作为一次对照实验。它有时能解决问题,不是因为 TUN 模式“更快”,而是因为它改变了流量接管的层级。

这类问题在日志里经常表现为:请求已经发起,但连接反复重试,最后仍然无法建立。此时把 TUN 模式作为对照项,比盲目更换节点更容易判断问题到底出在哪一层。

Codex每次新请求重连5次

这些方式看起来都叫“开代理”,作用层级却完全不同。

所以排查时,第一个问题不应该是“代理开没开”,而应该是:

现在到底是哪一层在让浏览器走代理?

只要这个问题没回答清楚,后面所有配置都容易变成碰运气。

浏览器为什么能访问,终端却失败

浏览器之所以表现得“更容易成功”,是因为它通常已经和代理配置形成了一条完整链路。

如果使用浏览器扩展,扩展会根据域名规则决定直连还是代理;如果使用系统代理,浏览器可能直接读取系统设置;如果配置了 PAC 文件,浏览器还可以在每次请求前执行规则,为不同域名选择不同出口。

所以,浏览器的优势不只是“拿到了一个代理地址”,还在于它能自动完成选路。命令行工具通常只知道“直接连接”或“使用一个固定代理”,并不知道这张 PAC 分流表,因此它们和浏览器得到不同结果很正常。

终端本身不是网络客户端,它只是一个交互界面。真正发起请求的是里面运行的具体进程,例如:

  • curl 发起 HTTP 请求;
  • Git 在执行 git clone 等命令时,通过自己的 HTTP 传输层访问远程仓库;
  • npm、Maven、Gradle 等包管理工具下载依赖;
  • Java、Node.js、Python 程序使用各自的网络库调用接口;
  • Docker 客户端把请求交给 Docker daemon,再由 daemon 拉取镜像。

这些程序来自不同生态,对代理配置的读取方式并不统一。有的读取环境变量,有的读取自己的配置文件,有的读取系统代理,有的只接受启动参数,还有的默认什么都不读。

这就像公司里已经有一辆班车,并不代表每个员工都知道车停在哪里、几点发车。浏览器拿到了路线,终端里的另一个进程没有拿到,最终表现就是一个能访问,一个超时。

还有一种常见情况是:浏览器使用 PAC 自动分流,而命令行工具只认识一个固定代理地址。浏览器知道访问某个域名时应该走哪条线路,终端工具却不会执行 PAC 里的规则,自然无法得到同样的结果。

所以,“浏览器可以打开”只能证明目标站点和代理服务本身大概率可用,不能证明终端已经配置完成。

终端里的请求到底怎么决定走不走代理

一条命令行请求发出去之前,可以从下面几层去看:

1
2
3
4
5
6
7
8
9
工具自己的代理配置
↓
进程读取到的代理环境变量
↓
工具支持的系统代理或 PAC 配置
↓
VPN、TUN、路由与 DNS 规则
↓
直接连接目标地址

具体顺序会因工具而异,但这个模型足够帮助我们定位问题。

例如,在 Shell 里执行:

1
2
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890

这不是把整个终端“接入代理”,而是给当前 Shell 增加两个环境变量。之后从这个 Shell 启动、并且愿意读取这些变量的进程,才可能使用代理。

这也解释了几个看似奇怪的现象。

如果变量只是赋值,没有 export,它可能只是 Shell 内部变量,子进程看不到。

如果配置写进了 ~/.zshrc,但当前终端没有重新加载,新启动的命令仍然拿不到。

如果某个长期运行的进程、IDE、后台服务或 tmux 会话在设置代理之前就已启动,它也可能继续使用旧环境。

如果使用 sudo 执行命令,提权后的环境可能被清理,原来的代理变量不会自动保留。

这里还要特别注意 no_proxy 和 NO_PROXY。它们不是“代理地址”,而是一张不走代理的例外清单:命令行工具匹配到清单中的地址后,会直接连接目标,不再经过代理。

例如:

1
2
export no_proxy="localhost,127.0.0.1,::1,service.internal.example,.corp.example"
export NO_PROXY="$no_proxy"

这通常用于避免本机服务、回环地址和企业内网请求绕到外部代理。但 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
2
export all_proxy=socks5h://127.0.0.1:7891
export ALL_PROXY="$all_proxy"

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
2
3
curl -I -v --connect-timeout 10 \
-x http://127.0.0.1:7890 \
https://github.com

如果第一条失败、第二条成功,问题基本已经缩小:网络和代理服务大概率都正常,缺的是终端进程的代理配置。

如果当前环境设置了 no_proxy,要明确禁止 curl 绕过代理,可以使用 --noproxy ""。否则目标地址一旦命中 no_proxy,即使命令行里写了 -x,测试结果也可能不是你以为的“强制走代理”。

1
2
3
4
curl -I -v --connect-timeout 10 \
--noproxy "" \
-x http://127.0.0.1:7890 \
https://github.com

如果第二条直接提示无法连接 127.0.0.1:7890,先不要继续折腾 Git 或包管理器。应该确认代理客户端是否启动、监听端口是否正确:

1
nc -vz 127.0.0.1 7890

也可以查看本机监听状态:

1
lsof -nP -iTCP:7890 -sTCP:LISTEN

如果端口根本没有监听,再多的环境变量也没有意义。

第三步:先做一次性配置,不要急着写进启动文件

为了避免污染长期环境,可以先只给一条命令传递代理:

1
2
3
http_proxy=http://127.0.0.1:7890 \
https_proxy=http://127.0.0.1:7890 \
curl -I https://github.com

一次性测试成功后,再决定是否导出到当前会话:

1
2
3
4
5
6
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export HTTP_PROXY="$http_proxy"
export HTTPS_PROXY="$https_proxy"
export no_proxy="localhost,127.0.0.1,::1"
export NO_PROXY="$no_proxy"

同时设置大小写,是为了兼容不同工具,但要保持对应值一致,也不要因此忽略安全边界。生产脚本、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
2
npm config get proxy
npm config get https-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
2
3
4
5
6
1. 请求在哪个进程和环境里执行?
2. 浏览器使用的是扩展、系统代理、PAC,还是 TUN?
3. 目标工具读取了哪些代理变量或配置?
4. 显式指定代理后,同一个 URL 能否访问?
5. 失败发生在连接、DNS、TLS,还是应用认证阶段?
6. 请求是否跨过 Docker、WSL、SSH 或远程 Agent 边界?

这套顺序的价值,不只是解决一次网络问题,而是避免把不同层级的故障混在一起。

总结:先确认代理作用在哪一层

浏览器走代理、终端却不走,本质上不是浏览器和终端谁更特殊,而是它们拿到的网络配置不同。

浏览器可能通过扩展、系统代理或 PAC 找到了出口;终端里的具体进程则可能没有读取环境变量,也可能被 no_proxy 明确要求直连,或者使用自己的代理配置。即使已经连接代理,请求还可能继续卡在协议、DNS、证书、分流规则和远程环境边界上。

下一次再遇到这个问题,不要先反复重启代理客户端。先做三个动作:

  1. 用 env | grep -i proxy 确认当前进程环境;
  2. 用 curl -x(必要时加 --noproxy "")对同一个 URL 做显式代理对照;
  3. 确认命令实际运行在本机、容器、WSL,还是远程服务器。

只要先把“谁发请求、从哪里读配置、在哪一层失败”这三个问题想清楚,大部分代理故障都能很快从玄学变成可验证的工程问题。

我是大伟/Wei•Will,专注 AI 应用落地与 Agent 开发,关注我,我们一起成长。