终端代理与 TUN 模式全解：git、npm、pip、Docker、WSL 怎么走代理

「浏览器能上 GitHub，终端 git clone 却卡住」——这是开发者最常遇到的问题。原因很简单：系统代理只对会读取它的程序有效。这篇文章一次讲清楚各种开发工具怎么走代理。

下文以代理端口 7897（Clash Verge Rev 默认混合端口）为例，请替换成你客户端中显示的端口。

方案一：TUN 模式（推荐）

TUN 模式会创建一块虚拟网卡，在系统层面接管流量，所有程序自动走代理，包括终端、IDE、Docker、游戏。

• Clash Verge Rev： 设置 → 安装「服务模式」→ 打开「TUN 模式」；
• v2rayN： 以管理员身份运行，底部开启 TUN；
• Hiddify： 选择 VPN 模式。

开了 TUN，下面的方案二基本都不需要了。

方案二：环境变量

# macOS / Linux（写入 ~/.zshrc 或 ~/.bashrc 永久生效）
export https_proxy=http://127.0.0.1:7897
export http_proxy=http://127.0.0.1:7897
export all_proxy=socks5://127.0.0.1:7897
export no_proxy=localhost,127.0.0.1,.cn

# Windows PowerShell（写入 $PROFILE 永久生效）
$env:HTTPS_PROXY = "http://127.0.0.1:7897"
$env:HTTP_PROXY  = "http://127.0.0.1:7897"
$env:NO_PROXY    = "localhost,127.0.0.1"

Codex CLI、Claude Code、curl 等大多数命令行工具会读取这些变量。

各工具单独配置

git（HTTPS 克隆）

git config --global http.proxy http://127.0.0.1:7897
git config --global https.proxy http://127.0.0.1:7897
# 取消：git config --global --unset http.proxy

GitHub SSH： 改用 443 端口通常就能稳定连接，在 ~/.ssh/config 加入：

Host github.com
  HostName ssh.github.com
  Port 443
  User git

npm / pnpm

npm config set proxy http://127.0.0.1:7897
npm config set https-proxy http://127.0.0.1:7897

pip

pip install 包名 --proxy http://127.0.0.1:7897

Docker Desktop： 设置 → Resources → Proxies，填入 http://127.0.0.1:7897。Linux 上的 Docker 守护进程需要在 systemd 服务配置中设置 HTTP_PROXY / HTTPS_PROXY 环境变量。

WSL2 怎么走代理

Windows 11 上最简单的方法是开启 mirrored（镜像）网络模式，让 WSL 和 Windows 共享网络，WSL 里可以直接用 127.0.0.1:7897。在 %UserProfile%\.wslconfig 中加入：

[wsl2]
networkingMode=mirrored

保存后执行 wsl --shutdown 重启 WSL。详见微软官方文档 WSL 网络。

开发者机场推荐

开发场景最怕长连接中断（大仓库 clone、Docker 拉镜像、AI 长任务），优先选专线：

更多选择见 专线机场推荐 与 2026 机场排行榜。