وكيل الذكاء الاصطناعي (MCP) PRO PREVIEW

PREVIEW ملاحظة: خادم MCP ما زال في الاختبار الداخلي ولم يُنشر بعد. تصف هذه الصفحة النسخة قيد الاختبار: قد تتغير المفاتيح والمسارات وأسماء الأدوات وشاشات التطبيقات قبل إصدارها.

[General]
external-mcp-server = 127.0.0.1:6180

لمحرك Chute Mac و Chute iOS و Chute tvOS خادم MCP (Model Context Protocol) خاص به. يتصل به وكيل الذكاء الاصطناعي — Claude Code أو Codex أو أي عميل آخر يتحدث MCP — فيقرأ ما يفعله المحرك (الحالة، السياسات، القواعد، الاتصالات، DNS، السجل، الإعدادات) ويغيّره: يختار سياسة، يجرّب قاعدة، يعيد كتابة قسم من الإعدادات، يقيس أعضاء مجموعة.

وهو مبني على مسارات HTTP Control API ويصادق بالسر نفسه، لكنه مستمع مستقل على /mcp في منفذه الخاص: لا يحتاج إلى external-http-controller ولا إلى وحدة تحكم الويب. وهو مطفأ افتراضياً.

PRO ملاحظة: خادم MCP جزء من Chute Pro. من دون ترخيص لا يشغّله المحرك: لا يفتح external-mcp-server أي منفذ، ويبقى تحرير الإعدادات ممكناً. وما إن يسري الترخيص حتى يبدأ الخادم دون إعادة تشغيل Chute، ويتوقف حين يزول الترخيص؛ والفترة التجريبية المجانية في Chute Mac تُحسب ترخيصاً. أما HTTP Control API نفسه فلا يتأثر. ما تعرضه التطبيقات في هذه الأثناء مشروح في من دون Chute Pro؛ وانظر أيضاً الترخيص والتفعيل.

فيمَ يُستخدم

الوكيل هو من يقرأ، فاسأل بكلماتك. مثلاً:

  • «لماذا يخرج api.example.com عبر HK-01؟» — يسأل الوكيل match_rule الذي يسمّي القاعدة والسياسة، ثم يجرّب إصلاحاً بـ edit_user_rules، وحين ينجح يكتبه في [Rule] بـ replace_profile_section.
  • «أي العُقد في Auto ما زالت تعمل؟» — يقيس test_policy على المجموعة كل عضو بالترتيب ويبلّغ عن كل واحد حين ينتهي.
  • «التطبيق لا يصل إلى خادمه منذ الصباح.» — list_connections مع المرشّح failed، و get_logs مع كلمة مفتاحية، و run_diagnostics للشبكة نفسها.
  • «احجب الإعلانات في هذا الموقع.» — add_rewrite و add_mitm_host لتجربة ذلك في المحرك العامل، ثم الأسطر التي تستحق البقاء في الإعدادات.

التشغيل

external-mcp-server (الافتراضي: معطّل)

external-mcp-server = 127.0.0.1:6180

عنوان خادم MCP ومنفذه. هذا المفتاح خاص بـ Chute: ليس لدى Surge ولا Clash ما يقابله، واستيراد إعداداتهما لا يضيفه. يُكتب العنوان كما في external-http-controller: 127.0.0.1:6180 لهذا الجهاز وحده، و 0.0.0.0:6180 أو *:6180 لكل الواجهات، و [::]:6180 لـ IPv6؛ ويُعدّ كامل 127.0.0.0/8 و ::1 و localhost عناوين استرجاع. والعنوان الذي يتعذّر تحليله خطأ في الإعدادات. تستخدم التطبيقات المنفذ 6180 حين تشغّله.

المصادقة. يرسل الوكيل Authorization: Bearer <token>، والرمز هو رمز HTTP Control API:

  • external-http-secret إن كان في الإعدادات؛
  • وإلا فالرمز الذي يولّده Chute ويحفظه في ملف control-token في مجلد المشاركة — يُولَّد حتى حين يكون external-http-controller مطفأً، وتعرضه التطبيقات؛
  • external-http-secret = none يعني بلا مصادقة إطلاقاً، ولا يُقبل إلا على عنوان استرجاع.

خارج عنوان الاسترجاع يحتاج خادم MCP إلى external-http-secret صريح: لا الرمز المُولَّد ولا none يكفيان. من دونه لا يبدأ، وتعرض التطبيقات السبب.

يعمل مع المحرك. يبدأ حين يبدأ Chute ويتوقف حين يتوقف، فلا يستطيع الوكيل تشغيل Chute ولا إيقافه ولا جعل التطبيق ينتقل إلى إعدادات أخرى. وعند إعادة التحميل لا يُعاد تشغيل المستمع إلا إذا تغيّر عنوانه أو السر، وبعد أن تُكتب الردود التي في طريقها — فالوكيل الذي يغيّر عنوان خادم MCP نفسه يتلقى ردّه رغم ذلك.

external-mcp-mask-secrets (الافتراضي: true)

external-mcp-mask-secrets = false

هل تصل كلمات المرور والمفاتيح والرموز إلى الوكيل على هيئة مقابض — انظر إخفاء الأسرار. وهو كذلك مفتاح خاص بـ Chute، ولا يُكتب في الإعدادات إلا حين تكون قيمته false.

في التطبيقات

  • Chute iOS: في محرر الإعدادات، External Controller ← MCP Server: المفتاح، و Port، و Allow Access From Wi-Fi (يستمع على 0.0.0.0؛ وصف Secret المطلوب حينها هو سر HTTP Control API)، و Mask Secrets. صف AI Agent (MCP) (وكيل الذكاء الاصطناعي) في لوحة التحكم، تحت وحدة تحكم الويب، يعرض Running أو Not Listening أو Not Configured، ويفتح صفحة فيها سبب عدم استماع الخادم، والعنوان لـ This Device و — خارج الاسترجاع — لـ Other Devices، والرمز (مخفي حتى Show Token؛ والنقر على الصف ينسخه)، و CLIENT SETUP مع أمر claude mcp add و JSON جاهزين، و QUICK ACTIONS. يعمل خادم MCP داخل الـ VPN: حين يكون الـ VPN مطفأً تبيّن الصفحة ما ستفعله الإعدادات الحالية.
  • Chute Mac: تبويب Config في النافذة الرئيسية ← General ← MCP Server: Enable MCP Server، والعنوان والمنفذ، والسر المشترك مع HTTP Control API، و Mask secrets، و Status & Client Setup…. ما دام Chute يعمل، يفتح AI Agent (MCP)… في قائمة شريط القوائم (وفي قائمة … في لوحة شريط القوائم) نافذةً فيها الحالة والعناوين والرمز (Show، Copy) وهل الأسرار مخفية، و Connect an Agent: إعدادات Claude Code عبر HTTP، وإعدادات Claude Code عبر الأمر chute، و JSON للعملاء الآخرين.
  • Chute tvOS: Configuration Edit ← GENERAL ← MCP Server: تشغيل أو إطفاء، و Listen Address (127.0.0.1 أو 0.0.0.0)، والمنفذ، و Mask Secrets. وفي الصفحة نفسها يُضبط السر، وهو external-http-secret الخاص بـ HTTP Control API: يُعرض مخفياً حتى تطلب إظهاره؛ وتركه فارغاً يعني الرمز الذي يولّده Chute، و none يلغي المصادقة بعد تحذير. ولا يجوز أن يحتوي على مسافات أو فواصل أسطر. وتغييره يغيّر أيضاً مصادقة وحدة تحكم الويب والأمر chute. ومع 0.0.0.0 دون سر، تقول الصفحة إن الخادم لن يبدأ وتتيح لك ضبط السر هناك مباشرة. صف AI Agent (MCP) في لوحة التحكم يعرض الحالة و Address و LAN Address و Token المخفي حتى تختاره؛ ولا نسخ على التلفاز.

المفاتيح السريعة — QUICK ACTIONS على iOS، و Turn On MCP / Turn Off MCP و Mask secrets في نافذة Mac، و MCP Server و Mask Secrets في صفحة التلفاز — تغيّر هذين المفتاحين في ملف الإعدادات الحالي وتطبّقه فوراً؛ وحين يُشغَّل من هناك يستمع الخادم على 127.0.0.1:6180. وعلى iOS تكون معطّلة للاشتراك، لأن تحديثه التالي سيلغي التغيير.

من دون Chute Pro

من دون ترخيص تقول التطبيقات إن الخادم يحتاج إلى Chute Pro، بدلاً من أن تعرضه على أنه لا يستمع:

  • Chute Mac: يحمل AI Agent (MCP)… في قائمة شريط القوائم وفي قائمة … في لوحة شريط القوائم، و Enable MCP Server في صفحة General، كبسولة PRO. وتبدأ نافذة AI Agent (MCP) بملاحظة عن Chute Pro وزر Get Chute Pro، وتعرض حالتها Needs Chute Pro دون عنوان ولا رمز. ويفتح Turn On MCP نافذة Chute Pro بدلاً من تشغيل الخادم؛ أما الإيقاف و Mask secrets فيعملان كالمعتاد. وتضم نافذة Chute Pro AI Agent (MCP) بين ميزاتها.
  • Chute iOS و Chute tvOS: يحمل صف AI Agent (MCP) في لوحة التحكم ومفتاح MCP في محرر الإعدادات كبسولة PRO. وتعرض صفحة الحالة Needs Chute Pro وتقدّم الطريق إلى Chute Pro مكان العنوان والرمز؛ وتشغيل الخادم بالمفتاح السريع في تلك الصفحة يطلب Chute Pro أولاً، كسائر مفاتيح Chute Pro في التطبيقات.
  • في التطبيقات الثلاثة تبقى حقول محرر الإعدادات قابلة للتحرير، والإشعار الذي يسرد ميزات Chute Pro التي لم تعمل في هذا التشغيل يذكر خادم MCP.

توصيل وكيل

عبر HTTP

العميل الذي يتحدث Streamable HTTP يتصل مباشرة:

  • العنوان: http://<host>:<port>/mcp — ولوكيل على الجهاز نفسه http://127.0.0.1:6180/mcp؛
  • الترويسة: Authorization: Bearer <token>، بالرمز الذي يعرضه التطبيق.

في Claude Code:

claude mcp add --transport http chute http://127.0.0.1:6180/mcp --header "Authorization: Bearer <token>"

ولعميل يُضبط بـ JSON:

{"mcpServers": {"chute": {"type": "http", "url": "http://127.0.0.1:6180/mcp", "headers": {"Authorization": "Bearer <token>"}}}}

ينسخ Chute iOS و Chute Mac الاثنين والعنوان والرمز مملوءان. وعلى iPhone يصل تطبيق وكيل على الـ iPhone نفسه إلى الخادم عبر 127.0.0.1 أيضاً.

يتحدث الخادم MCP 2026-07-28، ويقبل عملاء 2025-11-25 و 2025-06-18 و 2025-03-26. لا يحتفظ بجلسة: كل رسالة JSON-RPC هي POST واحد إلى /mcp، يُجاب بـ JSON — أو، في الأدوات الطويلة، بتدفق أحداث — ثم يُغلق الاتصال. يُجاب GET و DELETE و OPTIONS بـ 405، وتُرفض الدفعات (مصفوفة JSON)، ويُحدّ جسم الطلب بـ 1 MB، ولا يُخدم أكثر من 8 اتصالات في وقت واحد.

عبر chute mcp

العميل الذي لا يشغّل خوادم MCP إلا كبرامج يطلقها بنفسه — أو الذي لا ينبغي أن يحمل ملف إعداداته الرمز — يستخدم أداة سطر الأوامر chute وسيطاً: يمرّر chute mcp كل سطر يقرؤه إلى خادم MCP ويكتب كل رد سطراً.

claude mcp add chute -- chute mcp
{"mcpServers": {"chute": {"command": "chute", "args": ["mcp"]}}}

على Mac يعمل عليه Chute يكفي هذا: يقرأ chute mcp العنوان والرمز من ملف نقطة النهاية مع كل رسالة، فيعثر حتى على Chute بدأ بعد العميل. ويؤخذ الرمز من أول ما يتوفر مما يلي:

  1. --token-file <path>؛
  2. متغير البيئة CHUTE_MCP_TOKEN؛
  3. لخادم على هذا الـ Mac فقط: ملف نقطة النهاية، ثم control-token في مجلد المشاركة.

يوجّهه --url http://<host>:<port>/mcp إلى جهاز آخر. ويسمّي CHUTE_MCP_ENDPOINT ملف نقطة نهاية يُقرأ بدلاً من المعتاد. ويُرفض --token و --token-stdin: فالإدخال القياسي هو قناة MCP نفسها، والرمز على سطر الأوامر ينتهي في إعدادات العميل وقائمة العمليات. وحين يتعذّر الوصول إلى الخادم يتلقى الوكيل خطأً يذكر السبب — المنفذ المغلق يشير إلى external-mcp-server، و 401 إلى الرمز.

من حاسوب إلى iPhone أو Apple TV

  1. على الجهاز، استمع على الشبكة واضبط سراً:

    [General]
    external-mcp-server = 0.0.0.0:6180
    external-http-secret = a-long-random-secret
    

    على iOS هذا هو Allow Access From Wi-Fi وصف Secret؛ وعلى tvOS هو Listen Address بقيمة 0.0.0.0 والسر، في الصفحة نفسها.

  2. صِل الـ VPN، ثم اقرأ العنوان تحت Other Devices (iOS) أو LAN Address (tvOS) — مثلاً http://192.168.1.20:6180/mcp.
  3. على الحاسوب، في الشبكة نفسها:

    claude mcp add --transport http chute-phone http://192.168.1.20:6180/mcp --header "Authorization: Bearer a-long-random-secret"
    

    أو، مع حفظ السر في ملف:

    chute mcp --url http://192.168.1.20:6180/mcp --token-file ~/.config/chute/phone.token
    

العنوان هو عنوان الجهاز على الشبكة، فيتغيّر حين تعطيه الشبكة عنواناً آخر.

ملف نقطة النهاية

ما دام خادم MCP يستمع يكتب المحرك الملف mcp-endpoint في مجلد المشاركة، مقروءاً لمالكه وحده، ويحذفه حين يتوقف الخادم. وهو كائن JSON قيمه كلها نصوص: running و configured و url و lan_url (خارج الاسترجاع) و bind و port و loopback و token و anonymous و mask_secrets — أي ما تعرضه التطبيقات. على Mac يقع في ~/Library/Application Support/com.R3Studio.Chute-Mac/Share/mcp-endpoint (انظر مواقع الملفات)، ولهذا لا يحتاج العميل المحلي إلى منفذ ولا رمز. أما على iPhone و Apple TV فيبقى داخل حاوية التطبيق: خذ العنوان من التطبيق.

إخفاء الأسرار

ما يقرؤه الوكيل يذهب إلى مزوّد نموذجه. لذا لا تصل إليه أسرار الإعدادات افتراضياً: يُستبدل كل سر، أينما ظهر — في الإعدادات وفي أي نتيجة أخرى، والسجل منها — بمقبض مثل <secret:password:3f9c0a1b2e>، أي نوعه ومعرّف. وتبقى عناوين الخوادم ظاهرة، فيعرف الوكيل إلى أي خادم تشير العقدة أو التنزيل.

[Proxy]
HK-01 = trojan, hk.example.com, 443, password=<secret:password:3f9c0a1b2e>, sni=hk.example.com

[Proxy Group]
Sub = select, policy-path=https://sub.example.com<secret:url_secret:8d2e4f6a1c>

ما يُخفى: كلمات مرور الوكلاء، و UUID، والمفاتيح المشتركة مسبقاً، والمفاتيح الخاصة، وكلمات مرور obfs و shadow-tls، والرموز مثل رمز MASQUE — بما فيها ما في أقسام WireGuard و AmneziaWG وعُقد مزوّدي الوكلاء؛ وكلمات مرور http-auth و external-http-secret وكلمة مرور external-controller-access؛ و ca-p12 و ca-passphrase؛ ومفتاح مصادقة Tailscale؛ و argument= الخاص بالسكربت؛ والمسار والاستعلام وجزء المستخدم في روابط الاشتراكات و policy-path ومجموعات القواعد والوحدات و #!MANAGED-CONFIG (يبقى المخطط والمضيف والمنفذ)؛ وقيم ترويسات [Header Rewrite] المسماة Authorization أو Proxy-Authorization أو التي يحتوي اسمها على token أو key أو secret أو auth أو password أو cookie. السر الأقصر من 8 أحرف يُستبدل حيث يقف قيمةً لحقل، لكن لا يُستبدل في النص الحر كسطر السجل، حيث لا يمكن تمييزه عن كلمة عادية.

إعادة الكتابة. حين يعيد الوكيل كتابة نص الإعدادات يعود المقبض المتروك كما هو إلى القيمة التي يمثلها، فيستطيع الوكيل تغيير منفذ عقدة أو اسمها أو إعادة ترتيب قسم دون معرفة كلمة مرورها. ويجوز أيضاً نقل المقبض أو نسخه، بقيدين:

  • لا يعود إلا إلى حقل من النوع نفسه — مقبض كلمة مرور إلى حقل كلمة مرور؛
  • يجب أن يصل السطر إلى الخادم نفسه الذي جاء منه السر: خادم الوكيل، أو مضيف الرابط، أو مفتاح [General] نفسه.

أما المقبض في غير ذلك — على سطر لخادم آخر، أو في قاعدة، أو مختلَق، أو منتهي الصلاحية (انظر أدناه) — فيُرفض مع رقم السطر والسبب، ولا يُطبَّق شيء: فهذه قيمة عليك أنت كتابتها. والسر الجديد الذي يكتبه الوكيل كاملاً يُقبل كما هو؛ وهو حينها بالطبع في سياق الوكيل بالفعل.

تحصل القيمة نفسها دائماً على المقبض نفسه، فيرى الوكيل أن عقدتين تتشاركان كلمة مرور. ويبقى المقبض صالحاً ما بقيت العملية التي أصدرته — حتى يُغلق Chute Mac، أو حتى ينقطع الـ VPN في Chute iOS أو Chute tvOS؛ بعد ذلك يُرفض، فيعيد الوكيل قراءة الإعدادات.

يشمل الإخفاء أسرار الإعدادات. أما بيانات الاعتماد في حركة مرورك أنت — ملفات تعريف الارتباط لموقع، أو ترويسة Authorization أرسلها تطبيق — فليست أسرار إعدادات ولا تُخفى، وهذا سبب إضافي لعدم تقديمها إلا عند طلبها صراحة (انظر أدناه).

إطفاؤه. external-mcp-mask-secrets = false — أو مفتاح Mask Secrets في التطبيقات — يعطي الوكيل كل سر كما كُتب، ويُخبَر الوكيل بذلك. لا تفعل هذا إلا إذا قبلت أن تدخل بيانات الاعتماد تلك في سياق مزوّد نموذج الوكيل.

محتوى الأطراف الثالثة

ترويسات الطلبات والردود وأجسامها، وأسطر السجل، ومخرجات السكربتات، ونص الوحدة المنزّلة من رابط، كلها كتبها آخرون — موقع، أو تطبيق، أو مشغّل خادم. وقد تحتوي صفحة ويب على نص صيغ ليبدو تعليمات موجّهة إلى الوكيل. لذلك:

  • تعيد الأدوات افتراضياً البيانات الوصفية فقط: المضيفين والروابط والمنافذ والسياسات والقواعد وأسماء العمليات وعدد البايتات والأوقات والحالة؛
  • ولا يأتي المحتوى إلا حين يطلبه الوكيل — get_connection مع include، و get_logs، و run_script، و get_module — ويأتي تحت المفتاح untrusted، الذي يُطلب من الوكيل قراءته بيانات لا تعليمات.

هذا يبقي سياق الوكيل نظيفاً وفاتورة رموزه صغيرة؛ وليس تحكماً في الوصول. فالوكيل الذي يملك الرمز يستطيع استدعاء HTTP Control API مباشرة وقراءة كل شيء.

الأدوات

تُوسم كل أداة بأحد أربعة أنواع، يقرّر العملاء بحسبه ما يسألونك عنه قبل استدعائها.

للقراءة فقط

الأداة ماذا تفعل
get_status هل يعمل المحرك وكيف: وضع الخروج، المفاتيح، TUN، المستمعون، الذاكرة، الاتصالات، كيف انتهى التشغيل السابق
get_network_summary الشبكة التي فيها الجهاز — نوعها واسم Wi-Fi والموجّه — وهل يوقف إعداد SSID تشغيل Chute فيها، وعناوين الجهاز
get_traffic البايتات صعوداً ونزولاً والسرعات الحالية
list_policies المجموعات واختيارها الحالي والعقدة التي تنتهي إليها وزمن استجابتها؛ group لمجموعة واحدة كاملة، و detail لكل الأعضاء
get_policy سطر الإعدادات لسياسة واحدة وما يعرفه المحرك عنها الآن: الخادم، المنفذ، UDP، زمن الاستجابة، وجهتها
list_rules القواعد بترتيب المطابقة ومصدر كل منها؛ filter يضيّقها
match_rule أي قاعدة وسياسة سيأخذها الطلب، قبل تحليل الاسم وبعده، دون إرساله
list_user_rules القواعد المضافة أثناء عمل المحرك
list_connections الاتصالات المفتوحة أو المسجّلة، بيانات وصفية فقط؛ مرشّح حسب المضيف أو العملية أو السياسة أو الفشل
get_connection اتصال واحد؛ ترويساته وأجسامه فقط إن سُمّيت في include
get_logs أسطر سجل المحرك، حسب أدنى مستوى وكلمة مفتاحية
get_events اللحظات البارزة في هذا التشغيل؛ after للجديد منها فقط
list_dns_cache سجلات DNS والخادم الذي أجاب عن كل منها
query_dns يحلّل اسماً عبر محلّلات المحرك نفسه ويذكر أيها أجاب
geoip_lookup البلد و ASN لعنوان أو اسم
get_profile الإعدادات العاملة صفحةً صفحة، مع revision
list_profile_sections أقسام الإعدادات، لكل منها مراجعته وهل يمكن الكتابة فيه
get_profile_section نص قسم واحد ومراجعته
validate_profile يحلّل إعدادات كما تفعل إعادة التحميل، دون تطبيقها
get_log_level مستوى السجل والأقسام المسجَّلة
list_scripts سكربتات generic التي يستطيع run_script تشغيلها
list_rewrites قواعد إعادة الكتابة والاستجابة المحاكاة السارية، وقائمة مضيفي MitM
list_mitm_hosts المضيفون الذين يُفك تشفيرهم
list_modules الوحدات المحمّلة ومعرّفاتها وهل كل منها مفعّل
get_module نص وحدة واحدة
list_external_resources مجموعات القواعد ومزوّدو القواعد ومزوّدو الوكلاء والوحدات الآتية من الخارج: متى حُدّث كل منها، وكم مدخلاً أعطى، وآخر خطأ
get_tailscale عقدة Tailscale: الهوية، عقدة الخروج، DERP، والنظراء مع detail
watch_events يراقب أحداث المحرك من 1 إلى 60 ثانية ويعيدها كلها

الاختبارات

هذه ترسل حركة مرور خاصة بها.

الأداة ماذا تفعل
test_policy طلب HTTPS واحد عبر سياسة، مع رمز الحالة والزمن؛ وللمجموعة كل عضو، يُبلَّغ عنه واحداً واحداً
test_policies عدة سياسات أو كلها، يُبلَّغ عنها واحدة واحدة
ping ICMP، أو زمن فتح اتصال TCP، من الجهاز مباشرة
egress_probe عنوان هذا الجهاز نفسه على شبكته الفعلية
internet_test طلب واحد إلى internet-test-url دون أي وكيل: هل هناك إنترنت أصلاً
run_diagnostics صحة المحرك، واختبار الإنترنت، وعنوان الخروج، واستعلام DNS، خطوة خطوة، ثم تقرير

الأزمنة التي يبلّغ عنها test_policy لأعضاء المجموعة هي رحلات HTTPS ذهاباً وإياباً؛ أما اختبار المجموعة الخاص فيجلب عادة رابط HTTP عادياً، فتختلف الأرقام عن تلك التي تختار المجموعة بها. ويعمل اختبار المجموعة الخاص بعد ذلك ويختار كعادته.

الإعدادات

الأداة ماذا تفعل
set_outbound_mode قاعدة، أو عام، أو مباشر
select_policy عضو في مجموعة select، أو الاختيار العام (GLOBAL)؛ المجموعات التلقائية تختار بنفسها وترفض
set_feature تشغيل MitM أو تسجيل حركة المرور أو إطفاؤهما
set_log_level مستوى السجل والأقسام المسجَّلة، دون إعادة تحميل
edit_user_rules يستبدل قواعد وقت التشغيل أو يضيف إليها أو يمسحها؛ سطر واحد ليس قاعدة يُسقط التغيير كله
add_mitm_host، remove_mitm_host قائمة مضيفي MitM
add_rewrite، remove_rewrite قاعدة إعادة كتابة لرابط أو ترويسة أو جسم، أو قاعدة استجابة محاكاة، مكتوبة كسطر إعداداتها
set_modules_enabled يشغّل الوحدات أو يطفئها
update_external_resource يجلب الآن مجموعة قواعد أو مزوّد قواعد أو مزوّد وكلاء
replace_profile_section يستبدل قسماً من الإعدادات، أو يضيفه، ويعيد التحميل
replace_profile يستبدل الإعدادات كلها ويعيد التحميل

المدمّرة

الأداة ماذا تفعل
reload_profile يتراجع عن تغييرات وقت التشغيل: تعود إعادات الكتابة ومضيفو MitM ومفاتيح الوحدات إلى ما تقوله الإعدادات
kill_connection يغلق اتصالاً مفتوحاً واحداً؛ يرى التطبيق على الطرف الآخر انقطاعه
flush_dns يفرغ ذاكرة DNS المؤقتة، أو سجل اسم واحد
run_script يشغّل أحد سكربتات generic في الإعدادات ويعيد مخرجاته

كيف تجيب الأدوات

  • ملخّص افتراضياً. تعطي أدوات القوائم الحقول الأساسية لكل مدخل؛ و detail: true يعطي كل الحقول، مقابل رموز أكثر.
  • صفحات. تقبل القوائم والنصوص الطويلة offset و limit وتعيد next_offset ما دام هناك المزيد.
  • 256 KB كحد أقصى. النتيجة الأكبر تُقصّ بالمدخلات أو بالأسطر، لا في منتصف أحدها، وتذكر truncated: true مع next_offset للمتابعة — فما يصل دائماً JSON صالح.
  • أخطاء بالكلمات. الأداة التي تفشل تقول السبب بجملة يستطيع الوكيل التصرّف بناءً عليها، لا برمز حالة مجرد.

إلى متى يدوم التغيير

على Chute iOS و Chute tvOS لا يجري أي تغيير إلا في المحرك العامل. لا يُكتب شيء في ملف الإعدادات ولا في إعدادات التطبيق الخاصة، فتعيد إعادة التشغيل ما تقوله تلك، كما مع وحدة تحكم الويب.

على Chute Mac يحتفظ التطبيق بهذه التغييرات كما يحتفظ بالتغييرات نفسها حين تُجرى من قوائمه، فتبقى بعد إعادة التشغيل — سواء أجراها وكيل أم وحدة تحكم الويب أم الأمر chute أم HTTP Control API:

  • وضع الخروج واختيارات السياسات، بما فيها الاختيار العام (set_outbound_mode، select_policy): يتذكرها التطبيق؛
  • MitM وتسجيل حركة المرور (set_feature): تُكتب في ملف الإعدادات الحالي؛
  • الإعدادات نفسها (replace_profile، replace_profile_section): تُكتب في ملف الإعدادات الحالي، ثم تُطبَّق كما يطبّقها حفظ وتطبيق (Save & Apply) في التطبيق.

تقول نتائجها persisted: true، وتخبر الأوصافُ التي يقرؤها الوكيلُ الوكيلَ بذلك مسبقاً. وتُرفض كتابة الإعدادات، ولا يُكتب شيء، في هذه الحالات:

الحالة الرمز ما العمل
في النافذة الرئيسية تعديلات غير محفوظة user_editing احفظها أو تجاهلها في التطبيق أولاً
عُدِّل ملف الإعدادات خارج Chute file_changed أعد تحميله في Chute أولاً
الإعدادات الحالية ليست ملفاً محلياً profile_missing —
التطبيق يعرض مربع حوار needs_user_action أجب عنه ثم أعد المحاولة

والإعدادات التي يرفضها المحرك لا تُكتب في الملف أيضاً. وإن لم يفرغ التطبيق خلال 10 ثوانٍ يتلقى الوكيل host_busy: فقد يسري التغيير مع ذلك، لذا يعيد الوكيل قراءة الحالة قبل أن يحاول من جديد. ومما ينبغي معرفته: يبدّل set_feature الـ MitM أو تسجيل حركة المرور فوراً ويكتب المفتاح في الملف، لكنه لا يعيد تحميل الإعدادات، فيبقى النص والـ revision اللذان يعيدهما get_profile بعد ذلك مباشرة على حالهما القديمة حتى إعادة التحميل التالية.

على كل المنصات، لا يدوم مستوى السجل وإعادات الكتابة ومضيفو MitM ومفاتيح الوحدات وقواعد وقت التشغيل إلا في هذا التشغيل، وإعادة تحميل الإعدادات من التطبيق تتراجع كذلك عن إعادات الكتابة ومضيفي MitM ومفاتيح الوحدات. يتراجع reload_profile عن إعادات الكتابة ومضيفي MitM ومفاتيح الوحدات دون إعادة تحميل؛ ويبقى مستوى السجل ومفتاح اتصالات الشبكة المحلية في التطبيق ووضع الخروج واختيارات السياسات على حالها. وقواعد وقت التشغيل من edit_user_rules تبقى بعد إعادة التحميل وتختفي حين يتوقف المحرك.

تحرير الإعدادات

اطلب من الوكيل تغيير الإعدادات قسماً قسماً: يقرأ get_profile_section قسماً ومراجعته، ويكتبه replace_profile_section مع تلك المراجعة. إن تغيّر القسم في الأثناء رُفضت الكتابة وطُلب من الوكيل إعادة القراءة؛ ولا يعيق تغيير قسم آخر ذلك، فيستطيع وكيلان تحرير قسمين مختلفين. ويعمل زوج الملف الكامل، get_profile و replace_profile، بالطريقة نفسها مع revision الإعدادات، لكن الإعدادات الكبيرة لا تتسع لها إجابة واحدة، ولا يقبل replace_profile أكثر من 1 MB.

  • القسم الذي يحتوي سطر #!include، وكل قسم بعده، والقسم الذي يحتوي #!MANAGED-CONFIG لا يمكن الكتابة فيها بهذه الطريقة.
  • القسم المكتوب يُعاد قراءته من الإعدادات المعاد تحميلها: تُكتب قيم [General] و [MITM] بطريقة Chute ويُعاد ترتيب مفاتيح [WireGuard …]، فقد يختلف النص عمّا أُرسل. وتحمل الإجابة المراجعة الجديدة لاستخدامها لاحقاً.
  • الإعدادات التي يرفضها Chute لا تُطبَّق، ويتلقى الوكيل السبب. وفي الإعدادات المُدارة يستبدل التحديث المُدار التالي التغيير.

تقدّم الأدوات الطويلة

تُبلّغ test_policy على مجموعة و test_policies و run_diagnostics و watch_events أثناء عملها. العميل الذي يطلب التقدّم (progressToken) ويقبل تدفق أحداث يتلقى notifications/progress واحداً لكل عضو أو سياسة أو خطوة أو حدث، ثم النتيجة، ويُغلق التدفق؛ أما العملاء الآخرون فيتلقون النتيجة وحدها حين تنتهي الأداة. تعمل الأداة الطويلة 60 ثانية كحد أقصى ثم تعيد ما لديها، ولا يتدفق أكثر من أربع في وقت واحد. والعميل الذي يغلق التدفق يلغي الاستدعاء؛ أما القياسات المرسلة فتكتمل مع ذلك وتحدّث المجموعة.

الأمان

  • الرمز تحكّم كامل. من يملكه يستطيع قراءة إعداداتك وسجل اتصالاتك وسجلك، وتغيير توجيهك، وتشغيل سكربتاتك — وهو أيضاً رمز HTTP Control API. أبقِه خارج الملفات المشتركة ولقطات الشاشة؛ ولتغييره أعطِ external-http-secret قيمة جديدة.
  • الاستماع على الشبكة يتيح لكل جهاز فيها المحاولة. الاتصال HTTP عادي، فيعبر الرمز الشبكة دون تشفير، ولا تُحظر المحاولات الفاشلة: استخدم external-http-secret طويلاً وعشوائياً، وعلى شبكات تثق بها فقط، وعُد إلى 127.0.0.1 حين تنتهي.
  • run_script يشغّل شيفرة. لا يشغّل إلا سكربتات generic التي تعرّفها الإعدادات، لكن كل ما يفعله السكربت — طلبات، قيم مخزّنة، إشعارات — يحدث حين يطلبه الوكيل. والوكيل المسموح له بكتابة الإعدادات يستطيع أيضاً إضافة سكربت ثم تشغيله؛ اقرأ ما يغيّره.
  • صفحات الويب تبقى خارجاً. الطلب الذي يحمل Origin صفحة ويب غير الخادم نفسه يُرفض بـ 403، ولا تُرسل ترويسات عبر الأصول، فلا يستطيع موقع تزوره الوصول إلى الخادم عبر متصفحك.
S. Smart Rabbit LLC © All Rights Reserved            updated 2026-11-21 15:39:20

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

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

results matching ""

    No results matching ""