FlyingBird返回首页

浏览器能走代理但命令行不行怎么办?

更新于 2026-11-14 · flyingbird.buzz

简答:先用 curl --proxy 显式测试代理端口;测试成功后,为当前终端设置 http_proxy、https_proxy 或 all_proxy。Git、npm、pip、Docker 仍失败时,再检查各自的独立配置;WSL 还要确认 Windows 主机地址、防火墙和监听范围。

定义:浏览器能走代理但命令行不行,通常是浏览器读取了系统代理或扩展设置,而命令行程序没有继承环境变量、使用了错误端口,或被工具自身配置覆盖。

先做三步判断:不要先换节点

如果浏览器可以正常访问,而 curl、Git 或包管理器失败,先把问题拆成三层:①用显式代理测试本地端口;②给当前终端设置代理变量;③按具体工具检查独立配置。这样可以先区分“代理端口不可用”和“命令行没有使用代理”。

  1. 显式测端口:使用 curl.exe -I --proxy,绕过系统代理和旧环境变量。
  2. 设置当前终端:根据 PowerShell、CMD、Git Bash、WSL 或 macOS/Linux 使用对应命令。
  3. 处理工具配置:Git、npm、pip、Docker 的代理入口不完全相同,不能只依赖系统代理。
curl.exe -I --proxy http://127.0.0.1:7890 https://example.com

如果客户端提供的是 SOCKS5 端口,改用:

curl.exe -I --proxy socks5h://127.0.0.1:7891 https://example.com

--proxy 会覆盖代理环境变量;curl 也支持 http_proxy、HTTPS_PROXY、ALL_PROXY 和 NO_PROXY 等变量。参考 curl 官方教程 与 curl 官方命令手册。

测试结果优先判断下一步
返回 HTTP 响应本地代理端口和基本转发可用设置当前终端变量,再检查具体工具。
Connection refused端口没有监听、地址错误或协议类型不匹配核对 HTTP、SOCKS5、mixed 和控制端口。
Operation timed out节点上游、网络路径、防火墙或监听范围异常用同一端口更换已知可用节点,并查看客户端日志。
Could not resolve hostDNS 解析失败,或代理没有代替本地解析优先测试 socks5h://,再检查 DNS。
TLS 证书错误证书链、系统时间或 HTTPS 检查导致失败先确认代理类型和系统时间,不要先关闭证书校验。

系统代理为什么不等于命令行代理?

浏览器可能读取系统代理、PAC 文件或扩展设置;命令行程序则经常读取环境变量,或者只读取自己的配置文件。因此,“系统代理已开启”不能证明 curl、Git、npm 或 Docker 一定会使用它。

代理入口常见适用对象容易出错的地方
系统代理或 PAC支持系统代理的浏览器和应用命令行程序可能不读取,或被工具设置覆盖。
环境变量curl、部分 Git、pip、PowerShell 7 等变量没有导出、只设置了当前窗口、大小写或地址格式错误。
工具专属配置Git、npm、Docker、部分包管理器旧配置指向已关闭端口,或配置协议与端口不匹配。
TUN 或虚拟网卡需要接管不支持代理变量的程序与系统代理或环境变量重复接管,造成路由和 DNS 冲突。

HTTP 代理访问 HTTPS 目标并不矛盾:客户端通常通过 HTTP CONNECT 建立隧道。关键是端口确实提供 HTTP 代理服务,而不是 SOCKS5 端口或控制端口。

跨平台代理变量速查:设置、查看、清除

环境临时设置查看清除可能的持久位置
PowerShell$env:http_proxy="http://127.0.0.1:7890"Get-ChildItem Env:*proxy*Remove-Item Env:http_proxy,Env:https_proxy,Env:all_proxy,Env:no_proxy用户环境变量或 PowerShell 配置文件
CMDset http_proxy=http://127.0.0.1:7890set | findstr /i proxyset http_proxy=系统或用户环境变量
Git Bashexport http_proxy=http://127.0.0.1:7890env | grep -i proxyunset http_proxy https_proxy all_proxy no_proxy~/.bashrc 或 ~/.bash_profile
WSLexport http_proxy=http://主机地址:7890env | grep -i proxyunset http_proxy https_proxy all_proxy no_proxy~/.bashrc、.wslconfig
macOS/Linuxexport http_proxy=http://127.0.0.1:7890env | grep -i proxyunset http_proxy https_proxy all_proxy no_proxy~/.zshrc、~/.bashrc

建议先只在当前窗口设置变量。代理客户端关闭后,如果变量仍指向本地端口,新的命令行窗口可能继续出现连接失败。

PowerShell

$env:http_proxy  = "http://127.0.0.1:7890"
$env:https_proxy = "http://127.0.0.1:7890"
$env:all_proxy   = "http://127.0.0.1:7890"
$env:no_proxy    = "localhost,127.0.0.1"

curl.exe -Iv https://example.com

Windows PowerShell 5.1 中,curl 是 Invoke-WebRequest 的别名,参数与真正的 curl 不同,因此本文使用 curl.exe。Microsoft 说明,PowerShell 5.1 可显式调用 curl.exe;Invoke-WebRequest 也支持 -Proxy 参数。参考 Microsoft 的 Windows curl 说明 和 Windows PowerShell 5.1 Invoke-WebRequest 文档。

Invoke-WebRequest -Uri https://example.com -Proxy http://127.0.0.1:7890

PowerShell 7 的 Web Cmdlet 支持从环境变量读取代理配置;如果需要指定单次请求的代理,仍可使用 -Proxy。清除当前 PowerShell 会话中的大小写变量:

Remove-Item Env:http_proxy,Env:https_proxy,Env:all_proxy,Env:no_proxy -ErrorAction SilentlyContinue
Remove-Item Env:HTTP_PROXY,Env:HTTPS_PROXY,Env:ALL_PROXY,Env:NO_PROXY -ErrorAction SilentlyContinue

CMD、Git Bash、macOS 和 Linux

set http_proxy=http://127.0.0.1:7890
set https_proxy=http://127.0.0.1:7890
set all_proxy=http://127.0.0.1:7890
set no_proxy=localhost,127.0.0.1
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export all_proxy=http://127.0.0.1:7890
export no_proxy=localhost,127.0.0.1,.local

curl -Iv https://example.com

如果变量写入启动文件,清除当前窗口并不会删除持久设置,需要回到对应文件或系统环境变量界面移除。

WSL:主机地址、监听范围和防火墙要一起检查

在默认 NAT 网络下,WSL 中的 127.0.0.1通常指向 WSL 自身,不一定是 Windows 主机。Microsoft 建议从 WSL 的默认路由获取 Windows 主机地址;启用 DNS Tunneling 后,/etc/resolv.conf 中的 nameserver 可能是特殊地址,不能把它直接当成主机代理地址。参考 Microsoft WSL 网络文档。

ip route show | grep -i default | awk '{ print $3 }'

假设输出为 172.20.64.1,先在 WSL 当前会话中测试:

export http_proxy=http://172.20.64.1:7890
export https_proxy=http://172.20.64.1:7890
export all_proxy=http://172.20.64.1:7890

curl -Iv https://example.com

如果得到 Connection refused 或超时,还要检查三项:代理客户端是否开启“允许局域网连接”,是否监听了 Windows 主机可访问的地址,例如 0.0.0.0,以及 Windows 防火墙是否允许该端口。只在本机监听 127.0.0.1 的代理,通常无法被 NAT 模式下的 WSL 通过主机 IP访问。

Windows 11 22H2 及更高版本可以考虑 mirrored networking 和 autoProxy=true。Microsoft 文档说明,mirrored 模式支持从 WSL 使用 Windows 的 localhost 服务,autoProxy=true 会让 WSL 使用 Windows 的 HTTP 代理信息。修改后执行:

[wsl2]
networkingMode=mirrored
autoProxy=true
wsl --shutdown

不要同时保留旧的主机 IP、127.0.0.1 和自动代理三条路径。每次只启用一种,再用 curl -Iv 验证。

Git:HTTPS 远程用 http.proxy,SSH 远程要走 ProxyCommand

Git 的 HTTPS 远程地址可以使用 http.proxy;Git 官方配置文档没有独立的 https.proxy 键。需要按网址限定时,可使用 http.https://主机.proxy 这类 URL 专属配置。参考 Git 官方 git-config 文档。

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

git ls-remote https://example.com/owner/repo.git

移除全局代理:

git config --global --unset http.proxy

若只想限定某个 HTTPS 主机,可按 Git 的 URL 匹配规则配置,例如:

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

git@主机:仓库 和 ssh:// 属于 SSH 路径,不能靠 http.proxy 解决。Git 支持通过 GIT_SSH_COMMAND 或 core.sshCommand 指定 SSH 命令。参考 Git 官方命令文档。

在 macOS/Linux 或支持对应参数的 Git Bash 环境,可使用 SOCKS5 转发:

GIT_SSH_COMMAND='ssh -o ProxyCommand="nc -X 5 -x 127.0.0.1:7891 %h %p"' git ls-remote [email protected]:owner/repo.git

Git for Windows 环境中,如果系统自带的 nc 不支持 -X,可以改用 Git for Windows 提供的 connect.exe,并在 ~/.ssh/config 中写入:

Host example.com
  ProxyCommand connect.exe -S 127.0.0.1:7891 %h %p

执行前先用 where connect.exe 确认程序存在;如果没有,应改用环境中已有的 SOCKS 转发工具。

npm、pip 和 Docker:不要把不同代理范围混在一起

npm

npm 使用自己的 proxy 和 https-proxy 配置,也可能读取代理环境变量。可以先设置,再用 npm ping 验证:

npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890
npm ping

清除 npm 配置:

npm config delete proxy
npm config delete https-proxy

参考 npm 官方配置文档。

pip

pip 支持命令行 --proxy、配置文件以及 http_proxy、https_proxy 和 no_proxy 环境变量。先用单次命令测试,避免把错误端口永久写入配置:

python -m pip install --proxy http://127.0.0.1:7890 package-name

参考 pip 官方用户指南。

Docker CLI、容器和 daemon

Docker 的三个范围要分开:~/.docker/config.json 主要给新建容器和构建过程注入代理变量;它不是 Docker Engine daemon 的代理配置,也不负责解决 docker pull 的 daemon 出网问题。参考 Docker CLI 代理文档 和 Docker daemon 代理文档。

Docker Desktop 容器访问宿主机代理时,不要写 127.0.0.1,因为容器内的回环地址指向容器自身。Docker Desktop 提供 host.docker.internal 作为宿主机地址,可写成:

{
  "proxies": {
    "default": {
      "httpProxy": "http://host.docker.internal:7890",
      "httpsProxy": "http://host.docker.internal:7890",
      "noProxy": "localhost,127.0.0.1"
    }
  }
}

该配置只影响之后创建的容器和构建,且代理变量可能以明文出现在容器配置中,不要把带密码的代理地址提交到仓库。参考 Docker Desktop 网络文档。

如果失败的是 docker pull,应配置 daemon,而不是只修改客户端文件。Linux Engine 可在 /etc/docker/daemon.json 中配置:

{
  "proxies": {
    "http-proxy": "http://192.168.1.10:7890",
    "https-proxy": "http://192.168.1.10:7890",
    "no-proxy": "localhost,127.0.0.1"
  }
}
sudo systemctl restart docker

Docker Desktop 则应在其设置中的代理页面配置;官方说明指出,daemon.json 中的 daemon 代理设置不会作用于 Docker Desktop。

如何确认命令真的经过代理?

只看到命令返回成功,还不能证明它使用了预期的代理。可以结合出口 IP、详细日志和客户端连接日志验证。

  1. 对比出口 IP:先测试代理,再测试明确绕过代理的请求。
curl -s https://ifconfig.me
curl -s --noproxy '*' https://ifconfig.me

如果两次结果不同,说明请求路径可能不同;如果结果相同,不能单独据此断定代理无效,还要继续看详细日志。

  1. 查看 curl 详细信息:
curl -v https://example.com

日志中可留意 Uses proxy env variable、代理地址以及 HTTPS 目标建立的 CONNECT 行。如果使用显式代理,则执行:

curl -v --proxy http://127.0.0.1:7890 https://example.com
  1. 查看工具配置:
git config --show-origin --get-regexp 'proxy'
npm config get proxy
npm config get https-proxy
python -m pip config list
  1. 查看客户端日志:

在代理客户端日志中查找对应时间、目标域名和连接记录。如果 curl 显式测试成功,但环境变量测试失败,问题通常在变量继承、变量格式或 NO_PROXY;如果显式测试也失败,则优先检查监听地址、端口类型、节点和防火墙。

什么时候才考虑 TUN 模式?

当某个程序不读取系统代理、环境变量,也没有可配置的代理入口时,TUN 或虚拟网卡才更适合作为下一步。例如部分桌面应用、开发工具或需要接管多种协议的程序,单独设置 http_proxy 可能不起作用。

启用 TUN 前,先关闭重复的系统代理或确认客户端对两者有明确的分流设计;同时检查虚拟网卡权限、路由和 DNS。TUN 不是端口测试的替代品:如果本地代理端口本身没有监听,开启 TUN 也不能修复节点或客户端内核故障。

可以继续参考 TUN 模式打不开时的权限、虚拟网卡与断网排查,按“端口测试成功但程序仍不走代理”的场景处理。

常见问题

浏览器能走代理但 curl 不行,应该先改系统代理吗?

不必先改系统代理。先用 curl -I --proxy http://地址:端口 https://example.com/ 显式测试;成功后再设置环境变量,可以先排除端口和节点问题。

Windows PowerShell 里为什么 curl -x 会报错?

Windows PowerShell 5.1 中 curl 可能是 Invoke-WebRequest 的别名,不支持真正 curl 的参数。请使用 curl.exe -x,或改用 Invoke-WebRequest -Proxy。

Git 设置了 http.proxy,为什么 git@地址仍然失败?

git@主机:仓库使用 SSH,不由 Git 的 HTTP 代理配置负责。需要单独配置 SSH 的 ProxyCommand、GIT_SSH_COMMAND 或 core.sshCommand。

WSL 中应该使用 127.0.0.1 还是 Windows 主机 IP?

默认 NAT 模式下先使用 ip route show 获取默认网关,并确认 Windows 代理允许局域网连接且防火墙放行端口。启用 mirrored networking 后,127.0.0.1 才可能直接访问 Windows 主机服务。

Docker 配置里的 127.0.0.1 为什么经常不生效?

容器内的 127.0.0.1 指向容器自身,不是宿主机。Docker Desktop 容器访问宿主机服务时可使用 host.docker.internal;如果是 docker pull 失败,则应配置 daemon 或 Docker Desktop 的代理。

关闭代理客户端后,为什么命令行仍然连接超时?

常见原因是环境变量、Git、npm 或 Docker 配置仍指向已关闭的本地端口。清除大小写代理变量,并检查工具的独立配置和启动文件。

相关阅读

参考资料

  1. curl 官方教程:代理环境变量与 NO_PROXY
  2. curl 官方命令手册:--proxy 与 socks5h
  3. Microsoft Learn:Windows curl 与 PowerShell 5.1 别名
  4. Microsoft Learn:PowerShell Web Cmdlet 环境变量代理
  5. Microsoft Learn:WSL 网络、默认网关与主机访问
  6. Microsoft Learn:WSL NAT、mirrored networking 与 autoProxy
  7. Git 官方 git-config:http.proxy、URL 专属配置与 SSH 配置
  8. Git 官方命令文档:GIT_SSH_COMMAND
  9. npm 官方配置文档:proxy 与 https-proxy
  10. pip 官方用户指南:代理参数、配置文件与环境变量
  11. Docker 官方:CLI、构建和容器代理配置
  12. Docker 官方:daemon 代理配置与 docker pull