Окно Clash Verge — по сути пульт: ядро Mihomo под ним открывает HTTP API, и каждый клик в интерфейсе превращается в API-вызов. Эти вызовы доступны и вам: скрипты автоматизации, Stream Deck, сторонние панели — всё говорит на одном языке.

Вызов API управления Clash через curl: версия ядра и переключение прокси
Обычный HTTP — для управления ядром хватает curl

Проверяем, что API включён

Clash Verge включает внешний контроллер по умолчанию, обычно на 127.0.0.1:9097. Порт и секрет видны в настройках, в разделе ядра. Проверка:

curl http://127.0.0.1:9097/version -H "Authorization: Bearer ВАШ_СЕКРЕТ"

JSON с номером версии — значит, работает.

Секрет держите непустым. Пустой секрет плюс прослушивание 0.0.0.0 отдаёт управление прокси всей локальной сети — и любой вредоносной странице, способной слать запросы из вашего браузера.

Главные эндпоинты

ЭндпоинтМетодНазначение
/proxiesGETВсе узлы и группы с текущим выбором
/proxies/ГРУППАPUTСменить выбранный узел группы
/configsPATCHИзменения на лету — например, режим
/connectionsGET/DELETEПосмотреть или разорвать соединения
/proxies/УЗЕЛ/delayGETТест задержки одного узла

Сменить узел одной строкой

curl -X PUT http://127.0.0.1:9097/proxies/PROXY \
  -H "Authorization: Bearer ВАШ_СЕКРЕТ" \
  -d '{"name":"HK-01"}'

Перейти в Global

curl -X PATCH http://127.0.0.1:9097/configs \
  -H "Authorization: Bearer ВАШ_СЕКРЕТ" \
  -d '{"mode":"global"}'

Веб-панели

yacd и metacubexd — чистые API-клиенты в браузерной вкладке. Откройте панель, укажите 127.0.0.1:9097 и секрет — получите полноценный интерфейс управления. Удобно следить за соединениями, а в связке с Allow LAN — управлять ядром компьютера с телефона.

Идеи автоматизации

  • Failover по здоровью: cron раз в 10 минут дёргает /delay; за порогом — PUT на запасную группу;
  • Режим «совещание»: скрипт ставит Rule и закрепляет узел с минимальной задержкой — на горячую клавишу;
  • Дашборды: опрашивайте /traffic и /connections в Grafana — живая картина туннеля.

Полный справочник API — в документации Mihomo. А если задача не управлять ядром, а провести через прокси консольные утилиты — это настройка прокси для терминала.