# 终端走代理教程（2026）：命令行、Git、npm、pip、Docker 代理设置

> 终端走代理教程：开了代理，Git、npm、pip、Docker 仍连不上，是因为命令行工具不读系统代理。本文讲 macOS、Linux、Windows 终端怎么设置代理，Git、npm、pip、Docker 的代理写法，编辑器内置终端的处理，以及终端代理不生效的报错对照。

来源：11号登机口（https://jichanggege.mom/jiaocheng/zhongduan-daili/）｜更新于 2026-11-19｜引用请注明来源与核对日期

终端走代理教程：开了代理，Git、npm、pip、Docker 仍连不上，是因为命令行工具不读系统代理。本文讲 macOS、Linux、Windows 终端怎么设置代理，Git、npm、pip、Docker 的代理写法，编辑器内置终端的处理，以及终端代理不生效的报错对照。

更新于 2026 年 11 月 19 日 · 约 7915 字 · 18 分钟读完 · 11号登机口编辑

快速结论

这篇终端走代理教程先说结论：命令行工具大多不读系统代理，要么用 http_proxy、https_proxy、all_proxy 环境变量把它们指向客户端的本地端口，要么在 Git、npm、pip 里单独配置；端口以客户端显示的混合端口为准，常见如 7890 或 7897。Docker 拉镜像要配在守护进程上，SSH 要用 ProxyCommand。不想逐个设置，就直接打开客户端的 TUN 模式。 终端代理不生效时，先用 curl -x 测本地端口，再用 env | grep -i proxy 看变量有没有在当前窗口生效，最后才查具体工具的配置。

## 终端走代理教程：为什么开了代理，终端还是连不上

代理客户端打开「系统代理」后，做的事情只是把一个本地地址写进操作系统的网络设置。浏览器和大多数图形界面软件会主动读取这项设置，但命令行工具通常不会。git、curl、npm、pip 各有各的网络库，它们只认环境变量或者自己的配置文件。

所以让终端走代理，一共三条路：

| 方式 | 作用范围 | 优点 | 缺点 |
| --- | --- | --- | --- |
| 环境变量 | 当前终端里启动的、愿意读取变量的程序 | 一处设置，多数工具生效，随开随关 | 有的工具不认；SSH、Docker 守护进程不吃这一套 |
| 工具自己的代理配置 | 单个工具 | 精确，不影响别的程序 | 每个工具都要配，容易忘记取消 |
| TUN 模式 | 整台电脑的所有流量 | 一个开关全部解决 | 需要管理员权限，偶尔和其他 VPN 类软件冲突 |

前提是代理客户端已经装好并能正常使用。还没配好的话，先看 [Clash Verge Rev 教程](https://jichanggege.mom/jiaocheng/clash-verge-rev/)或 [v2rayN 教程](https://jichanggege.mom/jiaocheng/v2rayn/)；Linux 服务器上没有图形界面，见 [mihomo 命令行教程](https://jichanggege.mom/jiaocheng/linux-mihomo/)。

## 第一步：确认端口，学会验证

**找端口。**在客户端的设置页找「混合端口」或「端口设置」。混合端口的意思是同一个端口同时接受 HTTP 和 SOCKS5 两种代理请求。端口以客户端显示的混合端口为准，常见如 7890、7897。下文统一写 7890，照抄时换成你自己的数字。有些客户端把 HTTP 和 SOCKS 分成两个端口，那就分别对应填写。

**验证方法。**不要用 ping，它走的是 ICMP，任何代理设置都管不到它，ping 不通不说明代理有问题。用 curl：

curl -I https://www.google.com

返回 HTTP 状态行就是通了。想单独测试代理端口本身、不依赖环境变量，可以显式指定：

curl -I -x http://127.0.0.1:7890 https://www.google.com

第二条通、第一条不通，说明端口没问题，是环境变量没生效。两条都不通，问题在客户端或节点，按[节点超时怎么办](https://jichanggege.mom/paicha/jiedian-chaoshi/)排查。

Windows 的旧版 PowerShell 里，curl 是另一个命令的别名，行为不同，请写成 curl.exe。

## macOS 和 Linux 终端怎么设置代理：环境变量

在终端里执行：

export http_proxy=http://127.0.0.1:7890 export https_proxy=http://127.0.0.1:7890 export all_proxy=socks5://127.0.0.1:7890 export no_proxy=localhost,127.0.0.1,::1

四个变量的含义：

| 变量 | 作用 |
| --- | --- |
| http_proxy | 访问 http:// 地址时使用的代理 |
| https_proxy | 访问 https:// 地址时使用的代理。注意它的值仍然以 http:// 开头，表示用 HTTP 方式连接本地代理 |
| all_proxy | 其他协议的兜底代理，一般填 SOCKS5 地址 |
| no_proxy | 不走代理的地址列表，本机和内网地址写在这里 |

几个细节：

- **大小写。**不同工具认的写法不一样，有的只认小写，有的只认大写。稳妥的做法是两种都设，即再加一组 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY、NO_PROXY。
- **只在当前窗口有效。**关掉终端就没了，新开的窗口也没有。这其实是优点，不会留下后遗症。
- **socks5 和 socks5h。**前者由本机解析域名，后者把域名交给代理去解析。域名解析结果不对时，把 all_proxy 的开头换成 socks5h:// 试试。背后的原理见 [DNS 泄漏](https://jichanggege.mom/zhishi/dns-xielou/)。
- **内网地址。**公司内网的代码仓库、私有镜像源要加进 no_proxy，否则这些请求会被送到境外节点，要么连不上，要么白白消耗流量。

想随时开关，把下面两个函数写进 ~/.zshrc 或 ~/.bashrc，保存后执行 source ~/.zshrc，之后输入 proxy_on、proxy_off 即可：

proxy_on() { export http_proxy=http://127.0.0.1:7890 export https_proxy=http://127.0.0.1:7890 export all_proxy=socks5://127.0.0.1:7890 export HTTP_PROXY=$http_proxy HTTPS_PROXY=$https_proxy ALL_PROXY=$all_proxy export no_proxy=localhost,127.0.0.1,::1 NO_PROXY=localhost,127.0.0.1,::1 } proxy_off() { unset http_proxy https_proxy all_proxy no_proxy unset HTTP_PROXY HTTPS_PROXY ALL_PROXY NO_PROXY }

不建议把 export 直接写进配置文件让它永久生效。客户端一旦没开，所有命令都会报连接被拒绝，而你很可能想不起来是这几行造成的。

另外，sudo 默认不继承当前用户的环境变量。需要时用 sudo -E 带上，或者给对应的工具单独配置。

## 终端代理环境变量是约定，不是标准

结论：http_proxy 这组变量没有一个统一的规范，各工具认哪几个、认大写还是小写、怎么理解 no_proxy，都由各自的网络库决定。所以「设了变量但某个工具不生效」很常见，不一定是你写错了。

几个有代表性的差异（以各工具当前版本的官方文档为准）：

| 工具或运行环境 | 读取环境变量的情况 |
| --- | --- |
| curl | http:// 地址只认小写 http_proxy，不认大写；https_proxy、all_proxy 大小写都认 |
| wget | 读小写变量，也可以在 ~/.wgetrc 里配置 |
| Git（HTTPS 地址） | 读 http_proxy、https_proxy、all_proxy，http.proxy 配置优先 |
| Python 的 requests 等库 | 大小写都读，也读 no_proxy |
| Go 程序 | 读 HTTP_PROXY、HTTPS_PROXY、NO_PROXY，大小写都认；访问本机地址时不走代理 |
| Node.js 自带网络模块 | 传统上不读环境变量，需要程序自己处理，较新版本是否提供相关选项以官方文档为准 |

最后一行是很多人的困惑来源：npm 自己会读代理配置，但你写的 Node.js 脚本里直接用 fetch 访问外网，可能完全不理会环境变量。这种情况要么在代码里显式配置代理，要么开 TUN。

### http、socks5 与 socks5h：域名在哪里解析

结论：三种写法的区别在于「谁来解析域名」和「用什么方式连接本地代理」。日常用 http:// 最省事，遇到解析问题再换 socks5h://。

| 写法 | 连接本地代理的方式 | 域名由谁解析 | 适合 |
| --- | --- | --- | --- |
| http://127.0.0.1:7890 | HTTP 代理（HTTPS 请求用 CONNECT 隧道） | 由代理解析 | 绝大多数工具 |
| socks5://127.0.0.1:7890 | SOCKS5 | 本机先解析，再把 IP 交给代理 | 支持 SOCKS 的工具，且本机 DNS 正常 |
| socks5h://127.0.0.1:7890 | SOCKS5 | 把域名原样交给代理解析 | 本机解析结果被污染或不准确时 |

socks5:// 的问题在于，本机解析出的地址可能已经不对，代理拿到错误的 IP 也无能为力，表现为连接超时或证书错误。socks5h 这个写法并非所有工具都认识，不认识时会直接报错，换回 http:// 即可。

### no_proxy 怎么写：各家解析规则不同

结论：no_proxy 里写域名后缀和具体 IP 最稳妥，网段（CIDR）、通配符和前导点的写法在不同工具里支持程度不一，写了不生效时先换成最朴素的写法。

- **域名后缀**：写 example.com 通常会匹配它本身和子域名；部分工具对 .example.com 这种前导点写法的理解不同，两种都写上最稳妥。
- **IP 和网段**：127.0.0.1、::1 基本都认；192.168.0.0/16 这样的网段写法，有的工具支持，有的只把它当成普通字符串。
- **通配符**：单独写一个 * 在多数工具里表示「全部不走代理」，常被用来临时关闭代理。
- **内网域名**：公司内部的代码仓库、镜像源、*.local 这类域名都要写进来，避免被送去境外节点。

不确定某个工具怎么解析时，用它访问一个应该直连的内网地址，同时看代理客户端的连接列表里有没有出现这个请求，有就说明 no_proxy 没生效。

### 不同 shell 的终端代理写法：zsh、bash 与 fish

结论：export 写法适用于 zsh 和 bash，fish 的语法不同，函数要放进各自的配置文件才会在新窗口里可用。先执行 echo $SHELL 确认自己用的是哪一种。

| shell | 设置变量的写法 | 函数放在哪个文件 |
| --- | --- | --- |
| zsh（macOS 默认） | export http_proxy=http://127.0.0.1:7890 | ~/.zshrc |
| bash（多数 Linux 默认） | 同上 | ~/.bashrc，登录 shell 可能读 ~/.bash_profile |
| fish | set -gx http_proxy http://127.0.0.1:7890，取消用 set -e http_proxy | ~/.config/fish/config.fish 或 functions 目录 |

bash 有一个容易踩的坑：macOS 上的终端默认以登录 shell 启动，读的是 ~/.bash_profile 而不是 ~/.bashrc，函数写错文件就会「新窗口里找不到命令」。常见做法是在 ~/.bash_profile 里加一行加载 ~/.bashrc。改完配置文件后，执行 source 或新开一个窗口才会生效。

## Windows 终端怎么设置代理：PowerShell、CMD 与 WSL

PowerShell 里这样写，同样只对当前窗口有效：

$env:HTTP_PROXY = "http://127.0.0.1:7890" $env:HTTPS_PROXY = "http://127.0.0.1:7890" $env:ALL_PROXY = "socks5://127.0.0.1:7890" $env:NO_PROXY = "localhost,127.0.0.1"

取消：

Remove-Item Env:HTTP_PROXY, Env:HTTPS_PROXY, Env:ALL_PROXY, Env:NO_PROXY

传统的命令提示符（CMD）语法不同：

set http_proxy=http://127.0.0.1:7890 set https_proxy=http://127.0.0.1:7890

想做成开关，可以把设置和取消分别写成两个函数，放进 PowerShell 的配置文件里，文件路径用 $PROFILE 查看。不建议通过系统的「环境变量」对话框永久写入，理由同上。

**WSL 要多留意一点。**WSL 2 默认的网络模式下，子系统里的 127.0.0.1 指的是子系统自己，不是 Windows。代理客户端运行在 Windows 上时有两种做法：在客户端里打开「允许局域网连接」，然后在 WSL 里把代理地址写成 Windows 主机的地址；或者启用 WSL 的镜像网络模式，让两边共用 127.0.0.1。后者对系统版本有要求，具体配置以微软官方文档为准。更省事的是在 Windows 的客户端里打开 TUN，WSL 的流量通常会一并被接管。

## Git 设置代理：HTTPS 和 SSH 是两回事

先看仓库地址是哪一种：https:// 开头的走 HTTPS，git@ 开头的走 SSH。两者的代理设置完全不同。

**HTTPS 方式**会读取环境变量，也可以写进 Git 自己的配置：

git config --global http.proxy http://127.0.0.1:7890

这会让所有仓库都走代理，包括国内的代码托管平台和公司内网仓库。更推荐只对需要的域名设置：

git config --global http.https://github.com.proxy http://127.0.0.1:7890

查看和取消：

git config --global --get-regexp proxy git config --global --unset http.proxy git config --global --unset http.https://github.com.proxy

**SSH 方式**不理会上面任何一项，也不读环境变量，要在 ~/.ssh/config 里用 ProxyCommand 指定。macOS 和多数 Linux 的写法：

Host github.com User git ProxyCommand nc -X 5 -x 127.0.0.1:7890 %h %p

这里的 nc 需要是支持 -X、-x 参数的版本，macOS 自带的可以，Linux 上一般要装 netcat-openbsd。Windows 上使用 Git for Windows 的话，它自带一个 connect 工具，对应写法是：

Host github.com User git ProxyCommand connect -S 127.0.0.1:7890 %h %p

连接其他海外服务器的 SSH 同理，把 Host 换成对应的主机名即可。注意不要写成 Host *，否则连内网机器也会绕道代理。

配完用 ssh -T git@github.com 测试。如果所在网络封锁了 22 端口，GitHub 官方文档还提供了通过 443 端口连接 SSH 的办法，可以去查阅。

## npm 和 pip 设置代理（含 pnpm）

这几个包管理器都能读取环境变量，设置了 proxy_on 的终端里一般可以直接用。想固定下来，再用它们各自的配置。

**npm：**

npm config set proxy http://127.0.0.1:7890 npm config set https-proxy http://127.0.0.1:7890 # 取消 npm config delete proxy npm config delete https-proxy

**pnpm** 使用同名的配置项，命令把 npm 换成 pnpm 即可，细节以 pnpm 官方文档为准。

**pip：**

# 单次使用 pip install --proxy http://127.0.0.1:7890 包名 # 写入配置 pip config set global.proxy http://127.0.0.1:7890 # 取消 pip config unset global.proxy

三个常见的坑：

1. **镜像源和代理别叠加。**如果你已经把 npm 或 pip 的源换成了国内镜像，再让它走代理，就变成绕到境外再回来访问国内服务器，反而更慢。两者选一个：用官方源配代理，或者用国内镜像不配代理。
2. **pip 遇到 SOCKS 报错。**环境里设置了 all_proxy=socks5://... 时，pip 可能提示缺少 SOCKS 支持的依赖。办法是临时 unset all_proxy，只保留 HTTP 的两个变量，或者安装带 SOCKS 支持的依赖。
3. **包管理器里的「proxy」不一定是网络代理。**例如 Go 的 GOPROXY 指的是模块镜像地址，和本文讲的不是一回事，不要把本地端口填进去。

用 Claude Code、Codex 这类命令行 AI 工具时也是同样的道理，它们依赖终端里的环境变量或 TUN，见 [Claude Code 使用说明](https://jichanggege.mom/ai/claude-code/)和 [Codex 使用说明](https://jichanggege.mom/ai/codex/)。AI 工具对出口 IP 比较敏感，节点怎么选见 [AI 网络环境与节点选择](https://jichanggege.mom/ai/wangluo-huanjing/)。

## Docker 代理设置：拉镜像要配守护进程

docker pull 是最容易配错的。你在终端里敲的 docker 只是客户端，真正去下载镜像的是后台的 Docker 守护进程，它不读你终端里的环境变量。Docker 实际上有三处不同的代理设置：

| 场景 | 在哪里配 |
| --- | --- |
| 拉取、推送镜像 | 守护进程 |
| 构建镜像时，构建步骤里的命令要联网 | 构建参数，例如 --build-arg HTTPS_PROXY=... |
| 容器运行时，容器里的程序要联网 | 容器的环境变量，或客户端配置文件里的代理设置 |

**Linux 上的 Docker Engine**，按 Docker 官方文档有两种写法。一种是在守护进程的配置文件 daemon.json（通常位于 /etc/docker/）里加入下面的内容，这种写法需要较新的 Docker 版本：

{ "proxies": { "http-proxy": "http://127.0.0.1:7890", "https-proxy": "http://127.0.0.1:7890", "no-proxy": "localhost,127.0.0.0/8" } }

然后重启：

sudo systemctl restart docker

另一种是 systemd 的附加配置，新建 /etc/systemd/system/docker.service.d/http-proxy.conf：

[Service] Environment="HTTP_PROXY=http://127.0.0.1:7890" Environment="HTTPS_PROXY=http://127.0.0.1:7890" sudo systemctl daemon-reload sudo systemctl restart docker

两处都配了的话，官方文档说明以 daemon.json 为准。

**Docker Desktop**（Windows 和 macOS）不使用 daemon.json 里的代理设置，要在它的设置界面里找到代理相关的选项填写，位置以当前版本界面为准。

**容器内部**有一个关键点：容器里的 127.0.0.1 是容器自己，不是宿主机。要让容器里的程序用宿主机上的代理，地址得写成宿主机的地址（Docker Desktop 提供了 host.docker.internal 这个名字），同时客户端要打开「允许局域网连接」。原理和[局域网共享代理](https://jichanggege.mom/jiaocheng/juyuwang-gongxiang/)相同。

## 其他常用工具的代理写法

除了上面几样，开发和运维时还经常用到下面这些工具。能读环境变量的，在 proxy_on 之后一般直接就能用；需要单独配置的，写法如下，细节以各工具的官方文档为准：

| 工具 | 是否读环境变量 | 单独配置的方法 |
| --- | --- | --- |
| curl | 读 | 单次用 -x http://127.0.0.1:7890；长期写进 ~/.curlrc 的 proxy = ... |
| wget | 读 | 写进 ~/.wgetrc：https_proxy = http://127.0.0.1:7890 和 use_proxy = on |
| Homebrew | 读 | 它下载时调用 curl，设置好环境变量即可 |
| apt（Debian、Ubuntu） | sudo 下默认不继承 | 新建 /etc/apt/apt.conf.d/95proxies，写入 Acquire::http::Proxy "http://127.0.0.1:7890"; 和对应的 https 一行 |
| Go 模块下载 | 读 HTTPS_PROXY | 不要把端口填进 GOPROXY，那是模块镜像地址 |
| Cargo（Rust） | 读 | 在 ~/.cargo/config.toml 的 [http] 段写 proxy = "127.0.0.1:7890" |
| conda | 读 | 在 ~/.condarc 的 proxy_servers 里分别写 http 和 https |
| Yarn | 1.x 读 npm 的配置 | 新版本用 yarn config set httpProxy、httpsProxy |

apt 的配置写进系统目录后会长期生效，代理客户端没开时 apt update 就会失败。临时用的话，更推荐单次执行 sudo -E apt update，让它带上你当前终端里的环境变量。

### dnf、yum 等系统包管理器的代理设置

结论：Fedora、RHEL、Rocky 等发行版的 dnf 和 yum，长期配置写在主配置文件里，临时使用同样可以借助 sudo -E。

dnf 的主配置文件通常是 /etc/dnf/dnf.conf，在 [main] 段加一行：

proxy=http://127.0.0.1:7890

yum 对应 /etc/yum.conf，写法相同。和 apt 一样，这类系统级配置会长期生效，代理客户端没运行时软件源会全部失败，用完记得删除这一行。服务器在境内、软件源也有境内镜像时，直接换镜像源通常比走代理更合适，见下文「另一条路：国内镜像源」。

### Yarn 1.x 和 Yarn 2+ 的代理写法不同

结论：Yarn 的两个大版本配置方式完全不同，先用 yarn --version 看版本，再选写法。

| 版本 | 配置命令 | 配置保存位置 |
| --- | --- | --- |
| Yarn 1.x | yarn config set proxy http://127.0.0.1:7890 和 yarn config set https-proxy http://127.0.0.1:7890 | 用户目录下的 .yarnrc，也会参考 npm 的配置 |
| Yarn 2 及以后 | yarn config set httpProxy http://127.0.0.1:7890 和 yarn config set httpsProxy http://127.0.0.1:7890 | .yarnrc.yml |

新版本不再读取 npm 的代理配置，从 Yarn 1 升级后突然连不上，多半是这个原因。取消时，1.x 用 yarn config delete proxy，新版本用 yarn config unset httpProxy，细节以 Yarn 官方文档为准。

## 另一条路：国内镜像源

结论：如果你要下载的依赖本身有国内镜像，换镜像源往往比走代理更快、也不消耗机场流量。代理和镜像源是两种思路，同一个工具里二选一，不要叠加。

| 工具 | 换源的方式 | 适合换源的情况 |
| --- | --- | --- |
| npm、pnpm | npm config set registry 镜像地址 | 只装公开的 npm 包 |
| pip | pip config set global.index-url 镜像地址 | 只装 PyPI 上的公开包 |
| Go 模块 | 设置 GOPROXY 为模块镜像地址 | 依赖都是公开模块 |
| Docker 镜像 | 在 daemon.json 的 registry-mirrors 里配置 | 主要拉官方仓库的公开镜像 |
| apt、dnf | 修改软件源列表 | 服务器在境内，系统软件包更新 |

镜像地址由国内云厂商、高校等机构提供，具体地址以各镜像站的说明为准。换源的局限也要清楚：镜像有同步延迟，最新发布的版本可能暂时拉不到；私有仓库、GitHub 上的源码、部分二进制下载并不在镜像里，这些仍然需要代理。实际工作中常见的组合是：包管理器用镜像源，Git 和其他境外地址走代理。

## Java、Gradle、Maven 怎么走代理

结论：Java 系的工具基本不读 http_proxy 环境变量，要用 JVM 系统属性或各自的配置文件，这是开发者在终端里最容易漏掉的一类。

| 工具 | 配置方法 |
| --- | --- |
| 直接运行 Java 程序 | 启动参数加 -Dhttps.proxyHost=127.0.0.1 -Dhttps.proxyPort=7890，HTTP 对应 http.proxyHost、http.proxyPort |
| Gradle | 在用户目录的 gradle.properties 里写 systemProp.https.proxyHost=127.0.0.1 和 systemProp.https.proxyPort=7890，http 同理 |
| Maven | 在用户目录 .m2/settings.xml 的 proxies 段添加一个 proxy 条目，填协议、主机和端口 |
| Android Studio 等 IDE | 在 IDE 的 HTTP Proxy 设置里填写，IDE 可能会询问是否同步给 Gradle |

不走代理的地址，JVM 系统属性用 http.nonProxyHosts，多个地址之间用竖线分隔，写法和 no_proxy 不同。Gradle 的代理写进用户目录后会长期生效，代理客户端没开时构建会失败，换网络环境时记得检查这个文件。和其他包管理器一样，Maven 和 Gradle 也可以改用国内镜像仓库，二者选一种即可。

## 终端代理不生效：常见报错对照

报错信息是判断问题出在哪一层的最快线索。下面按常见的报错原文归类，对应的处理思路：

| 报错里的关键词 | 说明了什么 | 处理 |
| --- | --- | --- |
| Connection refused、connect: connection refused 加上 127.0.0.1:7890 | 本地端口上没有程序在监听 | 客户端没开，或端口写错；核对混合端口 |
| Failed to connect ... Timed out、ETIMEDOUT | 请求没走代理，直连被阻断，或节点不通 | 先用 curl -x 测端口；确认变量在当前窗口生效 |
| Could not resolve host | 本机解析不了域名 | 把 all_proxy 改成 socks5h://；或检查 DNS |
| Proxy CONNECT aborted、Received HTTP code 502 from proxy | 已经连到本地代理，但代理到目标这一段失败 | 换节点；看客户端日志里这条连接的报错 |
| SSL certificate problem、certificate verify failed | 证书校验失败 | 校准系统时间；确认没有开 HTTPS 解密类功能；公司网络可能有中间人设备 |
| Missing dependencies for SOCKS support | pip 读到了 SOCKS 代理变量 | 临时 unset all_proxy ALL_PROXY |
| kex_exchange_identification、SSH 连接被关闭 | 22 端口被封锁，或 SSH 没走代理 | 配 ProxyCommand；或按 GitHub 文档改走 443 端口 |
| proxyconnect tcp 加 connection refused | Docker 守护进程连不到你填的代理地址 | 检查守护进程里的代理地址；容器、WSL 里不能直接用 127.0.0.1 |

一个通用的排查顺序：先 curl -I -x http://127.0.0.1:7890 https://www.google.com 确认端口本身可用，再 env | grep -i proxy 看当前窗口里实际生效的变量，最后再看具体工具的配置。三层逐一排除，比反复改配置快得多。

## VS Code、JetBrains 等编辑器里怎么走代理

很多人的命令行其实是编辑器里的内置终端，还有编辑器自己的插件市场、AI 补全插件也要联网。这几样各管各的：

| 要联网的部分 | 读不读系统代理 | 怎么处理 |
| --- | --- | --- |
| 编辑器的内置终端 | 继承编辑器启动时的环境变量 | 在内置终端里执行 proxy_on；或者从已经设置好变量的终端启动编辑器 |
| VS Code 的插件市场和扩展 | 通常会读系统代理 | 不行时在设置里搜索 http.proxy 填写本地地址 |
| JetBrains 系列的插件和更新 | 有自己的代理设置 | 在设置里找 HTTP Proxy 一项，选自动检测或手动填写 |
| 编辑器里的 Git 操作 | 用的是 Git 自己的配置 | 按上文 Git 一节设置 |
| AI 补全、对话类插件 | 各插件实现不同 | 先试系统代理，不行再开 TUN |

菜单位置随编辑器版本略有差异，以当前界面为准。

### VS Code 终端代理不生效怎么办

一个常见的误会是：在系统终端里设好了变量，VS Code 的内置终端却不生效。原因是编辑器早在你设置变量之前就已经启动了，它的终端继承的是启动那一刻的环境。重启编辑器，或者直接在内置终端里再执行一次即可。想让内置终端每次打开都自带代理，可以在 VS Code 设置里用 terminal.integrated.env.osx（Linux 用 .linux，Windows 用 .windows）写入 http_proxy 和 https_proxy 两个变量，端口填客户端里显示的那个，改完新开一个终端标签生效。

编辑器类 AI 工具的网络设置有专门的说明，见 [Cursor 使用教程](https://jichanggege.mom/ai/cursor/)和 [GitHub Copilot 使用教程](https://jichanggege.mom/ai/copilot/)。

## 终端代理怎么永久生效，又不留后遗症

「每次开终端都要重新设置」是最常见的抱怨。想让终端代理长期可用，又不想在客户端关掉时所有命令都报错，可以按这个思路：

1. **写函数，不写死变量**。把上文的 proxy_on、proxy_off 两个函数放进 ~/.zshrc、~/.bashrc 或 PowerShell 的 $PROFILE，需要时手动开。
2. **想自动开启时加一个判断**。在配置文件里先检测本地端口有没有程序在监听，有才执行 proxy_on。这样客户端没开时，终端保持直连，不会出现连接被拒绝。检测的写法因系统而异，可以用 nc -z 127.0.0.1 7890 这类命令判断。
3. **工具级配置只给需要的域名**。Git 按域名设置代理，比全局设置留下的隐患少得多。
4. **定期清点**。执行 env | grep -i proxy、git config --global --get-regexp proxy、npm config get proxy，看看有没有早就忘了的残留设置。

真正需要「所有程序永远走代理」的，与其在每个工具里写配置，不如直接用 TUN。

## 怎么确认流量真的走了代理

能连上不一定是走了代理，有时候只是那个地址本身直连就能访问。想确认，可以用这几种办法：

- **看 curl 的详细输出**。执行 curl -v https://www.google.com -o /dev/null，输出开头如果出现连接到 127.0.0.1 加你的端口，说明请求确实交给了本地代理。
- **看出口地区**。执行 curl -s https://www.cloudflare.com/cdn-cgi/trace，loc= 一行显示的是出口地区代码，和你在客户端里选的节点地区一致才对。
- **看客户端的连接列表**。Clash 系客户端的「连接」页会实时列出请求的域名、命中的规则和使用的节点。执行一次 git clone 或 npm install，在列表里找对应的域名，就知道它走了哪条路。
- **开关前后对比**。先执行 proxy_off 再访问一次上面的 trace 地址，记下 ip= 和 loc=；再执行 proxy_on 访问一次。两次结果不同，说明环境变量确实改变了这个终端的出口；结果一样，说明变量没有生效，或者你开着 TUN，流量本来就被接管了。

用 Claude Code 这类命令行 AI 工具时，出口地区这一项尤其值得确认，地区不受支持时的表现见 [Claude 提示地区不支持](https://jichanggege.mom/paicha/claude-diqu-buzhichi/)。

## 远程服务器借用本机的代理

常见的情况是：你在自己电脑上开着代理客户端，通过 SSH 登录一台访问不了外网的服务器，想让服务器上的 git clone、pip install 也能用上代理。不必在服务器上再装一套客户端，用 SSH 的远程端口转发就行：

ssh -R 7890:127.0.0.1:7890 用户名@服务器地址

登录后，服务器上的 127.0.0.1:7890 就会被转回你本机的代理端口。在这个 SSH 会话里照常设置环境变量：

export http_proxy=http://127.0.0.1:7890 export https_proxy=http://127.0.0.1:7890 curl -I https://www.google.com

几点说明：

- Windows 自带的 OpenSSH 客户端、macOS 和 Linux 的 ssh 命令写法相同，端口换成你客户端的混合端口。
- 转发只在这个 SSH 连接存活期间有效，断开就失效，不会在服务器上留下长期开放的端口。
- 默认情况下，转发出来的端口只监听服务器的本机地址，服务器上的其他用户和外部网络连不到。不要为了方便去修改服务器的 GatewayPorts 设置。
- 服务器上的流量会算进你本机代理的流量里，大体积的镜像和依赖要留意套餐用量。
- 需要长期使用、或者服务器要独立运行时，更合适的做法是在服务器上单独部署，见 [Linux 命令行使用 mihomo](https://jichanggege.mom/jiaocheng/linux-mihomo/)。

## 什么时候直接开 TUN 更省事

TUN 模式在系统里建一块虚拟网卡，从网络层接管所有流量，程序认不认代理都无所谓。出现下面的情况时，开 TUN 比逐个配置划算：

- 用到的工具很多，或者有些工具根本没有代理选项。
- 同时用到 Docker、WSL、虚拟机，每一层都要单独处理。
- 程序走 UDP，HTTP 代理处理不了。
- 只是临时装个依赖，不想改任何配置文件。

更适合用环境变量的情况：

- 只想让某一个终端窗口走代理，其余保持直连。
- 电脑上有公司 VPN 或其他会创建虚拟网卡的软件，容易和 TUN 冲突。
- 没有管理员权限。
- 在远程服务器上操作，TUN 配错会把 SSH 连接切断。

无论哪种方式，流量都按订阅里的规则分流。大体积的依赖和镜像会消耗机场流量，下载前留意节点倍率，见[倍率与流量](https://jichanggege.mom/zhinan/beilv-liuliang/)。TUN 的原理见[规则、全局与 TUN 模式](https://jichanggege.mom/jiaocheng/fenliu-tun/)，打不开见 [TUN 开不了怎么办](https://jichanggege.mom/paicha/tun-kaibuqi/)。

### 开 TUN 让终端走代理前先确认什么

结论：开 TUN 之前确认四件事，可以避免「开了之后整台电脑断网」或「公司内网连不上」。

1. **权限**：TUN 要创建虚拟网卡，Windows 上需要管理员权限或客户端的服务模式，macOS 和 Linux 需要授权或 root。没有权限的设备只能用环境变量。
2. **其他虚拟网卡**：公司 VPN、虚拟机软件、其他加速器也会创建虚拟网卡或改路由，先关掉它们再开 TUN。
3. **内网网段**：公司内网、家里的 NAS、虚拟机网段要保证直连。规则里一般已经包含常见的局域网地址，公司使用特殊网段的，需要在客户端里把它排除，具体选项以软件当前版本界面为准。
4. **DNS 设置**：TUN 模式通常会接管 DNS，内网域名需要公司 DNS 才能解析的，要在客户端的 DNS 设置里为这些域名单独指定。

### 在桌面客户端中启用 TUN 并检查

以 Clash 系客户端为例，一般步骤是：

1. 在设置里找到 TUN 或虚拟网卡相关的开关，首次开启时按提示安装服务或授权。
2. 打开 TUN 后，关掉系统代理，避免两条路同时生效、排查时分不清。
3. 在一个**没有设置任何代理环境变量**的新终端里执行 curl -s https://www.cloudflare.com/cdn-cgi/trace，loc= 显示节点地区，说明 TUN 已经接管了终端流量。
4. 执行一次 git clone 或 ssh -T git@github.com，在客户端的连接列表里能看到对应的连接，说明 Git 和 SSH 也被接管了。
5. 访问一个公司内网地址或局域网设备，确认仍然直连可用。

### 内网异常与安全回滚

开 TUN 后出现内网打不开、SSH 远程断开、DNS 解析异常时，按这个顺序回滚：先在客户端里关闭 TUN；仍然异常，退出客户端；再不行，Windows 上执行 ipconfig /flushdns 清理 DNS 缓存，macOS 和 Linux 检查 /etc/resolv.conf 或系统的 DNS 设置是否被改动后没有恢复。在远程服务器上尝试 TUN 之前，确保你有控制台或其他不依赖 SSH 的登录方式，否则配错路由可能把自己锁在外面。

## 终端代理配置检查清单

结论：配完之后按下表逐项核对一遍，能覆盖绝大多数「为什么这个命令还是不走代理」的问题。

| 检查项 | 命令或方法 | 正常的结果 |
| --- | --- | --- |
| 本地端口可用 | curl -I -x http://127.0.0.1:7890 https://www.google.com | 返回 HTTP 状态行 |
| 当前窗口的变量 | printenv http_proxy HTTPS_PROXY（PowerShell 用 Get-ChildItem Env:*proxy*） | 能看到你设置的地址 |
| 出口地区 | curl -s https://www.cloudflare.com/cdn-cgi/trace | loc= 和节点地区一致 |
| Git 配置 | git config --global --get-regexp proxy | 只有你需要的域名设置 |
| SSH 配置 | 查看 ~/.ssh/config | 只对境外主机写了 ProxyCommand |
| 包管理器 | npm config get proxy、pip config list | 和你的预期一致，没有残留 |
| Docker | docker info 输出里的代理一项 | 显示你填的地址 |
| 内网直连 | 访问一个内网地址并看客户端连接列表 | 列表里没有这条请求 |

不同国家和地区对代理工具的规定不同，请遵守当地法律；在公司设备上操作前，先确认符合公司的网络规定。

## 常见问题

### 终端设置了代理，为什么 ping google.com 还是不通？

ping 使用 ICMP 协议，HTTP 和 SOCKS5 代理都不处理这种流量，所以环境变量对它没有任何作用。验证终端代理是否生效要用 curl -I https://www.google.com，能返回状态行就说明通了。

### Clash 的终端代理端口是多少，7890 还是 7897？

没有固定答案，不同客户端的默认值不同，也可以自己改。以客户端设置页里显示的混合端口为准，7890 和 7897 只是比较常见的两个数字。照抄教程里的端口而不核对，是终端代理不生效最常见的原因。

### git clone 提示连接超时或者 Connection refused 怎么办？

先分清仓库地址是 HTTPS 还是 SSH。HTTPS 地址检查 http.proxy 或环境变量；SSH 地址要在 ~/.ssh/config 里配置 ProxyCommand。提示 Connection refused 多半是端口写错了或者客户端没有运行；提示超时则先用 curl -x 测试代理端口本身通不通。

### 怎么取消 Git 和 npm 的代理设置？

Git 执行 git config --global --unset http.proxy，如果针对域名设置过，也要一并 unset。npm 执行 npm config delete proxy 和 npm config delete https-proxy。环境变量用 unset 清除，或者直接关掉终端窗口。关掉代理客户端后各种命令突然连不上，基本都是某处残留了代理配置。

### docker pull 设置了 http_proxy 还是拉不下来怎么办？

终端里的环境变量对 docker pull 无效，因为下载镜像的是 Docker 守护进程。Linux 上按官方文档把代理写进 daemon.json 或 systemd 的附加配置并重启 Docker；Docker Desktop 在设置界面里配置。配置之后仍然失败，先用 curl -x 确认代理端口本身可用，再用 docker info 查看输出里有没有出现你填的代理地址。

### apt 和 Homebrew 怎么走代理？

Homebrew 下载时调用 curl，设置了 http_proxy、https_proxy 的终端里直接就能用。apt 通常要 sudo 执行，而 sudo 默认不继承环境变量，临时用 sudo -E apt update；需要长期生效，就在 /etc/apt/apt.conf.d/ 下新建一个文件写入 Acquire::http::Proxy，不用时记得删掉。

### 终端代理和 TUN 模式可以同时开吗？

可以，一般不会出错，但没有必要。TUN 已经接管了全部流量，再设环境变量只是让请求多经过一次本地代理端口。排查问题时建议只保留一种，便于判断是哪一层出了问题。

### Node.js 脚本里用 fetch 访问外网，为什么设了环境变量也不走代理？

Node.js 自带的网络模块传统上不读取 http_proxy 这类环境变量，npm 能走代理是因为 npm 自己做了处理。脚本需要代理时，要么在代码里显式配置代理，要么打开客户端的 TUN 模式。较新的 Node.js 版本是否提供读取环境变量的选项，以官方文档为准。

### WSL2 里的终端怎么走 Windows 上的代理？

WSL2 默认网络模式下，子系统里的 127.0.0.1 指向子系统自己。可以在 Windows 客户端里打开「允许局域网连接」，再把 WSL 里的代理地址写成 Windows 主机地址；或者启用 WSL 的镜像网络模式；也可以直接在 Windows 客户端里打开 TUN。三种做法的系统要求以微软官方文档为准。

### 设置了 no_proxy，内网地址还是走了代理怎么办？

先确认写法：域名后缀和具体 IP 最稳妥，网段写法在部分工具里不被支持。再确认变量在当前窗口生效，并且大小写两组都设了。仍然不行，看代理客户端的连接列表里有没有这条内网请求，必要时给这个工具单独写直连配置。

### 终端走代理会额外消耗机场流量吗？

会。走代理的下载都会计入机场套餐，安装大型依赖、拉取容器镜像、克隆大仓库时消耗尤其明显，高倍率节点还会按倍数扣。能用国内镜像源的包管理器优先换源，只让 Git 和境外地址走代理；必须走代理时选低倍率节点，规则见[倍率与流量](https://jichanggege.mom/zhinan/beilv-liuliang/)。不用时执行 proxy_off，避免国内源也被绕到境外。

### 终端代理配置改乱了，怎么一次恢复成直连？

关掉当前终端窗口，新开一个，环境变量就恢复了。再依次清理工具级配置：git config --global --unset http.proxy，npm config delete proxy 和 npm config delete https-proxy，pip config unset global.proxy，以及 apt、dnf、Gradle 等写进文件的代理行。最后检查 ~/.ssh/config 里的 ProxyCommand 是否还需要。

## 接着读

Windows

### Windows 电脑怎么用机场（2026）：客户端选择、导入订阅与系统代理设置

Windows 电脑怎么用机场？对比 Clash Verge Rev、v2rayN、FlClash 和 sing-box，按步骤讲导入订阅、系统代理怎么设置、TUN 怎么取舍和开机自启，再给出 Windows 用机场连不上的报错对照，以及电脑梯子和手机的区别、UWP 应用不走代理的处理。

阅读 → macOS

### Mac 电脑怎么用机场（2026）：客户端选择、导入订阅与系统代理设置

Mac 电脑怎么用机场？先对比 Clash Verge Rev、Stash、sing-box 和 Surge 四款客户端，再讲 M 芯片与 Intel 选哪个安装包、「已损坏无法打开」怎么处理、导入订阅、系统代理与 TUN 设置、Mac 终端走代理，以及 Mac 用机场连不上的报错对照。

阅读 → iPhone / iPad

### iPhone 怎么用机场：2026 客户端选择、订阅导入与设置教程

iPhone 怎么用机场？先解释代理客户端为什么在大陆区商店搜不到，讲清 iPhone 用什么机场客户端、小火箭和 Stash 哪个好，再讲苹果手机翻墙的完整顺序、外区 Apple ID、导入订阅、VPN 授权，以及 iPhone 机场连不上时的报错对照和后台省电。

阅读 →
