攻略 / 客户端进阶

开发者工具链代理配置大全：git、npm/pnpm/yarn、pip/uv、Docker、Homebrew、WSL、Go、Hugging Face 与 Ollama（2026）

📅 2026-10-26 ⏱ 约 37 分钟

开了代理客户端、浏览器能打开 GitHub，终端里的 git clone、npm install、pip install、docker pull 却照样超时，这是开发者最常遇到的网络问题。原因几乎都一样：命令行工具大多不读系统代理。Clash 类客户端的「系统代理」开关只是把端口写进系统设置，浏览器会去读它，但 git、npm、pip 这些程序只认环境变量或自己的配置文件；Docker、Ollama 这类有后台服务的工具，真正联网的还是另一个进程，它看不到你在终端里设的变量。

这篇按工具逐个讲：它认什么、怎么设、怎么取消、怎么验证，以及最容易踩的坑。每个工具也会说到国内镜像这条路，两种做法各有适用场景。内容以截至 2026 年 10 月的官方文档为准。

本文以科技熊推荐的电脑客户端 Clash Verge Rev（科技熊版，Windows 教程、macOS 教程、Linux 教程）为例。下文代理地址统一写 http://127.0.0.1:7897：7897 是科技熊版的默认混合代理端口，在客户端首页最下方的「Clash 信息」卡片里能看到「混合代理端口」，显示的不是 7897 就换成它。

最省事的做法：切到「整机」。 Clash Verge Rev（科技熊版）首页「科技熊工作室」卡片上有「浏览器 / 整机」切换。「浏览器」只把代理写进系统设置，读不读由程序自己决定；切到「整机」（模式保持「规则」）会用虚拟网卡在系统层面接管所有程序的海外流量，git、npm、pip、Homebrew 这些命令行工具不用再逐个设代理。第一次切换需要按提示安装系统服务、输入一次管理员密码。Linux 版卡片上没有这个切换，Linux 用户按下文设环境变量。Docker、Ollama 这类有后台服务的工具在虚拟机或服务进程里联网，整机模式不一定覆盖得到，仍按下文对应小节设置。

一、总表：每个工具认哪种配置

工具	认什么	一行设置（macOS / Linux 示例）
通用（curl 等大多数 CLI）	`HTTPS_PROXY`、`HTTP_PROXY`、`ALL_PROXY`、`NO_PROXY`	`export HTTPS_PROXY=http://127.0.0.1:7897`
git（HTTPS 地址）	环境变量，或 `http.proxy` 配置	`git config --global http.proxy http://127.0.0.1:7897`
git（SSH 地址）	不认上面任何一个，要改 `~/.ssh/config`	改走 `ssh.github.com:443`，或加 `ProxyCommand`
npm	环境变量，或 `proxy` / `https-proxy` 配置	`npm config set https-proxy http://127.0.0.1:7897`
pnpm	环境变量，或 `httpsProxy` 配置	设环境变量即可
yarn	1.x 用 `https-proxy`；2.x 及以上用 `.yarnrc.yml` 的 `httpsProxy`	`yarn config set httpsProxy http://127.0.0.1:7897`
pip	环境变量、`--proxy`、`pip config`	`pip config set global.proxy http://127.0.0.1:7897`
uv	环境变量	设环境变量即可
Docker Desktop	设置界面里的 Proxies，默认跟随系统代理	Settings → Resources → Proxies
Docker Engine（Linux）	`/etc/docker/daemon.json` 或 systemd 环境变量	见第六节
Homebrew	`all_proxy`、`https_proxy` 等环境变量	`export ALL_PROXY=http://127.0.0.1:7897`
WSL2	自己的环境变量；`.wslconfig` 可开 `autoProxy`	见第八节
Go	`GOPROXY` 是模块镜像，联网代理仍是环境变量	`go env -w GOPROXY=https://goproxy.cn,direct`
Hugging Face	环境变量；`HF_ENDPOINT` 切镜像	`export HF_ENDPOINT=https://hf-mirror.com`
Ollama	服务进程的 `HTTPS_PROXY`	见第十一节

二、通用做法：环境变量

大多数工具都认这四个变量，先把它们设好，后面很多工具就不用单独配了：

变量	作用
`HTTPS_PROXY`	HTTPS 请求走的代理，开发工具的流量几乎都是 HTTPS
`HTTP_PROXY`	明文 HTTP 请求走的代理
`ALL_PROXY`	兜底，部分工具（curl、Homebrew）会读
`NO_PROXY`	不走代理的地址，如 `localhost,127.0.0.1,::1`

macOS / Linux，写进 ~/.zshrc（macOS 默认）或 ~/.bashrc，再 source 一下或重开终端：

export HTTP_PROXY="http://127.0.0.1:7897"
export HTTPS_PROXY="http://127.0.0.1:7897"
export ALL_PROXY="http://127.0.0.1:7897"
export NO_PROXY="localhost,127.0.0.1,::1"

部分工具只认小写（https_proxy），想稳妥可以大小写各写一份。

Windows，用户级环境变量（只对之后新开的终端和程序生效）：

setx HTTP_PROXY  "http://127.0.0.1:7897"
setx HTTPS_PROXY "http://127.0.0.1:7897"
setx NO_PROXY    "localhost,127.0.0.1,::1"

只在当前 PowerShell 窗口临时生效：$env:HTTPS_PROXY = "http://127.0.0.1:7897"。

取消： macOS / Linux 删掉配置文件里的那几行，当前终端执行 unset HTTP_PROXY HTTPS_PROXY ALL_PROXY；Windows 执行 [Environment]::SetEnvironmentVariable("HTTPS_PROXY", $null, "User")（其它变量同理），再重开终端。

验证： 先确认端口本身是通的，再确认环境变量生效：

# Windows PowerShell 里写 curl.exe，避免被 curl 别名接管
curl -x http://127.0.0.1:7897 -I https://github.com
curl -I https://github.com    # 不带 -x，走环境变量

第一条通、第二条不通，说明环境变量没设上或没生效；两条都不通，先检查代理客户端。

两条通用建议：

优先写 http://，不写 socks5://。 Clash 类客户端的混合端口同时支持 HTTP 和 SOCKS，写 http:// 兼容性最好；下文会看到，pip、npm 等工具对 SOCKS 的支持要么需要额外依赖，要么没有。
同一个工具的代理只写在一个地方。 环境变量、工具自己的配置文件、项目目录里的配置文件都写了的话，换端口时很容易只改了一处，排查起来非常绕。

三、git

HTTPS 地址（`https://github.com/...`）

git 通过 libcurl 联网，默认就读 http_proxy、https_proxy、all_proxy 环境变量，第二节设好之后通常已经能用。也可以写进 git 自己的配置，只对 git 生效：

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

只想让 GitHub 走代理、公司内网仓库直连，用按地址匹配的写法：

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

git 支持 curl 的全部代理写法，确实要用 SOCKS 时写 socks5h://127.0.0.1:7897（带 h 表示域名交给代理解析，避免本地 DNS 被污染）。

取消： git config --global --unset http.proxy（按地址匹配的那条用 --unset http.https://github.com.proxy）。

验证： git config --global --get-regexp proxy 看当前配置；git ls-remote https://github.com/git/git HEAD 能很快返回一行哈希就说明通了。

SSH 地址（`[email protected]:...`）

这是最常见的坑：http.proxy 和所有代理环境变量都管不到 SSH。用 [email protected]: 形式的地址时，git 调用的是 ssh，直连 github.com 的 22 端口；而很多网络环境下 22 端口本身就不稳定，表现为 Connection timed out 或 kex_exchange_identification: Connection closed by remote host。

有两种改法，都写在 ~/.ssh/config（Windows 是 %USERPROFILE%\.ssh\config），没有就新建。

改法一：改走 443 端口。 这是 GitHub 官方文档给的办法，把 SSH 连到 ssh.github.com 的 443 端口：

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

先用 ssh -T -p 443 [email protected] 测试，看到 Hi 用户名! You've successfully authenticated 即可。这一招解决的是 22 端口被限制的问题，流量本身还是直连。

改法二：让 SSH 经过代理。 用 ProxyCommand 把 SSH 连接交给本机代理的 SOCKS 入口（混合端口同样支持）：

# macOS（系统自带的 nc 支持 -X / -x）
Host github.com
    Hostname ssh.github.com
    Port 443
    User git
    ProxyCommand nc -X 5 -x 127.0.0.1:7897 %h %p

# Windows（Git for Windows 自带 connect.exe）
Host github.com
    Hostname ssh.github.com
    Port 443
    User git
    ProxyCommand connect -S 127.0.0.1:7897 %h %p

Linux 上 nc -X 需要 OpenBSD 版 netcat（Debian / Ubuntu 的包名是 netcat-openbsd），也可以用 nmap 附带的 ncat --proxy 127.0.0.1:7897 --proxy-type socks5 %h %p。

取消： 删掉 ~/.ssh/config 里对应的 Host github.com 整段。

验证： ssh -T [email protected]，加 -v 能看到实际连的是哪个地址和端口。

镜像这条路

git 没有通用的「国内镜像」，GitHub 仓库只能经代理或改 443 端口访问。少数热门仓库在 Gitee 等平台有同步副本，但更新时间和完整性因仓库而异，适合临时取一次代码，不适合日常推拉。

四、npm、pnpm、yarn

npm

npm 读 HTTPS_PROXY、HTTP_PROXY 环境变量（大小写都认），也可以写进自己的配置 ~/.npmrc：

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

npm 官方文档只列了 HTTP / HTTPS 代理，不要写 socks5://。

取消： npm config delete proxy 和 npm config delete https-proxy。

验证： npm config get https-proxy 看配置；npm ping 能返回 PONG 说明能连上 registry。

pnpm

pnpm 同样读 HTTPS_PROXY、HTTP_PROXY 环境变量，设好第二节就能用。要注意的是 pnpm 新版本的配置位置变了：除登录凭据和 registry 之外，其它设置（包括 httpsProxy、httpProxy、noProxy）不再从 .npmrc 读取，而是在项目的 pnpm-workspace.yaml 或全局 config.yaml 里。以前写在 .npmrc 里的代理设置升级后可能不生效，用环境变量最省心。全局配置文件位置可以用 pnpm config get globalconfig 查。

yarn

yarn 1.x（classic）沿用 npm 风格的配置：

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

yarn 2.x 及以上（Berry）改用 .yarnrc.yml，键名是驼峰：

httpProxy: "http://127.0.0.1:7897"
httpsProxy: "http://127.0.0.1:7897"

也可以执行 yarn config set httpsProxy http://127.0.0.1:7897。用 yarn --version 先确认自己是哪一代，两代的写法互不通用。取消时 1.x 用 yarn config delete https-proxy，2.x 以上删掉 .yarnrc.yml 里对应的行。

镜像这条路

国内常用 npmmirror（原淘宝镜像）：

npm config set registry https://registry.npmmirror.com
pnpm config set registry https://registry.npmmirror.com

恢复官方源：npm config set registry https://registry.npmjs.org/。yarn 2.x 以上对应的键是 npmRegistryServer。

怎么选： 镜像下载快、不消耗代理流量，适合装依赖这种大量小文件的场景；代价是同步有延迟（刚发布的版本可能要等一会儿），以及 npm publish、npm login 必须回到官方源。还要注意 package-lock.json 里会记录下载地址，团队协作时混用镜像和官方源可能产生无意义的 diff。不想管这些细节的，直接走代理更统一。

五、pip 与 uv

pip

pip 认三种方式：环境变量（https_proxy 等）、命令行 --proxy、配置文件：

pip install requests --proxy http://127.0.0.1:7897     # 只对这一次生效
pip config set global.proxy http://127.0.0.1:7897      # 写进 pip 配置，长期生效

SOCKS 的坑： pip 默认不带 SOCKS 支持。代理写成 socks5://，或者环境里有 ALL_PROXY=socks5://...（不少教程会让你这么设），pip 会报 Missing dependencies for SOCKS support。解决办法是把代理改成 http://，或者先在不经 SOCKS 的情况下装上 PySocks（pip install pysocks）。最简单的是统一用 http://。

取消： pip config unset global.proxy。

验证： pip config list 看配置；pip download requests --no-deps -d ./pip-test 能下载下来即说明通了（测完删掉 pip-test 目录）。

uv

uv 读 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY、NO_PROXY 环境变量，设好第二节即可，没有单独的代理配置项。要留意的是 uv 除了下载包，还会从 GitHub 下载 Python 解释器本身（uv python install），这一步也要能走到代理。

验证： uvx pycowsay hello 能下载并运行即可。

镜像这条路

清华 TUNA、阿里云等都提供 PyPI 镜像：

# pip
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
# 恢复官方源
pip config unset global.index-url

# uv：环境变量或 uv.toml 里的 [[index]]
export UV_DEFAULT_INDEX=https://pypi.tuna.tsinghua.edu.cn/simple

阿里云的地址是 https://mirrors.aliyun.com/pypi/simple/。Python 解释器的下载来源可以用 UV_PYTHON_INSTALL_MIRROR 改成别的地址，但要确认镜像确实同步了对应版本。

怎么选： 和 npm 一样，镜像适合大量装包、对版本新鲜度要求不高的场景；twine upload 发布、需要刚发布的版本、或者项目锁文件里写死了官方源地址时，走代理更省事。

六、Docker

Docker 是最容易配错的工具，因为「Docker 联网」其实分成三件互不相干的事：

场景	谁在联网	在哪里设代理
`docker pull` 拉镜像	Docker 守护进程（dockerd）	Docker Desktop 设置；Linux 上是 `daemon.json` 或 systemd
容器运行时访问外网	容器里的程序	`~/.docker/config.json` 的 `proxies`，或 `docker run -e`
`docker build` 里的 `RUN apt-get` / `RUN pip install`	构建容器	`--build-arg`，或同上 `~/.docker/config.json`

在终端里 export HTTPS_PROXY 对这三件事都没有作用，因为联网的不是 docker 这个命令本身。

拉镜像：Docker Desktop（Windows / macOS）

在 Docker Desktop 的 Settings → Resources → Proxies 里设置。默认选项是使用系统代理，所以代理客户端开着「系统代理」时，拉镜像通常已经会走代理；不行的话改成手动配置，「Web Server (HTTP)」和「Secure Web Server (HTTPS)」都填 http://127.0.0.1:7897，点 Apply & restart。官方文档特别说明：Docker Desktop 会忽略 daemon.json 里的代理设置，只认这个界面。

拉镜像：Linux 上的 Docker Engine

推荐写进 /etc/docker/daemon.json（没有就新建，已有内容的合并进去）：

{
  "proxies": {
    "http-proxy": "http://127.0.0.1:7897",
    "https-proxy": "http://127.0.0.1:7897",
    "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:7897"
Environment="HTTPS_PROXY=http://127.0.0.1:7897"
Environment="NO_PROXY=localhost,127.0.0.1"

再 sudo systemctl daemon-reload && sudo systemctl restart docker。两处都写了时，daemon.json 优先。

验证： docker info 的输出里有 HTTP Proxy / HTTPS Proxy 两行；docker pull hello-world 能拉下来即可。取消： 删掉对应的配置并重启 Docker。

容器内与构建时

~/.docker/config.json 里加上：

{
  "proxies": {
    "default": {
      "httpProxy": "http://host.docker.internal:7897",
      "httpsProxy": "http://host.docker.internal:7897",
      "noProxy": "localhost,127.0.0.0/8"
    }
  }
}

保存后对新建的容器和构建生效，不用重启 Docker：容器会自动带上代理环境变量，docker build 会自动填入同名的构建参数。这些值只存在于构建过程中，不会写进最终镜像。

只想对某一次构建生效，就手动传参（HTTP_PROXY 等是 Dockerfile 预定义的构建参数，不需要在 Dockerfile 里声明）：

docker build --build-arg HTTPS_PROXY=http://host.docker.internal:7897 -t myapp .

最大的坑是 127.0.0.1。 在容器里，127.0.0.1 指的是容器自己，不是你的电脑，写成 127.0.0.1:7897 一定连不上。Docker Desktop 上用 host.docker.internal 指向宿主机；Linux 上可以用 docker build --network host / docker run --network host 让容器共用宿主机网络，这时 127.0.0.1 才是宿主机。另外，代理客户端只监听本机回环地址时，容器从网桥过来的连接会被拒绝，需要在客户端里打开「允许局域网连接」。

镜像这条路

Docker Hub 的国内加速器在 2024 年 6 月前后陆续停止服务，之后公开可用的加速地址变动频繁，这里不推荐具体地址。云厂商（阿里云、腾讯云等）的容器镜像服务一般只对自家云服务器内网或已登录账号提供加速，适合服务器部署场景；个人开发机上，给 Docker 配代理是更稳定的做法。

七、Homebrew

Homebrew 通过 curl 和 git 下载，按官方手册读 all_proxy、http_proxy、https_proxy、no_proxy 这几个环境变量。设好第二节的变量后，brew 一般已经能用；手册里 all_proxy 的描述是 SOCKS5 代理，所以也可以写 export ALL_PROXY=socks5://127.0.0.1:7897，用 http:// 同样可行。

只想对某一条命令临时生效：

ALL_PROXY=http://127.0.0.1:7897 brew install wget

安装 Homebrew 本身的那条 curl ... install.sh 脚本也需要能连上 GitHub，记得先在同一个终端里设好变量。

验证： brew update 能正常完成；加 --verbose 可以看到每一步在连哪里。

镜像这条路

清华 TUNA 提供完整的 Homebrew 镜像，写进 ~/.zprofile：

export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"

恢复官方源要多做一步：删掉上面几行后，还要把已经改过的仓库地址改回去，否则 brew update 仍然连镜像：

unset HOMEBREW_API_DOMAIN HOMEBREW_BOTTLE_DOMAIN HOMEBREW_BREW_GIT_REMOTE HOMEBREW_CORE_GIT_REMOTE
git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew
brew update

怎么选： 镜像覆盖 formula 和预编译包，但 cask（图形界面 App）大多直接从软件官网或 GitHub 下载，镜像管不到，这部分仍然需要代理。

八、WSL2

WSL2 是一台独立的 Linux 虚拟机，Windows 上设的环境变量和系统代理它都看不到；Linux 里的工具读的是 WSL 自己 ~/.bashrc 里的变量。问题在于默认的 NAT 网络模式下，WSL 里的 127.0.0.1 是 WSL 自己，连不到 Windows 上的代理客户端。

办法一（推荐）：mirrored 网络模式。 Windows 11 22H2 及以上，在 %USERPROFILE%\.wslconfig 里写：

[wsl2]
networkingMode=mirrored
autoProxy=true

然后在 PowerShell 里执行 wsl --shutdown，再重新打开 WSL。mirrored 模式下 WSL 可以用 127.0.0.1 直接访问 Windows 上的程序，WSL 里照第二节写 http://127.0.0.1:7897 即可。autoProxy=true 会让 WSL 自动沿用 Windows 当前的 HTTP 代理设置（前提是 Windows 里已经开了系统代理），不想依赖它的话，在 WSL 的 ~/.bashrc 里手动 export 更可控。

办法二：NAT 模式下用宿主机 IP。 在 WSL 里取 Windows 主机地址：

ip route show | grep -i default | awk '{ print $3}'

把代理写成 http://这个地址:7897，同时在代理客户端里打开「允许局域网连接」，并确认 Windows 防火墙放行了这个端口。这个地址可能在重启后变化，所以通常写成脚本动态获取。

验证： 在 WSL 里 curl -I https://github.com。

另外，Windows 和 WSL 里的工具配置是两份：WSL 里的 git、npm、pip 读的是 WSL 里的 ~/.gitconfig、~/.npmrc、~/.config/pip/pip.conf，不是 Windows 那份。

九、Go

很多人把 GOPROXY 当成网络代理，其实它是模块代理，也就是 Go 模块的下载镜像，和 HTTPS_PROXY 是两回事：

GOPROXY 决定「从哪个服务器下载模块」，默认是 https://proxy.golang.org,direct；
HTTPS_PROXY 决定「下载时经不经过网络代理」。

两者可以只用一个，也可以同时用。

做法一：换成国内模块镜像。 goproxy.cn 的官方用法：

go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct

go env -w 写进 Go 自己的配置文件，Windows、macOS、Linux 通用，不用改环境变量。末尾的 direct 表示镜像里找不到时直接去源仓库拉。公司私有仓库要加 go env -w GOPRIVATE=git.example.com，让这些模块绕过镜像和校验和数据库。恢复默认：go env -u GOPROXY。

做法二：保留官方 proxy.golang.org，走网络代理。 设好第二节的 HTTPS_PROXY 即可，go 命令下载时会读它。

验证： go env GOPROXY 看当前值；go list -m golang.org/x/text@latest 能返回版本号即说明通了。

怎么选： 只是拉公开依赖，goproxy.cn 速度快、配置一次长期有效；direct 回退或私有模块需要访问 GitHub 时，仍然要配好网络代理。

十、Hugging Face

huggingface_hub（包括 hf 命令行和 transformers、diffusers 等依赖它的库）读标准代理环境变量，写成 http:// 即可。注意它的环境变量在 import 时读取，在 Python 脚本或 Jupyter 里改 os.environ 要放在 import 之前，已经运行的内核要重启。

镜像： 用 HF_ENDPOINT 把下载地址换成镜像站，常用的是 hf-mirror.com：

# macOS / Linux
export HF_ENDPOINT=https://hf-mirror.com
hf download openai-community/gpt2 config.json

# Windows PowerShell
$env:HF_ENDPOINT = "https://hf-mirror.com"

只对一次运行生效：HF_ENDPOINT=https://hf-mirror.com python your_script.py。取消就是删掉这个变量。

怎么选： 镜像适合下载公开模型和数据集；需要登录的受限模型（gated）、上传、发布，以及 Spaces、推理接口等，仍要连官方 huggingface.co，走代理。模型文件动辄几十 GB，走代理时要考虑流量消耗。

十一、Ollama

Ollama 分成两部分：你敲的 ollama 命令只是客户端，真正去下载模型的是后台的 Ollama 服务进程。所以在终端里 export HTTPS_PROXY 再 ollama pull 没有用，代理要设给服务进程。官方文档的两条要点：

设 HTTPS_PROXY，模型下载只走 HTTPS；
不要设 HTTP_PROXY，它可能打断客户端和本机服务之间的连接。

按运行方式分别设置：

Linux（systemd 服务）：

sudo systemctl edit ollama.service

在打开的编辑器里加：

[Service]
Environment="HTTPS_PROXY=http://127.0.0.1:7897"

保存后 sudo systemctl daemon-reload && sudo systemctl restart ollama。取消就再次 systemctl edit 删掉这一行并重启。

macOS（App 版）：

launchctl setenv HTTPS_PROXY "http://127.0.0.1:7897"

然后从菜单栏退出 Ollama 再重新打开。launchctl setenv 重启电脑后失效，取消用 launchctl unsetenv HTTPS_PROXY。

Windows： Ollama 继承用户环境变量。先从任务栏托盘退出 Ollama，在「设置」里搜索「环境变量」添加用户变量 HTTPS_PROXY（或用第二节的 setx），再从开始菜单重新打开 Ollama。

Docker 里跑的 Ollama： 启动容器时加 -e HTTPS_PROXY=http://host.docker.internal:7897，同样不能写 127.0.0.1。

验证： ollama pull llama3.2:1b 能正常显示下载进度。

十二、排查顺序

不管哪个工具，排查都可以按同一个顺序，一层只回答一个问题：

代理客户端开着吗，端口是多少？ 看客户端「设置」。
这个端口能出去吗？ curl -x http://127.0.0.1:端口 -I https://github.com。
工具读到的是这个端口吗？ 用各节的验证命令看工具自己的配置：git config --get-regexp proxy、npm config get https-proxy、pip config list、docker info、go env GOPROXY。
联网的是不是另一个进程？ Docker 守护进程、Ollama 服务、WSL 虚拟机、容器内部，这些都要单独设，而且不能写 127.0.0.1（WSL mirrored 模式除外）。

第 2 步通、第 3 步不对，问题在配置来源上，换节点没用。在 Clash Verge Rev 的「连接」页里按域名搜索（如 github、registry.npmjs.org），能看到这条连接是否经过了代理、走的是哪个节点；「进程」列为空时，在配置里加一行 find-process-mode: always 就能显示是哪个程序发起的连接。客户端的分流规则与其它进阶设置见 Clash Verge Rev 进阶指南。

关于线路的选择

开发工具对线路的要求，比浏览网页更看重两点：大文件下载时的持续速度（镜像、模型、依赖包），以及长时间连接期间不中断。配置部分照上面逐个工具设好即可；能用国内镜像的场景用镜像，镜像覆盖不到的再交给代理，两者并不冲突。

如果你在找线路，科技熊是可选项之一：每个节点提供 [专线]（走 BGP IEPL 专线）和经海外中转的 [备线] 两条线路，备线只按同节点专线的四分之一计流量（最低 0.5x），拉镜像、下模型这类大流量场景可以考虑。桌面端按 Clash Verge Rev 教程下载客户端、登录账号即可，默认混合端口 7897，正好对应上文的示例。新用户有 ¥1 体验（1GB / 1 天），可以先测一下连接质量。是否选择由你判断。

用 AI 编程工具的，代理配置各有自己的特点：OpenAI Codex 见 Codex 代理配置完整教程（.codex/.env 会覆盖系统变量），Claude Code 见 Claude Code 代理配置教程（不支持 SOCKS，推荐写进 settings.json）。

关于科技熊工作室

重资本自建 IEPL 物理隔离专线，多链路高可用架构。对上网体验有极致追求的非主流工作室，从 2017 年起致力为全球用户提供稳定的网络加速服务。

查看套餐注册体验

本文最后更新：2026-10-26

← 上一篇Gemini CLI 代理配置与排障教程：登录超时、fetch failed、地区不支持怎么办（附 Gemini API / AI Studio，2026） 下一篇 →Cursor 代理配置与排障教程：登录正常、对话却一直 Reconnecting，模型提示地区不可用怎么办（2026）

开发者工具链代理配置大全：git、npm/pnpm/yarn、pip/uv、Docker、Homebrew、WSL、Go、Hugging Face 与 Ollama（2026）

一、总表：每个工具认哪种配置

二、通用做法：环境变量

三、git

HTTPS 地址（https://github.com/...）

SSH 地址（[email protected]:...）

镜像这条路

四、npm、pnpm、yarn

npm

pnpm

yarn

镜像这条路

五、pip 与 uv

pip

uv

镜像这条路

六、Docker

拉镜像：Docker Desktop（Windows / macOS）

拉镜像：Linux 上的 Docker Engine

容器内与构建时

镜像这条路

七、Homebrew

镜像这条路

八、WSL2

九、Go

十、Hugging Face

十一、Ollama

十二、排查顺序

关于线路的选择

HTTPS 地址（`https://github.com/...`）

SSH 地址（`[email protected]:...`）