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