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 مباشرةً دون تعديل.
هذه الصفحة ترجمة للنسخة الإنجليزية. في حال وجود اختلاف، يُعتمد على النسخة الإنجليزية.
ملاحظة: التطبيق لا يدعم اللغة العربية حاليًا.