命令行怎么设置代理:跨平台环境变量与工具配置指南
简答:命令行设置代理,先确认代理协议、主机和端口,再按当前终端设置环境变量。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 SilentlyContinuePowerShell 环境变量会被当前进程启动的子进程继承;配置文件和持久化范围见 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.comWindows 建议写成 curl.exe,避免 PowerShell 中命令别名造成判断偏差。curl 的 -x或 --proxy可以指定单次代理,并覆盖通常的环境变量;NO_PROXY可以排除指定主机或域名。详见 curl 命令手册。
- 连接端口失败:确认客户端已启动,主机是否应写成
127.0.0.1或其他监听地址,端口是否为 HTTP 入口而不是 SOCKS 入口。 - 端口可连接但请求失败:核对代理协议,不能把只提供 SOCKS5 的端口当作 HTTP 代理使用。
- curl 成功、目标工具失败:继续检查目标工具的独立代理配置、认证、证书或传输方式。
- 只有内网地址失败:检查
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-proxynpm 文档列出了 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_PORTWindows 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 CLI | CLI 环境变量或客户端设置 | 命令行相关请求 | 不等同于 Docker Engine 的 daemon 代理。 |
| 镜像构建 | ~/.docker/config.json 或 docker build --build-arg | 构建阶段 | 不要把带密码的代理写进 Dockerfile 的 ENV。 |
| 新容器 | docker run --env 或 Docker 客户端配置 | 容器运行时 | 已有容器不会因修改客户端配置而自动更新。 |
| Docker Engine | daemon 的代理配置 | 引擎自身访问外部资源 | 需要按 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把目标地址排除了。
- 先在当前终端查看代理变量,确认变量确实存在,没有多余引号、空格或旧端口。
- 用
curl -I -v测试,再用-x明确指定 HTTP 或 SOCKS5 代理进行对照。 - 如果 curl 成功,检查 Git、npm、pip、Docker 或 SSH 的独立配置。
- 如果只有 Docker 失败,分别检查 CLI、Engine、build 和容器运行时,不要只重复设置终端变量。
- 如果只有内网或本机服务失败,检查
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 配置文件中的持久化设置。