راهنمای کاربر / پیشرفته

کنترلر بیرونی: هدایت Clash با API از نوع REST

پیشرفته · به‌روزرسانی 2026-03-02 · حدود 2 دقیقه مطالعه

خط 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: «پنل‌های شخص ثالث».