وكيل الذكاء الاصطناعي (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 بدأ بعد العميل. ويؤخذ الرمز من أول ما يتوفر مما يلي:
--token-file <path>؛- متغير البيئة
CHUTE_MCP_TOKEN؛ - لخادم على هذا الـ Mac فقط: ملف نقطة النهاية، ثم
control-tokenفي مجلد المشاركة.
يوجّهه --url http://<host>:<port>/mcp إلى جهاز آخر. ويسمّي CHUTE_MCP_ENDPOINT ملف نقطة نهاية يُقرأ بدلاً من المعتاد. ويُرفض --token و --token-stdin: فالإدخال القياسي هو قناة MCP نفسها، والرمز على سطر الأوامر ينتهي في إعدادات العميل وقائمة العمليات. وحين يتعذّر الوصول إلى الخادم يتلقى الوكيل خطأً يذكر السبب — المنفذ المغلق يشير إلى external-mcp-server، و 401 إلى الرمز.
من حاسوب إلى iPhone أو Apple TV
على الجهاز، استمع على الشبكة واضبط سراً:
[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والسر، في الصفحة نفسها.- صِل الـ VPN، ثم اقرأ العنوان تحت Other Devices (iOS) أو LAN Address (tvOS) — مثلاً
http://192.168.1.20:6180/mcp. على الحاسوب، في الشبكة نفسها:
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، ولا تُرسل ترويسات عبر الأصول، فلا يستطيع موقع تزوره الوصول إلى الخادم عبر متصفحك.
هذه الصفحة ترجمة للنسخة الإنجليزية. في حال وجود اختلاف، يُعتمد على النسخة الإنجليزية.
ملاحظة: التطبيق لا يدعم اللغة العربية حاليًا.