Clash 代理 (WSL ↔ Windows)

Clash for Windows 运行在 Windows 侧，WSL 通过 localhost 转发访问。

端口

协议	地址
HTTP	http://127.0.0.1:7890
SOCKS5	socks5://127.0.0.1:7891

探测代理是否运行

curl -s --connect-timeout 1 http://127.0.0.1:7890

• 返回 HTTP 400（空响应体）→ 正常运行（对裸请求的预期响应）
• curl: (7) Failed to connect 或 curl: (28) Connection timed out → 未启动

一行判断：

curl -s --connect-timeout 1 http://127.0.0.1:7890 > /dev/null && echo "UP" || echo "DOWN"

设置代理环境变量

fish shell（当前默认 shell）

set -x HTTP_PROXY http://127.0.0.1:7890
set -x HTTPS_PROXY http://127.0.0.1:7890
set -x ALL_PROXY http://127.0.0.1:7890
set -x NO_PROXY localhost,127.0.0.1,::1,.local

bash/zsh

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export ALL_PROXY=http://127.0.0.1:7890
export NO_PROXY=localhost,127.0.0.1,::1,.local

各工具的代理方式

curl / wget

自动读取 HTTP_PROXY / HTTPS_PROXY 环境变量，设置后即可。

git

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

# 取消
git config --global --unset http.proxy
git config --global --unset https.proxy

uv (Python 包管理)

# 方式1：环境变量（推荐，已设置全局 env 后自动生效）
uv pip install <package>

# 方式2：命令行指定
HTTPS_PROXY=http://127.0.0.1:7890 uv pip install <package>
HTTPS_PROXY=http://127.0.0.1:7890 uv python install 3.10

pip

pip install --proxy http://127.0.0.1:7890 <package>
# 或设置环境变量后自动生效

npm / npx

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

Docker

Docker 拉镜像走代理需要配置 daemon（不是环境变量），见 Docker Desktop 设置或 /etc/docker/daemon.json。

但 WSL 中 docker pull 实际走的是 Docker Desktop（Windows 侧），已在 Windows 侧配置代理时无需额外设置。

huggingface-cli / hf download

# hf-mirror 替代（不需代理，但有时不稳）
export HF_ENDPOINT=https://hf-mirror.com

# 走代理直连 HuggingFace
HTTPS_PROXY=http://127.0.0.1:7890 huggingface-cli download <org>/<repo>

modelscope

Modelscope 是国内 CDN，不需要代理，直连即可。

Hermes 终端命令中的代理

在 terminal() 中使用需要代理的命令时，必须在命令前设置环境变量（同一行），因为 Hermes 的 shell 环境变量会跨调用持久化：

# 如果之前已 set -x，直接运行
curl -L https://github.com/...

# 如果未设置，命令前指定
HTTPS_PROXY=http://127.0.0.1:7890 curl -L https://github.com/...

Hermes 内部进程（Web 插件、Python 子进程）的代理

Hermes 的 web 搜索插件（Tavily）用 httpx 发请求，httpx 读 HTTP_PROXY/HTTPS_PROXY 环境变量。但 Hermes 的 Python 进程不继承 shell 的代理变量。

解决方案：写入 ~/.hermes/.env

echo 'HTTP_PROXY=http://127.0.0.1:7890' >> ~/.hermes/.env
echo 'HTTPS_PROXY=http://127.0.0.1:7890' >> ~/.hermes/.env

Hermes 在启动时加载 .env，后续所有 httpx/requests 调用自动走代理。

注意：当前 Hermes 进程不会重读 .env，修改后需 /new 重启会话生效。

追加说明

Tavily 插件的 _tavily_request() 在 provider.py 第57行：

response = httpx.post(url, json=payload, timeout=60)

httpx 使用 HTTP_PROXY（注意是大写）作为代理 URL，不走任何 Hermes 内部代理配置。HTTP_PROXY（小写）也被 httpx 识别，但部分 Python HTTP 库只认大写版本。建议 .env 里同时设大写和小写。

Tavily 域名

• 正式：https://api.tavily.com（GFW 阻断，需代理）
• 可通过 TAVILY_BASE_URL 环境变量覆盖（需要自建反代）

调试 Tavily 连通性

# 直连测试 — 确认 GFW 状态
curl -s --max-time 10 -X POST "https://api.tavily.com/search" \
  -H "Content-Type: application/json" \
  -d '{"query":"test","api_key":"YOUR_KEY"}'
# 预期失败：Connection reset by peer（GFW 阻断）

# 代理测试
curl -s -x http://127.0.0.1:7890 --max-time 10 -X POST "https://api.tavily.com/search" \
  -H "Content-Type: application/json" \
  -d '{"query":"test","api_key":"YOUR_KEY"}'
# 预期：正常返回 JSON 结果

Hermes 已配置 env_passthrough（~/.hermes/config.yaml:79-82），包含 http_proxy、https_proxy、ALL_PROXY。这是 shell → 子进程的透传，与 Python 内 httpx 直接读 env 的行为互补。

常见陷阱

1. WSL 重启后 localhost 转发可能变化 — 如果 127.0.0.1:7890 不通，检查 Windows 侧 Clash 是否在运行，以及 WSL 是否能访问 Windows 的 localhost（通常可以）
2. SOCKS5 和 HTTP 代理端口不同 — 大部分工具用 HTTP 代理（7890），SOCKS5（7891）用于需要 TCP 级别代理的场景
3. NO_PROXY 别忘了设 — 否则访问本地服务也会走代理
4. git clone 走 HTTPS 才走代理 — SSH 协议 (git@github.com:...) 不走 HTTP 代理，需要用 ssh -o ProxyCommand 或改用 HTTPS 地址