终端命令行网络代理怎么配置与取消?
简答:浏览器能上网、终端却超时,通常是终端没有读取系统网络设置,或 Git、npm、Docker 使用了独立配置。先确认实际地址和端口,再按当前终端、单个工具、Docker daemon 三层配置;用 curl 验证,最后保留可撤销命令。
定义:终端网络代理配置,是把命令行程序的请求交给指定地址,并通过环境变量或工具自身配置控制范围。
先做这张速查卡:设置、验证、取消
先在正在使用的网络工具设置中确认实际监听地址和端口。本文用 127.0.0.1:8080 作为示例,端口必须替换成你的实际结果;如果工具只提供局域网地址,使用该地址,不要照搬回环地址。
| 终端 | 设置 | 验证变量 | 取消 |
|---|---|---|---|
| bash、zsh、WSL | export http_proxy='http://127.0.0.1:8080'export https_proxy='http://127.0.0.1:8080' | env | grep -i proxy | unset 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 |
| CMD | set HTTP_PROXY=http://127.0.0.1:8080set HTTPS_PROXY=http://127.0.0.1:8080 | set | findstr /I "proxy" | set HTTP_PROXY= |
Windows 环境变量名不区分大小写,设置一套大写和一套小写并不是两套独立变量。Unix 系统则建议优先设置小写的 http_proxy,因为 curl 对 http_proxy 只读取小写形式;其他协议变量通常同时支持大小写,小写优先。curl 命令说明列出了变量优先级和 ALL_PROXY、NO_PROXY 的作用。
ALL_PROXY 是没有对应协议变量时使用的通用代理变量;只有在确认工具支持该写法时才设置它。需要使用本地工具提供的另一种地址类型时,可将其写入 ALL_PROXY,但不要同时留下互相冲突的协议变量。NO_PROXY 用于排除本机、内网域名或内部服务,先写具体主机,不要一开始使用 *。
按顺序配置:确认端口、设置当前终端、用 curl 验证
- 确认地址类型。在网络工具设置中找到 HTTP、HTTPS 或其他本地监听端口,记录地址、端口和是否要求认证。不能只根据常见端口数字判断类型。
- 只设置当前终端。先不要修改启动文件或系统环境变量,使用上一节对应命令配置。这样关闭窗口即可恢复,便于判断问题是否来自配置。
- 先测显式地址。将示例中的端口替换为实际结果:
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 proxyPowerShell 可执行:
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-proxynpm 会读取相关环境变量,也支持独立的 proxy 和 https-proxy 配置。pnpm 先查看当前实际配置,避免凭记忆写入未知字段:
pnpm config listYarn 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
. ~/.bashrczsh 的写法:
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_proxyPowerShell 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 变量名=。不要把空字符串当作三种系统通用的删除方式。