终端怎么走代理？git、npm、Docker 的代理设置

选梯子编辑部 · 更新于 2026-10-08

使用教程进阶玩法难度：进阶约 11 分钟读完

终端代理要单独设置，因为终端里的程序默认不读系统代理。命令行工具通常只认环境变量或自己的配置文件，所以你开了客户端、浏览器能上，但 git clone、npm install、docker pull 依然很慢或直接失败。解决思路有三种：设环境变量、给每个工具配代理、直接开 TUN。下面按这个顺序，把 git、npm 和 Docker 逐个讲清楚，命令里的端口都是占位，以你的客户端显示为准。

终端为什么不走系统代理，有哪几种办法

你在客户端里打开的“系统代理”，只是往操作系统里写了一项设置，浏览器等图形程序会去读，原理见系统代理怎么设置。命令行工具大多不读这项设置，而是自己约定了一套读法：先看环境变量，再看自己的配置文件。

让终端代理生效，有三条路：

没有哪一种是标准答案，下面按这个顺序展开。

环境变量：最通用的命令行代理

多数命令行工具会读下面几个变量，名字大小写在不同工具里有差异，同时设置大小写两种写法最省事：

代理地址的写法是协议加本机地址再加端口。客户端的混合端口同时支持 HTTP 和 SOCKS，端口请填你的客户端显示的数字，下面用“端口号”占位：

macOS 和 Linux 的 bash、zsh 里这样写：

export http_proxy=http://127.0.0.1:端口号
export https_proxy=http://127.0.0.1:端口号
export all_proxy=socks5://127.0.0.1:端口号
export no_proxy=localhost,127.0.0.1

Windows 的 PowerShell 里这样写：

$env:http_proxy = "http://127.0.0.1:端口号"
$env:https_proxy = "http://127.0.0.1:端口号"
$env:no_proxy = "localhost,127.0.0.1"

在 Windows 的命令提示符里，写法是 set https_proxy=http://127.0.0.1:端口号。这些设置只对当前窗口有效，关掉窗口就没了。

不建议把它们永久写进配置文件，否则客户端一关，终端里所有联网命令都会报“连接被拒绝”。更稳妥的做法是写成一对开关，需要时开、用完关：

proxy_on()  { export http_proxy=http://127.0.0.1:端口号 https_proxy=http://127.0.0.1:端口号; }
proxy_off() { unset http_proxy https_proxy all_proxy; }

git 代理怎么设置：HTTPS 和 SSH 两种地址不一样

用 git 克隆仓库，地址有两种形式，代理的设置方式完全不同。这两种形式的区别和认证，可以参考 GitHub 文档。

对 HTTPS 地址，git 代理可以这样设：

git config --global http.proxy http://127.0.0.1:端口号
git config --global http.https://example.com.proxy http://127.0.0.1:端口号
git config --global --unset http.proxy

三条命令依次是：全局生效，所有 HTTP 和 HTTPS 地址都走代理；只让某个域名走代理，其余保持直连，这里的 example.com 要换成你自己需要的域名；取消全局设置。

第二条更值得推荐：只对确实需要代理的域名生效，国内的仓库和公司内部的仓库就不会被误带去绕路。

SSH 地址的转发写法因系统和工具而异，容易出错，最省事的办法往往是把仓库的远程地址改成 HTTPS 形式，再用上面的方式设置。想深入了解时以 SSH 工具和 GitHub 文档为准。

另外，开发者日常用到的 GitHub 访问问题，场景层面的思路可以看GitHub 打开慢用什么梯子。

npm 代理和其他包管理工具

npm 自己有一套代理配置，也认环境变量：

npm config set proxy http://127.0.0.1:端口号
npm config set https-proxy http://127.0.0.1:端口号
npm config delete proxy
npm config delete https-proxy

前两条是设置，后两条是取消。

查看当前值：npm config get proxy 和 npm config get https-proxy。

其他常用工具的做法大同小异，下表只描述思路，具体配置项以各工具文档为准：

要注意：设置 npm 代理后，如果你同时在用国内的镜像源，这些请求也会被带去走代理，可能反而变慢。要么只在需要访问海外源时开，要么用例外名单把国内地址排除。

Docker 的代理：拉镜像和容器内是两件事

Docker 的代理最容易搞混，因为有两个独立的环节：

第一件，守护进程的代理。 Linux 上通常通过服务管理器给守护进程加环境变量，大意是在它的服务配置里写入代理变量，然后重新加载并重启 Docker。Docker Desktop 则在设置里提供代理选项，位置随版本变化。具体步骤以 Docker 官方文档为准。

第二件，容器内的代理。 有两种常见方式：运行时用参数传入代理变量，或者在 Docker 客户端的配置文件里统一设置，示意如下：

{
  "proxies": {
    "default": {
      "httpProxy": "http://主机地址:端口号",
      "httpsProxy": "http://主机地址:端口号",
      "noProxy": "localhost,127.0.0.1"
    }
  }
}

这里最大的坑是地址。容器里的 127.0.0.1 指的是容器自己，不是你的电脑。要让容器访问宿主机上的代理，需要填宿主机对容器可见的地址：Docker Desktop 一般提供一个指向宿主机的主机别名，Linux 上要用宿主机的网络地址，具体写法以 Docker 文档为准。

同时，客户端必须允许来自局域网或容器网络的连接，这意味着代理端口会对外开放，只在需要时开，不要长期暴露，局域网共享的注意事项见局域网共享代理。

什么时候直接开 TUN 更省事

如果你要配的工具太多，或者遇到的程序连环境变量都不认，直接开 TUN 模式 往往更省事：它在网络层接管整台电脑的流量，宿主机上发出的命令行流量一般都会被接住。

按你的情况选：

• 只用 git 和 npm、偶尔用： 环境变量加开关函数就够了。
• 长期用某几个工具： 给它们各配一次，做成持久的设置，最好限定到具体域名。
• 工具多、不想逐个配： 开 TUN，但要接受权限和冲突的代价。
• Docker 要拉镜像： 不论用哪种办法，都要验证守护进程那一环，别只验证终端。

TUN 对容器内部流量是否也生效，要看容器的网络模式，以你的实际验证为准。

怎么确认终端代理已经生效

设置完不要靠感觉，按工具逐项验证：

1. 环境变量。 在终端运行 echo $https_proxy（PowerShell 里是 $env:https_proxy），看到你设的地址才算设上。
2. curl 的详细输出。 运行 curl -v 访问任意网址时，输出里会有一行说明是否使用了环境变量里的代理，可以直接看到它读到了什么。
3. 客户端的连接页面。 这是最可靠的一步。执行一条联网命令，看客户端的连接记录里有没有出现这条连接、命中了什么规则。没有记录，说明请求根本没到客户端。
4. git。 运行 git config --global --get http.proxy 查看配置。想看细节可以在命令前加上 GIT_CURL_VERBOSE=1。
5. npm。 运行 npm config get proxy 查看配置，再用 npm ping 测试能否连通仓库。
6. Docker。 运行 docker info，输出里会显示守护进程当前使用的 HTTP 和 HTTPS 代理。容器内部可以进入容器后查看环境变量。

出问题时，对照这张表：

下一步：先设环境变量，再按需持久化

1. 先用开关函数在一个终端窗口里试通，并在客户端连接页面确认有记录。
2. 常用的 git、npm 再各配一次持久设置，尽量限定到需要的域名。
3. 用 Docker 的话，分清守护进程和容器内两件事，分别验证。
4. 觉得逐个配置太繁琐，考虑 TUN 模式；想知道哪些软件管不到，看某个 App 不走代理怎么办。
5. 还没有稳定的订阅，先到梯子推荐按开发用途筛选候选，再核对退款和设备数规则。

接着读

• 使用场景 · GitHub 打开慢用什么梯子？开发者的代理配置思路
• 使用场景 · AI 编程工具用什么梯子？Copilot 与 Cursor
• 使用教程 · TUN 模式是什么？什么时候该开、怎么开
• 使用教程 · 系统代理怎么设置？和 TUN 模式的区别与适用场景
• 故障排查 · 某个 App 不走代理怎么办？系统代理管不到的流量
• 使用教程 · 局域网共享代理：让电视、游戏机用上电脑的梯子

文中出现的术语

• TUN 模式
• Shadowsocks
• 系统代理
• 延迟
• 直连