mirror of
https://gitverse.ru/kpa39l/openspec-lab.git
synced 2026-09-29 09:15:01 +00:00
estorozhenko
45 lines
2.6 KiB
Markdown
45 lines
2.6 KiB
Markdown
# Design: tavily-proxy-setup
|
|
|
|
## Approach
|
|
|
|
Tavily API блокирует РФ-адреса (403 на уровне AWS ELB). Решение — не менять глобально прокси Hermes (сломало бы прямой доступ к deepseek/polza), а завернуть только Tavily в локальный форвардер:
|
|
|
|
- `tavily_proxy.py` — http.server на 127.0.0.1:8971, принимает POST на /extract и /search, проксирует через httpx-клиент с SOCKS5-транспортом (`socks5://127.0.0.1:1080`, туннель до VPS01).
|
|
- Hermes настраивается на `TAVILY_BASE_URL=http://127.0.0.1:8971` — официальный способ подменить endpoint, httpx-провайдер Tavily шлёт запросы туда.
|
|
- Зависимость от туннеля: `After=telegram-tunnel.service` + `Restart=always`.
|
|
|
|
## Files
|
|
|
|
- `/opt/hermes/.hermes/scripts/tavily_proxy.py` — форвардер (Python, venv Hermes)
|
|
- `/opt/hermes/.hermes/scripts/tavily_extract_proxy.py` — форвардер + локальный экстрактор (trafilatura), юнит указывает на него: `--socks 127.0.0.1:1080 --upstream https://api.tavily.com`
|
|
- `/etc/systemd/system/tavily-proxy.service` — юнит (enabled)
|
|
- `/opt/hermes/.hermes/.env` — `TAVILY_API_KEY`, `TAVILY_BASE_URL=http://127.0.0.1:8971`
|
|
- `/opt/hermes/.hermes/config.yaml` — `web.extract_backend: tavily`
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
# Применение
|
|
sudo systemctl daemon-reload
|
|
sudo systemctl enable --now tavily-proxy.service
|
|
|
|
# Проверка
|
|
systemctl is-active tavily-proxy.service
|
|
curl -s -o /dev/null -w "%{http_code}" -X POST http://127.0.0.1:8971/extract \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"urls":["https://example.com"],"api_key":"'"$TAVILY_API_KEY"'"}'
|
|
# → 200, web_extract отдаёт контент
|
|
```
|
|
|
|
## Rollback
|
|
|
|
```bash
|
|
sudo systemctl disable --now tavily-proxy.service
|
|
# удалить TAVILY_BASE_URL из .env; extract_backend вернуть на searxng (extract не работал — деградация к прежнему состоянию)
|
|
```
|
|
|
|
## Risks
|
|
|
|
- Туннель VPS01 недоступен → Tavily тоже недоступен (extract лежит) — приемлемо: без туннеля Tavily блокирован в любом случае.
|
|
- httpx-SOCKS требует пакет socksio в venv — проверено, есть.
|
|
- Форвардер — однопоточный http.server (ThreadingHTTPServer), достаточно для одного агента. |