کنترلر بیرونی: هدایت Clash با API از نوع REST
خط external-controller: 127.0.0.1:9090 در پیکربندی، از هسته یک HTTP API بیرون میدهد — رابط خود Clash for Windows هم از همین راه کار میکند. اسکریپتهای شما هم میتوانند:
مرور سریع نقاط پایانی
# همهٔ گروهها و گرهها
curl http://127.0.0.1:9090/proxies
# گروه "Proxy Select" را روی گرهٔ "HK-01" بگذار
curl -X PUT http://127.0.0.1:9090/proxies/Proxy%20Select ^
-d "{\"name\": \"HK-01\"}"
# ترافیک زنده (جریان پیوسته)
curl http://127.0.0.1:9090/traffic
# قطع همهٔ اتصالها
curl -X DELETE http://127.0.0.1:9090/connections
# تست تأخیر یک گره
curl "http://127.0.0.1:9090/proxies/HK-01/delay?timeout=3000&url=http://www.gstatic.com/generate_204"
هشدار امنیتی
اگر شنونده را روی 0.0.0.0:9090 بردید (مثلاً برای کنترل از گوشی)، حتماً فیلد secret را تنظیم و هدر Authorization: Bearer <secret> را بفرستید — وگرنه هرکس در شبکه پروکسیتان را بازپیکربندی میکند. رابط دوستانهتری روی همین API: «پنلهای شخص ثالث».