CordCloud - 高速网络服务返回首页

终端命令行网络代理怎么配置与取消?

更新于 2026-11-15 · cordc.site

简答:浏览器能上网、终端却超时,通常是终端没有读取系统网络设置,或 Git、npm、Docker 使用了独立配置。先确认实际地址和端口,再按当前终端、单个工具、Docker daemon 三层配置;用 curl 验证,最后保留可撤销命令。

定义:终端网络代理配置,是把命令行程序的请求交给指定地址,并通过环境变量或工具自身配置控制范围。

先做这张速查卡:设置、验证、取消

先在正在使用的网络工具设置中确认实际监听地址和端口。本文用 127.0.0.1:8080 作为示例,端口必须替换成你的实际结果;如果工具只提供局域网地址,使用该地址,不要照搬回环地址。

三类终端的临时配置与取消
终端设置验证变量取消
bash、zsh、WSLexport http_proxy='http://127.0.0.1:8080'
export https_proxy='http://127.0.0.1:8080'
env | grep -i proxyunset HTTP_PROXY HTTPS_PROXY ALL_PROXY NO_PROXY http_proxy https_proxy all_proxy no_proxy
PowerShell$env:HTTP_PROXY='http://127.0.0.1:8080'
$env:HTTPS_PROXY='http://127.0.0.1:8080'
Get-ChildItem Env: | Where-Object Name -match 'proxy'Remove-Item Env:HTTP_PROXY,Env:HTTPS_PROXY,Env:ALL_PROXY,Env:NO_PROXY -ErrorAction SilentlyContinue
CMDset HTTP_PROXY=http://127.0.0.1:8080
set HTTPS_PROXY=http://127.0.0.1:8080
set | findstr /I "proxy"set HTTP_PROXY=
set HTTPS_PROXY=
set ALL_PROXY=
set NO_PROXY=

Windows 环境变量名不区分大小写,设置一套大写和一套小写并不是两套独立变量。Unix 系统则建议优先设置小写的 http_proxy,因为 curl 对 http_proxy 只读取小写形式;其他协议变量通常同时支持大小写,小写优先。curl 命令说明列出了变量优先级和 ALL_PROXY、NO_PROXY 的作用。

ALL_PROXY 是没有对应协议变量时使用的通用代理变量;只有在确认工具支持该写法时才设置它。需要使用本地工具提供的另一种地址类型时,可将其写入 ALL_PROXY,但不要同时留下互相冲突的协议变量。NO_PROXY 用于排除本机、内网域名或内部服务,先写具体主机,不要一开始使用 *。

按顺序配置:确认端口、设置当前终端、用 curl 验证

  1. 确认地址类型。在网络工具设置中找到 HTTP、HTTPS 或其他本地监听端口,记录地址、端口和是否要求认证。不能只根据常见端口数字判断类型。
  2. 只设置当前终端。先不要修改启动文件或系统环境变量,使用上一节对应命令配置。这样关闭窗口即可恢复,便于判断问题是否来自配置。
  3. 先测显式地址。将示例中的端口替换为实际结果:
curl -I --proxy http://127.0.0.1:8080 --connect-timeout 10 --max-time 20 https://example.com

如果显式测试成功,再测试环境变量:

curl -I --connect-timeout 10 --max-time 20 https://example.com

建议第一次执行 1 次;若出现间歇性超时,再连续执行 2 次,并记录错误文本、端口和耗时。显式的 --proxy 会覆盖环境变量,适合区分“端口不可用”和“变量没有被读取”。curl 网络请求教程说明了代理变量和绕过列表的用法。

测试结果对应的下一步
现象优先检查处理方向
显式 curl 也失败地址、端口、类型、监听状态重新核对网络工具设置,并检查本机安全软件或防火墙
显式 curl 成功,环境变量失败变量名称、当前进程和大小写重新打开终端,查看变量是否存在
curl 成功,Git或npm失败工具独立配置、仓库地址、证书和认证单独查看该工具配置
Docker命令能运行但镜像拉取失败Docker CLI与daemon是否分开配置实际负责拉取镜像的daemon

如果地址包含用户名或密码,@、:、#、?等字符需要进行 URL 编码。不要在命令行中直接输入真实凭据:shell 历史、构建日志和错误日志可能保存完整地址。

Git、npm、pnpm、Yarn和pip的独立配置

Git 的 HTTPS 仓库

Git 新版命令的顺序是“子命令在前、选项随后”。Git 的 HTTP 传输配置用于 HTTP(S) 远程,不要把不存在或未核实的 https.proxy 当作必需项。

git config set --global http.proxy http://127.0.0.1:8080
git config get --global http.proxy
git config unset --global http.proxy

如果当前 Git 版本仍使用传统兼容语法,可执行:

git config --global http.proxy http://127.0.0.1:8080
git config --global --get http.proxy
git config --global --unset http.proxy

先执行 git --version,再按本机版本选择语法。Git 配置文档列出了 set、get、unset 的语序和配置文件范围。

Git 的 SSH 仓库

Git 的 HTTP 配置不会自动改变 SSH 连接。若组织提供跳板机,可在 ~/.ssh/config 中使用 ProxyJump;如果本机有支持 HTTP CONNECT 的命令工具,也可使用 ProxyCommand。下面是按本机地址和端口改写的示例:

Host code-host
    HostName git.example.com
    User git
    ProxyCommand nc -X connect -x 127.0.0.1:8080 %h %p

该写法依赖本机存在支持相应参数的 nc,不保证所有 Windows 环境自带。取消时删除或注释对应的 Host code-host 区块。Unix 或 Git Bash 可执行:

ssh -G code-host | grep -i proxy

PowerShell 可执行:

ssh -G code-host | Select-String -Pattern 'proxy|hostname|port'

ProxyJump 是跳板机方案,不等于本机端口转发;是否支持通过特定端口连接,应以代码托管平台文档为准。OpenSSH 配置说明介绍了 ProxyCommand 和 ProxyJump。

npm、pnpm、Yarn和pip

npm config set proxy http://127.0.0.1:8080
npm config set https-proxy http://127.0.0.1:8080
npm config get proxy
npm config get https-proxy
npm config delete proxy
npm config delete https-proxy

npm 会读取相关环境变量,也支持独立的 proxy 和 https-proxy 配置。pnpm 先查看当前实际配置,避免凭记忆写入未知字段:

pnpm config list

Yarn Berry 项目级配置写入 .yarnrc.yml:

httpProxy: "http://127.0.0.1:8080"
httpsProxy: "http://127.0.0.1:8080"

取消时删除这两行,或只使用当前终端环境变量。Yarn 配置文件说明确认了 .yarnrc.yml、httpProxy和httpsProxy字段。

pip 适合先用单次参数验证:

python -m pip install --proxy http://127.0.0.1:8080 包名
python -m pip config debug
python -m pip config list

配置文件位置因系统和虚拟环境而异,先用 pip config debug确认实际读取路径。npm 配置文档和pip 配置文档可用于核对字段、优先级和配置位置。

Docker 分层配置:客户端、daemon、构建和容器

Docker 最容易误判的地方是作用范围:~/.docker/config.json主要为新容器和构建阶段注入环境变量,不等于 Docker CLI 或 Docker Engine daemon 已经具备网络代理;镜像拉取失败时,通常要检查实际运行镜像拉取任务的 daemon。Docker CLI 代理说明明确区分了客户端、容器和构建阶段。

容器和构建阶段

宿主机上的 ~/.docker/config.json 可以写:

{
  "proxies": {
    "default": {
      "httpProxy": "http://宿主机可达地址:8080",
      "httpsProxy": "http://宿主机可达地址:8080",
      "noProxy": "localhost,127.0.0.1,::1"
    }
  }
}

这里不能直接把 127.0.0.1 当作容器访问宿主机的地址,因为容器内的回环地址指向容器自身。应使用容器能够访问的宿主机名称或局域网地址,并以你的 Docker 网络模式测试结果为准。该配置只对新创建的容器和新构建生效,已有容器不会自动更新。

Linux 独立 Docker Engine 的 daemon

如果镜像拉取由 Linux 宿主机上的独立 daemon 执行,可用 systemd drop-in:

sudo mkdir -p /etc/systemd/system/docker.service.d
sudo tee /etc/systemd/system/docker.service.d/http-proxy.conf >/dev/null <<'EOF'
[Service]
Environment="HTTP_PROXY=http://127.0.0.1:8080"
Environment="HTTPS_PROXY=http://127.0.0.1:8080"
Environment="NO_PROXY=localhost,127.0.0.1,::1"
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker
sudo systemctl show --property=Environment docker

此处的回环地址指向 daemon 所在宿主机,因此与容器配置不是同一语境。rootless 模式的文件路径和命令不同,应按官方说明使用用户级 systemd。

取消 daemon 配置:

sudo rm /etc/systemd/system/docker.service.d/http-proxy.conf
sudo systemctl daemon-reload
sudo systemctl restart docker

也可以使用 /etc/docker/daemon.json,但不要同时为同一配置项设置冲突的启动参数。Docker daemon 代理配置说明了 daemon.json、systemd、重载和重启要求。

Docker Desktop

桌面版不直接套用 Linux 独立 daemon 的文件路径。请在当前版本的桌面设置中查找网络代理页面,并只填写界面实际支持的地址类型;菜单和可用类型可能随版本变化,未核实的选项不要强行填写。

永久写入前备份,取消时恢复同一个文件

临时配置验证成功后,再决定是否写入启动文件。bash 只追加到 ~/.bashrc,zsh 只追加到 ~/.zshrc,不要两个文件都重复写入。

cp ~/.bashrc ~/.bashrc.backup.$(date +%Y%m%d-%H%M%S) 2>/dev/null || true
printf '%s
' 'export http_proxy="http://127.0.0.1:8080"' 'export https_proxy="http://127.0.0.1:8080"' 'export no_proxy="localhost,127.0.0.1,::1"' >> ~/.bashrc
. ~/.bashrc

zsh 的写法:

cp ~/.zshrc ~/.zshrc.backup.$(date +%Y%m%d-%H%M%S) 2>/dev/null || true
printf '%s
' 'export http_proxy="http://127.0.0.1:8080"' 'export https_proxy="http://127.0.0.1:8080"' 'export no_proxy="localhost,127.0.0.1,::1"' >> ~/.zshrc
. ~/.zshrc

取消时恢复刚才备份的同一个文件,再删除当前会话变量:

ls -lt ~/.bashrc.backup.* ~/.zshrc.backup.* 2>/dev/null
cp ~/.bashrc.backup.实际时间戳 ~/.bashrc
unset HTTP_PROXY HTTPS_PROXY ALL_PROXY NO_PROXY http_proxy https_proxy all_proxy no_proxy

PowerShell Profile 也要先备份:

Copy-Item $PROFILE "$PROFILE.backup"
notepad $PROFILE

删除文件中的代理配置后,重新打开 PowerShell。只执行 Remove-Item Env: 只能取消当前窗口,不能删除 Profile 中的永久设置。使用 Windows 用户环境变量界面或 setx 写入的配置,应在“环境变量”中删除对应项;新窗口才会读取修改结果。

本站建议:每次只修改一层配置,先用 curl,再测具体工具;如果所在单位使用跨境办公线路,应通过具备资质的运营商办理,并核对合同与合规范围。

常见问题

为什么浏览器能用,终端却不能联网?

浏览器可能读取系统网络设置,而终端通常读取环境变量或自己的配置。先查看当前进程中的变量,再用 curl 的显式代理参数测试地址和端口。

HTTP、HTTPS和其他本地地址类型可以互换吗?

不建议互换。地址类型由网络工具实际监听情况决定,先确认设置页面显示的类型,再用 curl 显式测试,成功后才写入环境变量。

curl成功但Git、npm或pip仍失败怎么办?

先检查该工具自己的代理配置、仓库地址、证书和认证。Git的HTTP(S)仓库与SSH仓库属于不同连接方式,不能只修改同一个配置项。

Docker配置后仍然拉取镜像失败怎么办?

先区分容器构建配置和daemon配置。Linux独立Engine需要配置daemon并执行daemon-reload、重启和环境检查;桌面版则以当前设置界面为准。

怎样取消配置而不留下空变量?

Unix使用unset,PowerShell使用Remove-Item Env:变量名,CMD使用set 变量名=。不要把空字符串当作三种系统通用的删除方式。

相关阅读

参考资料

  1. curl 命令说明:代理参数、环境变量与大小写规则
  2. curl 网络请求教程:代理与绕过列表
  3. Git 配置文档:set、get、unset与代理配置
  4. OpenSSH 配置说明:ProxyCommand与ProxyJump
  5. npm 配置文档:proxy与https-proxy
  6. Yarn 配置文件说明:.yarnrc.yml与代理字段
  7. pip 配置文档:配置层级与调试命令
  8. Docker CLI 代理说明:容器与构建阶段
  9. Docker daemon 代理配置:systemd与daemon.json