HTTP Control API ووحدة تحكم الويب

[General]
external-http-controller = 127.0.0.1:9090
external-http-secret = your-secret-token
external-http-ui = true
external-http-cors = false

يوفر Chute واجهة HTTP Control API مدمجة ووحدة تحكم الويب، مشابهة للوحات معلومات Clash و Surge. تعرض API حالة المحرك، حركة المرور، الاتصالات، DNS، عناصر تحكم السياسات، وإدارة الإعدادات عبر نقاط نهاية REST.

يُقرأ http-api = <secret>@<host>:<port> الخاص بـ Surge على أنه external-http-controller مع external-http-secret. ويمكن أيضاً كتابة الأجزاء منفصلة: فيُقرأ http-api-secret و http-api-ui و http-api-cors على أنها external-http-secret و external-http-ui و external-http-cors، ويُقرأ http-api-web-dashboard كذلك على أنه external-http-ui؛ وتُحفظ الإعدادات بمفاتيح external-http-*. أما http-api-tls فغير مدعوم — إذ يتحدث المتحكم HTTP عادياً — ولا ينتج عنه سوى إشعار.

external-http-controller (الافتراضي: معطل)

external-http-controller = 127.0.0.1:9090

الطلبات التي تبقيها وحدة التحكم مقيمة أثناء الخدمة محدودة بـ 4 ميغابايت على macOS و1 ميغابايت على iOS وtvOS وAndroid.

عنوان ومنفذ خادم التحكم عبر HTTP. استخدم 127.0.0.1 للوصول المحلي فقط. الربط بأي عنوان غير استرجاعي (مثل 192.168.1.5:9090) يتطلب ضبط external-http-secret صراحةً؛ وبدونه يرفض الخادم البدء ويسجّل ما ينقصه.

عنوان البدل (0.0.0.0 أو :: أو *) يُعدّ غير استرجاعي في هذا الفحص، لأنه يستمع على كل الواجهات، وهو نقيض «المحلي فقط». والصيغ المقبولة هي 0.0.0.0:9090 و *:9090 (الشيء نفسه)، ولـ IPv6 [::]:9090 — أما :::9090 المجرّد فتُضاف له الأقواس تلقائياً؛ والعنوان الذي يتعذّر تحليله يُبلَّغ عنه كخطأ إعداد بدل ترك وحدة التحكم معطّلة بصمت. والنطاق 127.0.0.0/8 بأكمله يُعدّ استرجاعياً، لا 127.0.0.1 وحده.

external-http-secret (الافتراضي: رمز مُولَّد)

external-http-secret = your-secret-token

رمز Bearer المستخدم لمصادقة الـ API. يجب أن تتضمّن الطلبات الترويسة Authorization: Bearer <secret> — ويُقبل الرمز في هذه الترويسة فقط، لا كمعامل استعلام، وتتم المقارنة بزمن ثابت. يعيد فشل المصادقة 401 مع {"ok": false, "error": {"code": "unauthorized", "message": "missing or invalid token"}}. كل مسارات البيانات محمية: مسارات /api/*، وأسماء Clash البديلة، والمسارات الأقدم التي لا يقدمها الآن إلا Chute Android (/status و/policies و/dns و/records وما شابهها)، وهي أيضاً لا تقبل الرمز إلا في هذه الترويسة. أما لوحة المعلومات البعيدة في Chute Android نفسه فلا تستخدم الآن إلا مسارات /api/*. أما صفحة وحدة تحكم الويب وأصولها الثابتة (/ و/assets/…، وعلى Chute Android أيضاً /ui) فلا تحتاج إلى رمز (ومع external-http-ui = false تختفي كلياً — فتعيد الصفحة 404).

عند غياب هذا المفتاح يولّد Chute رمزاً بدل التقديم دون مصادقة. يُكتب الرمز المُولَّد إلى ملف control-token في مجلد المشاركة الخاص بـ Chute — لا بجوار الإعداد: حاوية مجموعة التطبيقات على iOS و tvOS، ودليل البيانات الخاص بالتطبيق على Android — بصلاحيات للمالك وحده، ويُعاد استخدامه بعد إعادة التشغيل، وتعرضه التطبيقات — انظر فتح وحدة تحكم الويب. يمكن لواجهة التحكم أن تسلّم قاعدة بيانات الاتصالات، وسجلاتها تحمل كل رابط وترويسة واسم عملية شاهدها التشغيل، فواجهة تحكم مفتوحة ليست إعداداً افتراضياً معقولاً.

إن أردت التقديم دون مصادقة رغم ذلك، فقل ذلك صراحةً في الإعداد:

external-http-secret = none

وهذا مقبول على ربط استرجاعي فقط. خارج عنوان الاسترجاع لا يكفي none ولا غياب المفتاح: يرفض خادم التحكم البدء ويوضّح ما يحتاجه.

ملاحظة عند الترقية: إن كنت تعتمد على أن غياب external-http-secret يعني «بلا مصادقة»، فستبدأ سكريبتاتك المحلية بتلقّي 401. اقرأ الرمز المُولَّد من التطبيق، أو اكتب external-http-secret = none للإبقاء على السلوك القديم عن قصد.

external-http-ui (الافتراضي: true)

external-http-ui = true

عند التفعيل، يقدم Chute وحدة تحكم ويب مدمجة عند عنوان المتحكم. توفر وحدة تحكم الويب نظرة عامة، إدارة الاتصالات، فحص DNS، مراقبة حركة المرور، عناصر تحكم السياسات، وتحرير الإعدادات. عيّن إلى false لإبقاء API مفعلة مع تعطيل واجهة المستخدم.

فتح وحدة تحكم الويب

تُقدَّم وحدة التحكم على عنوان خادم التحكم، ويستطيع كل تطبيق أن يسلّمك العنوان والرمز — بما في ذلك الرمز المُولَّد الذي لا سبيل آخر لقراءته:

  • Chute Mac: شريط القوائم ← Open Web Console (فتح وحدة تحكم الويب)، و Copy Web Console Token (نسخ رمز وحدة تحكم الويب). وفي نافذة تفاصيل الاتصال زر Requests & History (الطلبات والسجل) يفتح وحدة التحكم أيضاً — صفحتها الرئيسية لا ذلك الاتصال.
  • Chute iOS: لوحة التحكم ← صف Web Console ← Open (فتح) أو Copy Address (نسخ العنوان) أو Copy Access Token (نسخ رمز الوصول).
  • Chute tvOS: في لوحة التحكم صف مستقل باسم Web Console Address يعرض المضيف والمنفذ. وعند اختياره يظهر رمز QR إن كان المستمع متاحاً من أجهزة أخرى — ورمز تسجيل الدخول داخل الرمز لا على الشاشة — أما إن كانت وحدة التحكم مربوطة بعنوان الاسترجاع فيظهر شرح بدلاً منه، لأن وحدة تحكم على عنوان الاسترجاع لا يمكن فتحها من هاتف.
  • Chute Android: لوحة التحكم ← Web Console Address ← Open (فتح) أو Copy Address (نسخ العنوان)، وصف Generated access token الذي يُنسخ بالنقر. ولا يظهر أي من الصفين حين يكون الرمز سرّاً ضبطته بنفسك، فهذا لا يُعرض أبداً.

العنوان الناتج يحمل الرمز في معامل استعلام. تستهلكه الصفحة عند التحميل وتزيله من شريط العنوان، لذا فتح الرابط تسجيل دخول كامل ولا أحد مضطر لنسخ 32 خانة ست عشرية يدوياً.


external-http-cors (الافتراضي: false)

external-http-cors = true

تفعيل ترويسات CORS (Cross-Origin Resource Sharing) على استجابات API. مفيد عندما تحتاج وحدة تحكم الويب أو أدوات خارجية للوصول إلى API من أصل مختلف.

نقاط نهاية API:

الطريقة نقطة النهاية الوصف
GET /api/status حالة وقت التشغيل، المنافذ، مدة التشغيل
GET /api/traffic عدادات حركة المرور العامة ولكل سياسة
GET /api/connections الاتصالات النشطة الحالية
DELETE /api/connections/:id إغلاق اتصال
GET /api/connections/history سجلات الاتصالات التاريخية
GET /api/connections/processes إحصاءات الاتصالات لكل عملية
GET /api/connections/:id/request بيانات الطلب الملتقطة لاتصال
GET /api/connections/:id/response بيانات الاستجابة الملتقطة لاتصال
GET /api/dns سجلات ذاكرة DNS المؤقتة
DELETE /api/dns/cache مسح ذاكرة DNS المؤقتة
DELETE /api/dns/records/:domain إزالة سجل DNS واحد
GET /api/config الإعدادات الحالية
PUT /api/config إعادة تحميل الإعدادات
POST /api/config/validate تحليل إعدادات والإبلاغ عن أخطائها دون تحميلها
GET /api/policies مجموعات السياسات والاختيار الحالي؛ ويحمل كل عنصر hidden، وقيمته true للمجموعة الموسومة بـ hidden=true
PUT /api/policies/:group تغيير اختيار مجموعة السياسات
PUT /api/mode تعيين وضع الخروج
GET /api/features حالات مفاتيح الميزات
PUT /api/features/mitm تبديل MitM
PUT /api/features/record-traffic تبديل تسجيل حركة المرور
GET /api/rules جدول القواعد الذي يمر عليه المطابِق، ومصدر كل قاعدة، وقواعد إعادة الكتابة التي عملت
POST /api/rules/match إلى أين سيُوجَّه طلب، دون إرساله
GET /api/rules/user القواعد المضافة أثناء التشغيل، وتُطابَق قبل الوحدات والإعدادات
PUT /api/rules/user استبدال قواعد وقت التشغيل
POST /api/rules/user إضافة قواعد خلف قواعد وقت التشغيل
DELETE /api/rules/user إزالة كل قواعد وقت التشغيل
GET /api/logs أحدث مدخلات السجل
GET /api/loglevel مستوى السجل الحالي، والأقسام التي تُكتب
PUT /api/loglevel تغيير مستوى السجل أو الأقسام دون إعادة تشغيل
GET /api/health صحة المحرك: مرات الرفض، الأجيال، البصمة، الخروج السابق
GET /api/events لحظات جديرة بالانتباه في هذا التشغيل
GET /api/tailscale الحالة الحيّة لمحرك Tailscale
GET /api/scripts السكريبتات العامة التي يمكن تشغيلها عند الطلب
POST /api/scripts/run تشغيل سكريبت عام واحد بالاسم
POST /api/diagnostics/ping فحص وصول عبر ICMP أو TCP
POST /api/diagnostics/dns-query حلّ نطاق عبر المحلِّل العامل
POST /api/diagnostics/egress-probe فحص العنوان: على محركات Apple عناوين الجهاز نفسه؛ وعلى Android، العنوان العام للجهاز على شبكته الفعلية، لا مخرج بروكسي
POST /api/diagnostics/internet-test اختبار الإنترنت المباشر: جلب internet-test-url بلا بروكسي
POST /api/diagnostics/url-test/:policy تشغيل اختبار زمن الاستجابة لسياسة
POST /api/diagnostics/bundle بناء أرشيف تشخيصي مُنقّح
GET /api/connections/export تصدير الاتصالات بصيغة HAR 1.2
GET /api/rewrites كل عائلات إعادة الكتابة/الاستجابة الوهمية وقائمة مضيفي MitM
GET /api/rewrites/:family قواعد عائلة واحدة
POST /api/rewrites/:family إضافة قاعدة
DELETE /api/rewrites/:family/:id حذف قاعدة
DELETE /api/rewrites/:family إفراغ عائلة
GET /api/mitm/hosts المضيفون الذين يُفكّ تشفيرهم حالياً
POST /api/mitm/hosts إضافة مضيف
DELETE /api/mitm/hosts/:host حذف مضيف
DELETE /api/mitm/hosts إفراغ القائمة
GET /api/rules/providers مزوّدو القواعد ومجموعات القواعد وحالة كل منها — بما في ذلك سبب عدم تحميل أحدها

ملاحظات نقاط النهاية:

  • تبلّغ GET /api/features عن كل مفتاح كما هو مضبوط — record_traffic و mitm و mitm_h2 و mitm_auto_quic_block و rewrite — وعن licensed. ويقول effective ما يعمل فعلاً، لخمسة عناصر فقط: record_traffic و mitm و rewrite و scripts و lan_proxy. وفي النسخة المجانية تكون الخمسة كلها خطأ (false)، فقد يظهر مفتاح مفعّلاً بينما مدخله في effective خطأ. أما inactive فكائن يسمّي ما تطلبه الإعدادات العاملة ولا يعمل في هذه النسخة: الأعداد scripts و scriptRules و dnsScripts و rewrites و mapLocals، والأعلام mitm و bodyCapture و lanProxy و exitNode (إعلان Tailscale، الذي لا يقوم به إلا Chute Mac). ومع ترخيص، أو حين يكون المحرك متوقفاً، يكون كل عدد 0 وكل علم خطأ (false).
  • GET /api/connections تقبل limit (عدد صحيح موجب، الافتراضي والحد الأقصى 1000) و cursor (تُرجع فقط الاتصالات التي يكون id فيها أكبر من المؤشر). يحمل حقل data في الاستجابة connections و total و page_size و has_more و server_time و — عند وجود صفحات إضافية — next_cursor. ويُرجع since (بالثواني، وهو server_time من إجابة سابقة) الاتصالات التي تغيّرت بعد تلك اللحظة فقط، ويضيف active_ids، وهي معرّفات كل اتصال مفتوح الآن: فالاتصال الذي كان في إجابة سابقة وغاب عنها قد أُغلق. وsince الأحدث من server_time يُعامَل على أنه 0، فتُرجَع كل الاتصالات.
  • GET /api/connections/history تقبل limit (الافتراضي 100، الحد الأقصى 1000) و cursor/before (مترادفان؛ تمريرهما معاً يُرفض).
  • GET /api/connections/:id/request و .../response تُرجعان {"connection_id": <id>, "data": "<base64>"}. الالتقاطات الأكبر من 2 MiB تُرجع 413. وبلا Chute Pro تُرجع كلتاهما 403، مع request data is not available أو response data is not available، حتى للمحتويات المسجّلة أثناء تشغيل سابق مرخّص.
  • تُرجع GET /api/config الإعدادات العاملة كما كُتبت، بما فيها بيانات الاعتماد — http-auth و external-http-secret و ca-p12 و ca-passphrase ومفاتيح WireGuard وكلمة مرور كل بروكسي — فالوصول إلى واجهة التحكم وصولٌ إليها جميعاً. ولا يستبدل بيانات الاعتماد بـ <redacted> إلا الحزمة التشخيصية، ولا يمكن تحميل تلك النسخة من جديد: فالإعدادات المرسلة إلى PUT /api/config وفيها <redacted> في أي موضع تُرفض بالرمز 400 مع رسالة تسمّي أول سطر من هذا النوع. أرسل الإعدادات الأصلية بدلاً من ذلك.
  • كما يمكن بلوغ GET و PUT /api/config عبر /api/configs، وعبر الاسم البديل المتوافق مع Clash /configs.
  • PUT /api/config تقبل إما JSON بالشكل {"configuration": "<full text>"} أو نص الإعدادات الخام كمحتوى للطلب (بحد 1 MB). عند النجاح يعيد المحرك التحميل — أو يبدأ، إن لم يكن يعمل.
  • PUT /api/policies/:group تأخذ الاختيار من أول مفتاح موجود في المحتوى من بين policy و name و selected و select؛ ويمكن أن تكون القيمة اسم سياسة أو فهرساً رقمياً كنص. اسم المجموعة الخاص GLOBAL يعيّن السياسة المختارة العامة.
  • في GET /api/policies، تحمل كل سياسة ومجموعة وعضو مجموعة endpoint، أي السياسة التي يقود إليها الآن — متتبَّعاً عبر المجموعات، وعبر PROXY المدمجة إلى السياسة المختارة للوضع العام — و endpoint_ping، أي زمن استجابة تلك السياسة. أما ping الخاص بالمجموعة نفسها فهو 0، غير مقيس، ولذلك فإن endpoint_ping هو الرقم الذي يُقرأ لمجموعة أو لـ PROXY.
  • PUT /api/mode تتطلب رقم JSON: {"mode": 0} — 0 القواعد، 1 مباشر، 2 بروكسي.
  • PUT /api/features/mitm و PUT /api/features/record-traffic تأخذان {"enabled": true}.
  • GET /api/logs تقبل since (ثوانٍ Unix)؛ يحتفظ المخزن المؤقت في الذاكرة بأحدث 1000 مدخلة، كل منها {timestamp, wall_time, level, section, message} — ويحمل timestamp و wall_time القيمة نفسها بثوانٍ Unix، مدفوعةً إلى الأمام حين لا تتقدم الساعة، كي يبقى ترتيب المدخلات صارماً.
  • يبلّغ GET /api/health عمّا يحتفظ به المحرك وسبب آخر رفض صدر عنه، وكيف انتهى التشغيل السابق (clean أو unclean أو suspected_memory — انظر استكشاف الأخطاء وإصلاحها). ويقول addressFamily كيف يحكم Chute على مخرج IPv6 — ipv6 قيمته healthy أو confirming أو degraded — مع أعداد ما فعله حيال ذلك؛ وعلى محركات Apple يبلّغ selfLoop عن حارس الحلقة الذاتية. ولا يحمل أيٌّ منهما عنواناً.
  • يقدّم GET /api/events الحلقة الموجودة في الذاكرة؛ أما ?persisted=1 فيقرأ السجل المحفوظ لهذا التشغيل، ويجيب بـ available: false عند تعطيل التسجيل.
  • يجيب GET /api/tailscale بـ state: "idle" عندما لا يوجد قسم [Tailscale] — وهذه إجابة طبيعية لا خطأ.
  • تأخذ فحوص POST /api/diagnostics/* معاملاتها من سلسلة الاستعلام أو من محتوى JSON، ومحدودة بعشر ثوانٍ، وتجيب مرة واحدة بالضبط. ويرفض url-test/:policy اسم سياسة غير معرّفة بدل قياس REJECT.
  • يسرد GET /api/scripts السكريبتات العامة المفعّلة بالشكل {name, type}؛ ويأخذ POST /api/scripts/run الحقل name من المحتوى أو من سلسلة الاستعلام، وهو محدود كفحوص التشخيص، ويجيب بـ {name, timedOut, result} — وtimedOut يميّز السكريبت الذي لم يستدعِ $done قط عن الذي عمل حتى النهاية. والاسم الذي ليس سكريبتاً عاماً مفعّلاً يعطي 404. وبلا Chute Pro يجيب بـ 403، script is not available.
  • يجيب POST /api/rules/match عن إلى أين سيذهب الطلب، دون فتح اتصال. يقبل host (أو url يأخذ منه المضيف والمنفذ؛ وتُختبر قاعدة URL-REGEX على url هذا كما هو مكتوب تماماً، مع أنها في الحركة الحقيقية لا ترى إلا طلبات http:// العادية)، وport (الافتراضي 443)، واختيارياً ip وprotocol وprocess وprocess_path وsrc_ip وsrc_port وin_port وin_type وin_user وin_name وnetwork وssid وbssid وfrom_tun وuser_agent — والحقل غير المعروف يُرفض مع قائمة الحقول المقبولة بدل أن يُتجاهل. ويحمل الرد القاعدة matched (سطرها ونوعها والسياسة التي تسمّيها وresolved_policy التي تشير إليها المجموعة حالياً)، وpolicy، وneed_resolve، إضافة إلى rule_count وmatch_generation اللذين حُسب الجواب عليهما. ولأن النطاق يُطابَق مرتين — مرة بالاسم ومرة أخرى بعد معرفة العنوان — يحمل passes مدخلاً لكل مرور؛ وبدون ip لا يوجد إلا مرور ما قبل الحلّ، ويقول الرد ذلك في note. أضف explain=true للحصول على القواعد المرشّحة التي كان يمكن أن تطابق أيضاً، حتى 50 قاعدة، مع عدد مجموعات القواعد التي لم تُفتح.
  • يحلّل POST /api/config/validate إعدادات ثم يرميها: لا يتبنّى المحرك العامل منها شيئاً. أرسلها بصيغة {"configuration": "<full text>"} أو نصاً خاماً. والرد هو valid وerror_count وadvisory_count وrule_count وpolicy_count، وقائمة errors من {line, severity, content, error} — وseverity يفرّق بين سطر مرفوض وسطر قُبل مع تحفّظ، وcontent هو السطر المخالف كما كُتب — بما فيه بيانات الاعتماد، لأن سطر [Proxy] السيّئ كثيراً ما يكون فساده في الحقل نفسه الذي يحمل كلمة مروره — مقتطَعاً عند 4096 حرفاً. استخدمه قبل PUT /api/config الذي يعيد تشغيل الجلسة التي تنقّحها.
  • يبلّغ GET /api/loglevel بـ level الحالي وnslog_level وsections التي تُكتب في الملف، وavailable_levels / available_sections التي يمكنك ضبطها. ويقبل PUT (أو PATCH) الحقلين level وsections أو كليهما: وsections مصفوفة أسماء أقسام أو السلسلة "all"، والمصفوفة الفارغة مرفوضة — ولإيقاف التسجيل استخدم level بقيمة none. وتغيير المستوى بهذه الطريقة لا يعيد تشغيل الجلسة، وهذا هو المقصود: loglevel = verbose في الملف يحتاج إعادة تحميل، وإعادة التحميل تضيّع ما كنت تحاول رؤيته.
  • يبلّغ GET /api/rules أيضاً بـ rewrite_hits: كل قاعدة إعادة كتابة أو استجابة وهمية عملت في هذا التشغيل، مع عدّادها. القاعدة التي لا تظهر هناك لم تطابق قط، وهذا هو التفسير المعتاد لإعادة كتابة تبدو بلا أثر. يتتبّع الجدول حتى 512 قاعدة مختلفة ويبلّغ عمّا زاد عليها في rewrite_hit_dropped_rules. تسرد rules كل قاعدة يمر عليها المطابِق بالترتيب: قواعد Tailscale التلقائية، ثم القواعد المضافة عبر /api/rules/user، ثم قواعد الوحدات، ثم قسم [Rule] في الإعدادات، وتنتهي بـ FINAL؛ وتسمّي rule_regions مصدر كل سطر بالفهرس نفسه (front و user و module و configuration).
  • يحتفظ /api/rules/user بالقواعد المضافة أثناء عمل المحرك، دون إعادة تحميل ودون المساس بملف الإعدادات. وتُطابَق بعد قواعد Tailscale التلقائية وقبل قواعد الوحدات وقسم [Rule] في الإعدادات، بالترتيب المعطى. يسردها GET؛ ويستبدلها PUT ويضيف POST خلف الموجودة، وكلاهما يأخذ {"rules": ["<rule line>", ...]} أو {"rule": "<rule line>"} منفرداً، مكتوبةً كما في الملف؛ ويزيلها DELETE كلها. والكتابة كلها أو لا شيء: فالسطر الذي لا يمكن تحليله، أو FINAL، يُرفض بـ 400 وتبقى القواعد كما كانت. والقاعدة التي لا تعرّف الإعدادات العاملة سياستها تُقبَل — فتفشل مغلقةً بـ REJECT — وتُسمّى في warnings. وclose_rerouted، وقيمته الافتراضية true، يغلق الاتصالات التي توجّهها القواعد المتغيّرة إلى مكان آخر، وتلك وحدها؛ وfalse يُبقي كل اتصال مفتوحاً — ومع DELETE مرّره بالشكل ?close_rerouted=false. وتجيب كل طريقة بـ rules الحالية. وتبقى القواعد عبر إعادة التحميل وتزول حين يتوقف المحرك. ولا يُقبل PATCH على هذا المسار.
  • يأخذ POST /api/rewrites/:family الشكل {"rule": "<configuration line>"} — النص نفسه الذي تكتبه في الملف. والسطر الذي لا يمكن تحليله يُرفض بـ 400 بدل تخزينه كقاعدة لا تطابق أبداً. و :family واحدة من url-rewrite و header-rewrite و body-rewrite و mock. القواعد المضافة بهذه الطريقة تعيش في المحرك العامل ولا تُكتب في ملف الإعدادات.
  • يعيد GET /api/connections/export?format=har وثيقة HAR 1.2، ويعيد POST /api/diagnostics/bundle ملف zip — وكلاهما ملف، لذا لا يُغلَّفان في {"ok": ..., "data": ...} خلافاً لبقية النقاط. ويقبل export المعاملات source (الافتراضي current، أو history) و limit (الافتراضي 100 والحد الأقصى 300) و ids و bodies=1 لتضمين الحمولات الملتقطة. ويحمل كل مُدخل كائن _kl بما لا يوجد له حقل في HAR: السياسة المختارة، والقاعدة المطابِقة، وعمليات إعادة الكتابة التي عملت.
  • يحمل سجل الاتصال المُسلسل في GET /api/connections وGET /api/connections/history الحقل chainPath، وهو المسار من هذا الجهاز إلى المخرج، مثل Airport/HK-01 → Landing؛ ويكون فارغاً للاتصال الذي استخدم سياسة واحدة، ويحمله تصدير HAR في _kl.chain. وفي عدّادات كل سياسة في GET /api/traffic يحتسب المنبع أيضاً البايتات التي حملها للاتصالات المُسلسلة؛ أما الإجماليات العامة فتحتسبها مرة واحدة.

مثال — قراءة الحالة، ثم تبديل مجموعة سياسات:

curl -H "Authorization: Bearer your-secret-token" http://127.0.0.1:9090/api/status
{"ok":true,"data":{"running":true,"outbound_mode":0,"mitm":false, ...}}

curl -X PUT -H "Authorization: Bearer your-secret-token" \
     -d '{"policy": "ProxyB"}' http://127.0.0.1:9090/api/policies/MainGroup
{"ok":true,"data":{"outbound_mode":0,"selectable_groups":[...], ...}}

مثال — اسأل إلى أين سيذهب الطلب قبل إرساله:

curl -X POST -H "Authorization: Bearer your-secret-token" \
     -d '{"url": "https://api.example.com/v1/orders", "explain": true}' \
     http://127.0.0.1:9090/api/rules/match
{"ok":true,"data":{"policy":"MainGroup","matched":{"rule":"DOMAIN-SUFFIX,example.com,MainGroup", ...}, ...}}

ضيّق السجل إلى نظام فرعي واحد أثناء إعادة إنتاج المشكلة، دون إعادة تشغيل الجلسة:

curl -X PUT -H "Authorization: Bearer your-secret-token" \
     -d '{"level": "verbose", "sections": ["MitM", "DNS"]}' \
     http://127.0.0.1:9090/api/loglevel

ملاحظة: هذه الميزة معطلة افتراضياً. تستخدم كل استجابة الغلاف {"ok": true, "data": {...}} عند النجاح و {"ok": false, "error": {"code": "...", "message": "..."}} عند الأخطاء؛ ومحتويات الطلبات محدودة بـ 1 MB.

تقبل نقاط النهاية PUT أيضاً PATCH. وتتوفر مسارات بديلة متوافقة مع Clash للوحات المعلومات الخارجية: /version و /traffic و /connections و /configs و /proxies و /rules — المسارات قابلة للوصول، لكن الاستجابات تستخدم غلاف Chute وأسماء حقوله بدلاً من مخطط Clash (تُرجع /version القيم {"name", "run_id", "egress_probe"}، حيث يكون egress_probe قيمته network_address على محركات Apple وegress_ip على Android)، لذا لن تعمل لوحات معلومات Clash مباشرةً دون تعديل.

S. Smart Rabbit LLC © All Rights Reserved            updated 2026-11-19 16:07:28

هذه الصفحة ترجمة للنسخة الإنجليزية. في حال وجود اختلاف، يُعتمد على النسخة الإنجليزية.

ملاحظة: التطبيق لا يدعم اللغة العربية حاليًا.

results matching ""

    No results matching ""