Skip to content

wsl-proxy-huggingface-external.md

Latest commit

 

History

History
38 lines (28 loc) · 1.25 KB

wsl-proxy-huggingface-external.md

File metadata and controls

38 lines (28 loc) · 1.25 KB
Raw
domain contrib
title wsl proxy huggingface external
verification metadata-normalized
created 2026-07-06
source unknown

---{"title": "WSL 需要代理Setup才能Access HuggingFace 和外部网络", "domain": "devops", "subdomain": "wsl", "source": "bootstrap", "status": "published", "tags": ["project:self-grow-wiki", "severity:high", "platform:wsl", "node:hermes_wsl"], "confidence": "0.8", "created": "2026-05-03"}---

Problem

WSL 内 Python 脚本无法下载 HuggingFace 模型（sentence-transformers/BGE）， git clone HuggingFace 仓库也失败，只有 Windows 侧能访问外网。

Root Cause

WSL2 使用 NAT 网络，默认不继承 Windows 的代理设置。 Windows 侧有梯子（HTTP 代理），但 WSL 不知道代理地址。

Solution

在 ~/.bashrc 中添加：

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export no_proxy=localhost,127.0.0.1,.local

端口 7890 是 Windows 侧梯子的 HTTP 代理端口（Clash/Clash Verge 默认）。

Verification

source ~/.bashrc 后，wget https://huggingface.co 返回 200，python 下载模型成功。

Notes

WSL2 + Windows 11，无企业代理，使用个人梯子（Clash Verge/CFW/v2rayN）。