API کنترل خارجی کلش: پراکسی زیر فرمان اسکریپت

پنجرهٔ کلش ورج در اصل یک ریموت‌کنترل است: هستهٔ Mihomo زیر آن یک HTTP API باز می‌کند و هر کلیک رابط کاربری به یک فراخوانی API ترجمه می‌شود. این فراخوانی‌ها در اختیار شما هم هست: اسکریپت خودکارسازی، Stream Deck یا پنل‌های شخص ثالث همه با همین زبان حرف می‌زنند.

مطمئن شوید API روشن است

کلش ورج کنترلر خارجی را به‌طور پیش‌فرض فعال می‌کند، معمولاً روی 127.0.0.1:9097. پورت و کلید (secret) در تنظیمات، بخش هستهٔ کلش دیده می‌شوند. آزمایش:

curl http://127.0.0.1:9097/version -H "Authorization: Bearer کلید_شما"

یک JSON با شمارهٔ نسخه یعنی برقرار است.

اندپوینت‌های اصلی

اندپوینت	متد	کاربرد
/proxies	GET	همهٔ سرورها و گروه‌ها با انتخاب فعلی
/proxies/گروه	PUT	تعویض سرور انتخابی گروه
/configs	PATCH	تغییرات در لحظه — مثلاً حالت
/connections	GET/DELETE	مشاهده یا قطع اتصال‌های زنده
/proxies/سرور/delay	GET	تست تأخیر یک سرور

تعویض سرور در یک خط

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 می‌شود هستهٔ رایانه را از گوشی هدایت کرد.

ایده‌های خودکارسازی

• جابه‌جایی بر اساس سلامت: هر ۱۰ دقیقه /delay را بگیرید؛ از آستانه گذشت، گروه را با PUT روی ذخیره بگذارید؛
• حالت جلسه: یک اسکریپت هم‌زمان حالت Rule و کم‌تأخیرترین سرور را می‌نشاند — روی یک کلید؛
• داشبورد: /traffic و /connections را در Grafana بریزید — تصویر زندهٔ تونل.

مرجع کامل API در مستندات Mihomo. و اگر هدف نه کنترل هسته، بلکه عبور دادن ابزارهای خط فرمان از پراکسی است — آن تنظیم پراکسی ترمینال است.