全球网络加速服务|低延迟海外网络连接|Oumei.tat 欧米伽

命令行怎么设置代理:跨平台环境变量与工具配置指南

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

简答:命令行设置代理,先确认代理协议、主机和端口,再按当前终端设置环境变量。Windows CMD、PowerShell、macOS/Linux Bash 或 Zsh 的命令不能混用;浏览器能用但终端超时时,先用 curl 验证,再检查 Git、npm、pip、Docker 或 SSH 的独立配置。

定义:命令行代理是通过环境变量、工具配置或单次参数,让终端程序把网络请求交给指定的 HTTP、HTTPS 或 SOCKS5 代理转发。

1. 先确认代理协议、主机和端口

不要直接照抄某个端口。先在代理客户端、企业网络配置或本机监听列表中确认代理主机、端口和协议。下面使用 PROXY_HOST、HTTP_PORT 与 SOCKS_PORT 作为占位符,端口只是示例值,以本机设置页为准。

命令行代理地址格式对照
代理类型地址示例常见用途限制与提醒
HTTP 代理http://PROXY_HOST:HTTP_PORT网页请求、软件包下载、Git HTTPS代理服务器使用 HTTP,不代表目标网址只能是 HTTP。
HTTPS 代理https://PROXY_HOST:HTTP_PORT代理服务明确要求 TLS 连接不能把普通 HTTP 代理端口直接改成 https://。
SOCKS5 代理socks5://PROXY_HOST:SOCKS_PORT支持 SOCKS 的程序或单次测试socks5h://通常表示由代理端解析域名,是否支持取决于工具。
带认证代理http://USER:PASSWORD@PROXY_HOST:HTTP_PORT企业代理或需要账号密码的代理密码中的 @、:、# 等字符可能需要 URL 编码,不要把密码写进公开脚本。

curl 命令手册列出了 HTTP、HTTPS 和 SOCKS 代理的写法;未写协议前缀时,curl 会按 HTTP 代理处理。

2. 按终端类型临时设置代理

macOS 或 Linux:Bash / Zsh

以下命令只影响当前 Bash 或 Zsh 会话,以及由它启动的程序:

export http_proxy="http://PROXY_HOST:HTTP_PORT"
export https_proxy="http://PROXY_HOST:HTTP_PORT"
export all_proxy="socks5h://PROXY_HOST:SOCKS_PORT"
export no_proxy="localhost,127.0.0.1,::1"

export HTTP_PROXY="$http_proxy"
export HTTPS_PROXY="$https_proxy"
export ALL_PROXY="$all_proxy"
export NO_PROXY="$no_proxy"

curl 对 http_proxy 使用小写变量,对其他代理变量通常同时识别大小写版本;其他命令行工具的兼容规则可能不同,因此需要兼容多个工具时可以同时设置两种大小写。参考 curl 教程中的代理环境变量说明。

Windows CMD

CMD 必须使用 set,只影响当前打开的 CMD 窗口:

set HTTP_PROXY=http://PROXY_HOST:HTTP_PORT
set HTTPS_PROXY=http://PROXY_HOST:HTTP_PORT
set ALL_PROXY=socks5h://PROXY_HOST:SOCKS_PORT
set NO_PROXY=localhost,127.0.0.1,::1

curl.exe -I -v https://example.com

查看当前变量:

set HTTP_PROXY
set HTTPS_PROXY
set ALL_PROXY
set NO_PROXY

取消当前 CMD 窗口中的变量:

set HTTP_PROXY=
set HTTPS_PROXY=
set ALL_PROXY=
set NO_PROXY=

Microsoft 文档说明,set 变量名=值用于设置当前 cmd.exe 环境变量,set 变量名=用于清除该变量,详见 Windows set 命令。

Windows PowerShell

PowerShell 不能照搬 CMD 的 set HTTP_PROXY=... 写法,应使用 $env::

$env:HTTP_PROXY = "http://PROXY_HOST:HTTP_PORT"
$env:HTTPS_PROXY = "http://PROXY_HOST:HTTP_PORT"
$env:ALL_PROXY = "socks5h://PROXY_HOST:SOCKS_PORT"
$env:NO_PROXY = "localhost,127.0.0.1,::1"

curl.exe -I -v https://example.com

查看变量:

Get-ChildItem Env:HTTP_PROXY
Get-ChildItem Env:HTTPS_PROXY
Get-ChildItem Env:ALL_PROXY
Get-ChildItem Env:NO_PROXY

取消当前 PowerShell 会话中的变量:

Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:ALL_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:NO_PROXY -ErrorAction SilentlyContinue

PowerShell 环境变量会被当前进程启动的子进程继承;配置文件和持久化范围见 Microsoft PowerShell 环境变量文档。

3. 用 curl 验证代理是否生效

不要用 ping判断 HTTP 或 SOCKS5 代理。ping测试的是 ICMP,不会按 HTTP_PROXY 或 SOCKS5 变量完成网页请求。优先使用 curl:

curl -I -v https://example.com
curl -x http://PROXY_HOST:HTTP_PORT -I -v https://example.com
curl --proxy socks5h://PROXY_HOST:SOCKS_PORT -I -v https://example.com

Windows 建议写成 curl.exe,避免 PowerShell 中命令别名造成判断偏差。curl 的 -x或 --proxy可以指定单次代理,并覆盖通常的环境变量;NO_PROXY可以排除指定主机或域名。详见 curl 命令手册。

  1. 连接端口失败:确认客户端已启动,主机是否应写成 127.0.0.1 或其他监听地址,端口是否为 HTTP 入口而不是 SOCKS 入口。
  2. 端口可连接但请求失败:核对代理协议,不能把只提供 SOCKS5 的端口当作 HTTP 代理使用。
  3. curl 成功、目标工具失败:继续检查目标工具的独立代理配置、认证、证书或传输方式。
  4. 只有内网地址失败:检查 NO_PROXY 是否包含 localhost、127.0.0.1、内网域名和需要直连的地址。

4. 按优先级判断到底是哪一层代理在生效

同一个程序可能同时看到命令行参数、工具配置、环境变量和系统代理。排查时建议按照下面的优先级理解:

命令行代理的常见作用层级
层级示例适用场景排查重点
单次命令参数curl -x http://PROXY_HOST:HTTP_PORT快速测试或只让一条命令走代理通常只影响当前命令,不代表其他工具会使用。
工具独立配置git config、npm config固定让某个工具走代理可能覆盖或绕开通用环境变量。
环境变量HTTP_PROXY、HTTPS_PROXY让多个支持该变量的终端工具继承代理不同工具的变量名称和大小写兼容规则不完全相同。
系统代理操作系统或浏览器代理设置浏览器和部分桌面程序不代表所有命令行程序都会读取系统代理。

因此,浏览器能打开网页而终端超时,并不能证明终端已经使用了相同代理。应先在当前终端查看变量,再用 curl 做独立验证。

5. Git、npm、pip 的单独配置

Git HTTPS

Git 使用 HTTPS 地址访问仓库时,可以配置 HTTP 和 HTTPS 代理:

git config --global http.proxy "http://PROXY_HOST:HTTP_PORT"
git config --global https.proxy "http://PROXY_HOST:HTTP_PORT"
git config --global --get-regexp "(^|\.)proxy$"

git config --global --unset http.proxy
git config --global --unset https.proxy

如果远程地址是 SSH,Git 的 HTTPS 代理设置不一定生效。Git 支持使用 core.sshCommand 或 GIT_SSH_COMMAND指定 SSH 命令,相关配置见 Git 配置文档。

npm

npm config set proxy "http://PROXY_HOST:HTTP_PORT"
npm config set https-proxy "http://PROXY_HOST:HTTP_PORT"
npm config get proxy
npm config get https-proxy

npm config delete proxy
npm config delete https-proxy

npm 文档列出了 proxy、https-proxy 和 noproxy 配置,也说明 npm 会读取相关代理环境变量,详见 npm Config 文档。

pip

pip 可以使用单次命令参数:

python -m pip install --proxy "http://PROXY_HOST:HTTP_PORT" 包名

也可以按终端设置 pip 专用变量。

macOS/Linux:

export PIP_PROXY="http://PROXY_HOST:HTTP_PORT"

Windows CMD:

set PIP_PROXY=http://PROXY_HOST:HTTP_PORT

Windows PowerShell:

$env:PIP_PROXY = "http://PROXY_HOST:HTTP_PORT"

pip 文档明确列出 --proxy 和 PIP_PROXY,其格式为 scheme://[user:passwd@]proxy.server:port,详见 pip 命令文档。

6. Docker、容器和 SSH 不要混在一起配置

Docker 代理作用域

终端已经设置代理,不代表 Docker CLI、Docker Engine、镜像构建和容器运行时都会使用同一代理。Docker 官方文档明确区分了客户端配置、构建参数、容器环境变量和 daemon 配置。

Docker 代理入口对照
对象入口影响范围限制
Docker CLICLI 环境变量或客户端设置命令行相关请求不等同于 Docker Engine 的 daemon 代理。
镜像构建~/.docker/config.json 或 docker build --build-arg构建阶段不要把带密码的代理写进 Dockerfile 的 ENV。
新容器docker run --env 或 Docker 客户端配置容器运行时已有容器不会因修改客户端配置而自动更新。
Docker Enginedaemon 的代理配置引擎自身访问外部资源需要按 Docker Engine 环境配置,不能只改当前终端。

客户端配置示例:

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

Docker 文档说明,~/.docker/config.json中的代理主要用于新容器和构建,不是 Docker CLI 或 Docker Engine 本身的代理设置;代理信息还可能以明文进入容器环境。详见 Docker CLI 代理文档。

SSH 和 Git SSH

SSH 通常不会因为设置 HTTP_PROXY就自动走代理。若本机的 nc支持对应参数,可以尝试:

ssh -o "ProxyCommand=nc -X connect -x PROXY_HOST:HTTP_PORT %h %p" [email protected]

不同系统的 nc参数可能不同,先运行 nc -h确认是否支持 -X和 -x。OpenSSH 的 ProxyCommand用于通过代理命令建立连接,配置说明见 OpenSSH ssh_config 手册。

7. 临时设置、永久保存与完整撤销

macOS/Linux Bash 或 Zsh:写入启动文件

Bash 常见启动文件是 ~/.bashrc,Zsh 常见启动文件是 ~/.zshrc。先确认当前 shell,再写入对应文件:

echo $SHELL
printf '\nexport http_proxy="http://PROXY_HOST:HTTP_PORT"\nexport https_proxy="http://PROXY_HOST:HTTP_PORT"\nexport no_proxy="localhost,127.0.0.1,::1"\n' >> ~/.bashrc
source ~/.bashrc

如果使用 Zsh,应将目标文件改成 ~/.zshrc,不要因为命令能执行就认为它已经对所有终端生效。

Windows CMD:使用 setx 前先确认范围

set只影响当前 CMD 窗口;setx写入用户或系统环境变量,但新值只会被之后打开的命令窗口读取,当前窗口不会自动更新。

setx HTTP_PROXY "http://PROXY_HOST:HTTP_PORT"
setx HTTPS_PROXY "http://PROXY_HOST:HTTP_PORT"

使用 setx时要注意命令历史和日志中的代理地址,不建议直接把带密码的完整 URL写入持久化变量。相关范围说明见 Microsoft setx 文档。

PowerShell:写入 Profile

查看 Profile 路径:

$PROFILE

打开 Profile:

notepad $PROFILE

将需要长期生效的 $env:HTTP_PROXY、$env:HTTPS_PROXY 等语句写入后,重新打开 PowerShell。撤销时需要同时清理当前会话、Profile、系统环境变量和工具独立配置。

完整撤销清单

  • macOS/Linux:执行 unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY all_proxy ALL_PROXY no_proxy NO_PROXY,并删除启动文件中的持久化行。
  • Windows CMD:执行 set HTTP_PROXY=等清除命令;如果使用过 setx,还要删除用户环境变量。
  • PowerShell:执行 Remove-Item Env:HTTP_PROXY等命令,并从 $PROFILE删除对应语句。
  • Git:执行 git config --global --unset http.proxy和 git config --global --unset https.proxy。
  • npm:执行 npm config delete proxy和 npm config delete https-proxy。
  • Docker:检查 ~/.docker/config.json、Docker Desktop 或 Engine 配置、构建参数和容器环境。

常见故障:浏览器能用,命令行却超时

这种情况通常不是“网络一定坏了”,而是浏览器读取了系统代理,而当前终端或目标工具没有读取同一配置。也可能是 CMD、PowerShell、Bash/Zsh 命令混用,端口协议不匹配,或 NO_PROXY把目标地址排除了。

  1. 先在当前终端查看代理变量,确认变量确实存在,没有多余引号、空格或旧端口。
  2. 用 curl -I -v测试,再用 -x明确指定 HTTP 或 SOCKS5 代理进行对照。
  3. 如果 curl 成功,检查 Git、npm、pip、Docker 或 SSH 的独立配置。
  4. 如果只有 Docker 失败,分别检查 CLI、Engine、build 和容器运行时,不要只重复设置终端变量。
  5. 如果只有内网或本机服务失败,检查 NO_PROXY是否包含 localhost、127.0.0.1、host.docker.internal和企业内网域名。

本站推荐与下一步

如果命令行代理已经能访问目标地址,但在 WiFi、流量切换、睡眠唤醒或不同客户端之间仍出现连接差异,可以继续按网络层、系统代理和客户端作用域分开排查。

常见问题

命令行设置代理后,为什么 curl 还是直连?

先确认变量是在当前终端中设置的,再用 curl -I -v 观察连接过程。如果设置了 NO_PROXY,目标地址可能被排除;如果使用 Windows PowerShell,建议明确执行 curl.exe。

HTTP_PROXY 和 HTTPS_PROXY 应该分别填什么?

它们通常按目标网址协议区分,但变量值仍应填写代理服务器实际提供的协议和端口。访问 HTTPS 网址不代表代理地址就必须写成 https://。

CMD 和 PowerShell 的代理命令可以混用吗?

不能直接混用。CMD 使用 set,PowerShell 使用 $env:;CMD 的清除方式是 set 变量名=,PowerShell 则使用 Remove-Item Env:变量名。

SOCKS5 代理能直接用于 npm、pip 和 Git 吗?

不能一概而论。curl 明确支持 socks5 和 socks5h;pip 接受带 scheme 的代理格式;npm 和 Git 的具体支持取决于当前工具实现。遇到失败时,先用 curl 验证 SOCKS 端口,再查看目标工具的代理配置能力。

Docker 为什么设置了终端代理,docker pull 仍然失败?

终端变量不一定控制 Docker Engine 或 Docker Desktop。应分别检查 Docker CLI、daemon、镜像构建和容器运行时的代理作用域;Docker 客户端配置主要影响新容器和构建。

怎样一次性取消命令行代理?

先清除当前终端中的 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY、NO_PROXY 及小写变量,再检查 Git、npm、Shell 启动文件、PowerShell Profile、Windows 用户环境变量和 Docker 配置文件中的持久化设置。

相关阅读

参考资料

  1. curl Tutorial:代理环境变量与 NO_PROXY
  2. curl 命令手册:代理协议、--proxy 与环境变量
  3. Microsoft Learn:Windows set 命令
  4. Microsoft Learn:Windows setx 命令
  5. Microsoft Learn:PowerShell 环境变量
  6. Git 官方文档:git-config
  7. npm 官方文档:Config
  8. pip 官方文档:命令参数与 PIP_PROXY
  9. Docker 官方文档:Docker CLI 代理
  10. OpenSSH ssh_config 手册:ProxyCommand 与 ProxyJump