خيارات متنوعة

[General]
ipv6 = true
loglevel = notify

skip-proxy = 127.0.0.1, 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12, 100.64.0.0/10, localhost, *.local

tun-excluded-routes = 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12
tun-included-routes = 192.168.1.12/32

خيارات شائعة

تفعيل دعم IPv6 الكامل (الافتراضي: true)

ipv6 = true

وعند ضبطه على false تفقد أجوبة DNS سجلات AAAA وتلميحات IPv6، ولا يجيب مجمّع fake-IP بأي AAAA؛ ويبقى باقي الجواب — سجلات A وأي سجلات أخرى — كما هو.

loglevel (الافتراضي: warning)

loglevel = notify

واحد من none أو fatal أو warning أو notify أو info أو verbose. لا ينصح بتفعيل verbose في الاستخدام اليومي لأن هذا سيبطئ الأداء بشكل كبير.

skip-proxy

skip-proxy = 127.0.0.1, 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12, 100.64.0.0/10, localhost, *.local

في نسختي iOS وtvOS، يُضاف مدخل اسم المضيف إلى قائمة استثناءات البروكسي في النفق، فتُعالَج الاتصالات إليه بواسطة Chute TUN بدلاً من بروكسي Chute؛ أما مدخل عنوان IP أو CIDR فيصير كذلك مساراً مستبعداً من النفق، فتخرج حركة ذلك النطاق من النفق كلياً بدلاً من أن يعالجها Chute TUN. ويفعل Chute Android الشيء نفسه في وضع VPN: فما دام System HTTP Proxy مفعّلاً، تنضم أسماء المضيفين وأحرف البدل * وعناوين IPv4 إلى قائمة استثناءات البروكسي الذي تسلّمه VPN للتطبيقات، وعلى Android 13 وما بعده يصبح كل مدخل عنوان IP أو CIDR مساراً مستبعداً من VPN — والعنوان المفرد مساراً /32 أو /128؛ وتُستبعد مدخلات الاسترجاع (loopback)، لأن حركة الاسترجاع لا تدخل النفق أصلاً. في نسخة macOS، ستطبق هذه الإعدادات على النظام عند تفعيل "Set as System Proxy". وما دام الوضع المحسن مفعّلاً، تبقى مدخلات عناوين IP و CIDR كذلك خارج النفق في أيٍّ من نوعَي الوضع المحسن، كما على iOS — انظر المسارات المستبعدة؛ ومع نوع PacketTunnel تسري الاستثناءات نفسها أيضاً على بروكسي HTTP/HTTPS الذي يحمله النفق ما دام بروكسي النظام مفعّلاً. يستخدم هذا الخيار لإصلاح مشاكل التوافق مع بعض التطبيقات.

  • لتحديد نطاق واحد، أدخل اسم النطاق - على سبيل المثال، apple.com.
  • لتحديد جميع المواقع على نطاق، استخدم نجمة قبل اسم النطاق - على سبيل المثال، *apple.com.
  • لتحديد جزء محدد من نطاق، حدد كل جزء - على سبيل المثال، store.apple.com.
  • لتحديد مضيفين أو شبكات بعناوين IP، أدخل عنوان IP محدد مثل 192.168.2.11 أو نطاق عناوين، مثل 192.168.2.* أو 192.168.2.0/24.

ملاحظة: إذا أدخلت عنوان IP أو نطاق عناوين، ستتمكن فقط من تجاوز البروكسي عند الاتصال بذلك المضيف باستخدام ذلك العنوان، وليس عند الاتصال بالمضيف باسم نطاق يُحلَّل إلى ذلك العنوان.


استماع خادم البروكسي

interface = 127.0.0.1
port = 8118
socks-interface = 127.0.0.1
socks-port = 8119

يتحكم interface / port في عنوان ومنفذ استماع خادم بروكسي HTTP (الافتراضي 127.0.0.1:8118). ويتحكم socks-interface / socks-port في خادم بروكسي SOCKS5 (الافتراضي 127.0.0.1:8119). وعلى iOS و tvOS لا يعمل المستمعان إلا إذا كانا مربوطين بكل الواجهات — عبر allow-wifi-access = true، أو بقيمة 0.0.0.0 لـ interface / socks-interface، أو على iOS بمفتاح Allow LAN Connections في التطبيق — فمع القيمة الافتراضية 127.0.0.1 لا شيء يستمع على هذين المنفذين هناك؛ أما Chute Mac و Chute Android فيشغّلانهما دائماً. وتقديم الجهاز لأجهزة أخرى ميزة من ميزات Chute Pro على كل المنصّات: فبلا ذلك يُتجاهل أي عنوان غير loopback ويبقى الربط على 127.0.0.1، ولذلك لا يبدأ المستمعان إطلاقاً على iOS و tvOS.

إذا كان المنفذ مشغولاً ينتقل الخادم إلى المنفذ التالي فالتالي، فيجرّب حتى 20 منفذاً بدءاً بالمنفذ المضبوط؛ وإن لم يكن أيّ منها متاحاً لا يبدأ ذلك الخادم، ويواصل بقية المحرك العمل. والمنفذ المستخدم فعلاً هو ما تعرضه GET /api/status في http_port و socks_port، وما تظهره صفحة Overview (نظرة عامة) في وحدة تحكم الويب. أما مُرحِّل UDP في خادم SOCKS5 فيرتبط بمنفذ خاص به ولا ينتقل مع مستمع TCP: فبعد انتقال TCP قد يبقى المُرحِّل على المنفذ المضبوط، وقد يكون على منفذ آخر تماماً. ويحمل رد UDP ASSOCIATE دائماً المنفذ الذي يستخدمه المُرحِّل فعلاً، فلا يتأثر العميل الذي يرسل حزم البيانات إلى العنوان الوارد في الرد كما يقتضي RFC 1928.

أعطِ port و socks-port قيمة من 1 إلى 65535: فلا يُتحقق من نطاقهما عند تحميل الإعدادات، ومع قيمة خارج هذا النطاق إما ألا يبدأ الخادم وإما أن ينتهي به الأمر مستمعاً على منفذ آخر. أما إذا كُتب مثل هذا المنفذ عبر http-listen / socks5-listen فهو خطأ في الإعدادات.

بالنسبة إلى طلب http:// غير مشفّر، لا يحمل خادم بروكسي HTTP إلا تبادلاً واحداً في كل اتصال: تخرج كل استجابة مع Connection: close ثم يُغلق الاتصال، فيرسل العميل طلبه التالي على اتصال جديد. أما الطلب المُرسَل بالتتابع خلف الأول فيُسقَط، ويعيد العميل إرساله على الاتصال الجديد. ولذلك لا يمكن أن تكتمل عبره طريقة مصادقة تحتاج إلى عدة جولات على الاتصال نفسه، مثل NTLM أو Negotiate. ولا يتأثر بذلك نفق CONNECT غير المفكوك تشفيره. وتحتفظ ترقية WebSocket باتصالها: فبعد استجابة 101 تمر البيانات في الاتجاهين دون تغيير.

أسماء بديلة للتوافق: يُقبل doh-server و doh-service كاسمين بديلين لـ doh؛ كما يُربط http-listen / socks5-listen (مثل 0.0.0.0:6152 أو [::]:6153 أو رقم منفذ مجرد) بإعدادات الواجهة/المنفذ أعلاه. كما أن مضيف استماع شامل (0.0.0.0 أو :: أو *) يعيّن أيضاً allow-wifi-access = true.


مصادقة البروكسي الوارد

http-auth = username:password

يتطلب من العملاء المصادقة قبل استخدام خوادم بروكسي HTTP و SOCKS5 الخاصة بـ Chute. يمكن تكرار السطر للسماح ببيانات اعتماد متعددة.

يرد بروكسي HTTP على الطلب الذي لا يحمل بيانات اعتماد صالحة — طلباً عادياً كان أو CONNECT — بـ 407 Proxy Authentication Required مع Proxy-Authenticate: Basic realm="KLNEKit"، ثم يغلق الاتصال. ويأخذ خادم SOCKS5 بيانات الاعتماد نفسها عبر مصادقة اسم المستخدم/كلمة المرور في SOCKS5، ويغلق الاتصال الذي لا يعرضها أو يفشل فيها.


تجاوز طلبات النظام

bypass-system = true

عند التفعيل، يُلحق Chute قائمة ثابتة من 18 اسم مضيف تابعاً لـ Apple — الإشعارات الفورية، وبوابة iCloud، وفحص البوابة المقيَّدة، و OCSP وما شابهها — بـ skip-proxy، ويُلحق IP-CIDR,17.0.0.0/8,DIRECT,no-resolve بعد قواعدك، قبل FINAL مباشرةً — فتظل قاعدتك التي تطابق 17.0.0.0/8 أولاً هي الغالبة. ولا توجد مطابقة قائمة على العمليات: فالخيار هو تلك القائمة الثابتة من المضيفين والعناوين، لا مرشِّح على العملية التي أطلقت الطلب.

الافتراضي: true.


IP الحقيقي دائماً

always-real-ip = *.example.com, tracker.example.org

عندما يقدم Chute عناوين IP وهمية لاستعلامات DNS المختطفة (انظر hijack-dns)، تتم الإجابة دائماً على أسماء المضيفين المطابقة لهذه القائمة المفصولة بفواصل بعناوين IP الحقيقية المحللة بدلاً من ذلك. أحرف البدل (wildcards) مدعومة. ويُقرأ always-ip-address (بصيغة Shadowrocket) على أنه هذا المفتاح: فالقيمة المنطقية (true أو yes أو on أو 1) تعني كل المضيفين وتُعاد كتابتها always-real-ip = *؛ وfalse تُسقَط؛ وأي قيمة أخرى تُقرأ قائمة مضيفين. ويُحفظ الإعداد بصيغة always-real-ip.


قراءة ملف hosts الخاص بالنظام

read-etc-hosts = false

يحدّد ما إذا كان ملف hosts الخاص بالنظام يُقرأ إلى جدول [Host]. اضبطه على false لتجاهل ذلك الملف؛ ويسري التغيير عند إعادة التحميل. راجع تعيين DNS المحلي.

الافتراضي: true.


مقاطعة الاتصالات الحالية

interrupt-exist-connections = true

عند التفعيل، يؤدي تغيّر المسار إلى إغلاق الاتصالات الحالية التي أُنشئت في ظل المسار القديم، فتستخدم المسار الجديد فوراً بدلاً من البقاء على القديم حتى تنتهي. وتُحتسب التغييرات التالية:

  • اختيار مجموعة سياسات عضواً آخر — من تلقاء نفسها (URL Test، Fallback، SSID) أو بالاختيار اليدوي. وتُغلَق الاتصالات التي كانت تستخدم العضو الذي تركته. أما مجموعة Load Balance فتوزّع الاتصالات على أعضائها ولا تُحتسب تبديلاً أبداً.
  • تغيير السياسة المختارة للوضع العام، التي تتبعها PROXY المدمجة: تُغلَق الاتصالات التي أرسلها الوضع العام إلى السياسة القديمة، وتلك التي وصلت إليها عبر PROXY.
  • تبديل وضع الخروج بين Rule و Global و Direct: يُغلَق كل اتصال.
  • إعادة تحميل تغيّر خوادم DNS، أو [Host]، أو السياسات أو مجموعات السياسات أو مزودي البروكسي، أو القواعد أو مجموعات القواعد: يُغلَق كل اتصال.

ينطبق هذا على كل مجموعة سياسات يمر بها الاتصال: المجموعة التي تسميها قاعدته، والمجموعة المتداخلة فيها، والمجموعة المنبع لسياسة متسلسلة (underlying-proxy)، والمجموعات الأعضاء في مجموعة الترحيل.

بعد تبديل مجموعة أو تغيير سياسة الوضع العام، يُغلَق كل اتصال متأثر بشكل آمن مع مهلة 3 ثوانٍ قبل الإغلاق القسري؛ أما تبديل الوضع أو إعادة التحميل فيغلقانها فوراً. ولا يُغلق أيٌّ من ذلك تدفق UDP عادياً. والقواعد المضافة عبر /api/rules/user لا يحكمها هذا الخيار: فهي افتراضياً تغلق الاتصالات التي توجّهها إلى مكان آخر، سواء كان مفعّلاً أو معطّلاً.

الافتراضي: false. هذا إعداد عام — يؤثر على جميع مجموعات السياسات.


Network Framework (macOS / iOS / tvOS)

network-framework = true

تفعيل Apple Network.framework للاتصالات الصادرة. يمكن أن يوفر استخدام Network.framework أداء أفضل وتكاملاً حديثاً مع مكدس TLS على المنصات المدعومة.

الافتراضي: true على macOS، false على iOS و tvOS.


استبعاد أسماء المضيفين البسيطة

exclude-simple-hostnames = true

عند التفعيل، تتجاوز الطلبات إلى أسماء المضيفين البسيطة (أسماء ذات تسمية واحدة بدون نقطة، مثال localhost) قواعد البروكسي وتحل محلياً. هذا يساعد في تجنب استعلامات DNS غير الضرورية لأسماء الشبكة المحلية. وهذا هو إعداد "استبعاد أسماء المضيفين البسيطة" الخاص ببروكسي نظام macOS نفسه: يكتبه Chute Mac في إعدادات بروكسي النظام، فيسري على التطبيقات التي تتبع بروكسي النظام دون غيرها — لا على الوضع المحسن ولا على حركة TUN. وعلى iOS و tvOS يُكتب بالطريقة نفسها في إعدادات بروكسي النفق، فيعالج Chute TUN اسم المضيف البسيط بدلاً من بروكسي Chute، كما يُعالَج اسم المضيف المدرج في skip-proxy. أما Chute Android فلا يستخدمه.

على Chute Mac، تُفعّل عملية ترحيل تُنفَّذ مرة واحدة هذا الخيار افتراضياً عند التشغيل الأول؛ ويُحترم إيقافه صراحةً من قبل المستخدم.

الافتراضي: false.


تعطيل سجل قاعدة البيانات

disable-db-record = true

عند التفعيل، يتوقف Chute عن كتابة سجلات حركة المرور إلى قاعدة البيانات المحلية. هذا يمكن أن يحسن الأداء ويقلل استخدام التخزين، لكن سجل حركة المرور لن يكون متاحاً في Chute Dashboard.

الافتراضي: false.


menu-bar-show-speed = true

عند التفعيل، يعرض Chute Mac سرعة الرفع والتنزيل الحالية في شريط القوائم.

يُحلَّل لكنه غير فعّال في المحرك الحالي — فلا شيء في Chute Mac يقرأ هذا المفتاح. وسرعة شريط القوائم تُبدَّل من عنصر القائمة Show Connection Speed، وهو مخزَّن في إعدادات التطبيق نفسه. ويظل المفتاح يُكتب مجدداً عند حفظ الإعدادات.


اختطاف خوادم DNS الأخرى

hijack-dns = 8.8.8.8:53

افتراضياً، يرجع Chute فقط عناوين IP وهمية لاستعلامات DNS المرسلة إلى عنوان DNS الخاص بـ Chute (198.18.0.2). الاستعلامات المرسلة إلى DNS القياسي سيتم توجيهها ببساطة.

بعض الأجهزة أو البرامج تستخدم دائماً خادم DNS مبرمج بشكل ثابت. (على سبيل المثال، Google Speakers تستخدم دائماً 8.8.8.8). يمكنك استخدام هذا الخيار لاختطاف الاستعلام للحصول على عنوان وهمي.

يمكنك استخدام hijack-dns = *:53 لاختطاف جميع استعلامات DNS.

المدخل بلا منفذ يعني المنفذ 53، فـ hijack-dns = 8.8.8.8 هو 8.8.8.8:53. والمدخل الذي يتعذر قراءته يُتخطّى مع إشعار، ويظل باقي السطر نافذاً.

Fake IP متاح على Apple TV أيضاً (tvOS 17 وما بعده). كان معطّلاً هناك، والتحقق على جهاز فعلي لا يزال جارياً.


المسارات المستبعدة

tun-excluded-routes = 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12

يستطيع Chute VIF معالجة بروتوكولات TCP و UDP فقط. استخدم هذا الخيار لتجاوز نطاقات IP محددة للسماح لجميع حركات المرور بالمرور.

ملاحظة: ينطبق هذا الخيار على نفقَي الحزم في iOS و tvOS، حيث تصير النطاقات مسارات مستبعدة من إعدادات IP للنفق، وعلى Chute Android في Android 13 وما بعده، حيث تصير مسارات مستبعدة من الـ VPN — فلا واجهة في Android 11 و 12 للمسارات المستبعدة، ولذا تُتجاهل النطاقات هناك. الطلبات التي يعالجها خادم بروكسي Chute لن تتأثر. ادمج 'skip-proxy' و 'tun-excluded-routes' للتأكد من أن حركة HTTP معينة تتجاوز Chute.

وعلى macOS ينطبق في نوعَي الوضع المحسن كليهما، وما يبقى خارج النفق هو القائمة نفسها التي تُبقيها أنفاق iOS و tvOS خارجه: نطاقات هذا الخيار، ونطاقات bypass-tun، ومدخلات عناوين IP و CIDR في skip-proxy — أما مدخلات أسماء المضيفين فليست مسارات ولا دور لها. في نوع PacketTunnel تصير النطاقات مسارات مستبعدة من إعدادات IP للنفق، كما على iOS. وفي نوع Helper utun يُخرج المساعد هذه النطاقات من المسارات التي يوجّهها إلى utun، فتسلك الحركة إليها مسارات النظام المعتادة؛ ولا يوجّه المساعد من IPv6 إلى utun إلا 2000::/3، فلا يغيّر شيئاً هناك إلا نطاقات IPv6 الواقعة داخل 2000::/3. ولا أهمية لنطاقات IPv6 إلا حين يحمل النفق IPv6 (ipv6 = true). ويُتخطّى، مع ذكر ذلك في السجل، المدخلُ الذي طول بادئته 0 (0.0.0.0/0 و ::/0) والمدخلُ الذي يتداخل مع عناوين الاسترجاع (127.0.0.0/8 و ::1) أو مع الشبكتين الفرعيتين الخاصتين بالنفق (198.18.0.0/15 و fd12:1:1:1::/64) — ولذا فإن 127.0.0.1 الذي تحويه skip-proxy عادةً يُتخطّى ببساطة. ويبقى مدخل tun-included-routes الأدقّ من نطاق مستبعد هو الفائز، لأن المسارات تُختار بطول البادئة. ويسري تغيير القائمة عند إعادة تحميل الإعدادات.

قد يتسبب هذا الخيار في خطأ نظام ENOMEM (Cannot allocate memory). يبدو أنه خطأ في نظام iOS. يرجى عدم استخدام هذا الخيار إذا أمكن.


المسارات المضمنة

tun-included-routes = 192.168.1.12/32

افتراضياً، ستعلن واجهة Chute VIF عن نفسها كمسار افتراضي. لكن نظراً لأن واجهة Wi-Fi لديها مسار أصغر، قد لا تمر بعض حركات المرور عبر واجهة Chute VIF. استخدم هذا الخيار لإضافة مسار أصغر.

وسبب عدم كفاية المسار الافتراضي وحده: النظام يختار المسار بطول البادئة، لا بالترتيب. فالشبكة الفرعية المباشرة للواجهة الفيزيائية — 192.168.1.0/24 مثلاً — أدقّ من 0.0.0.0/0 الخاص بالنفق، فلا تصل تلك الحركة إلى Chute أبداً. والمدخل هنا يثبّت مساراً أدقّ منها فيفوز. وتُضاف هذه المسارات فوق المسار الافتراضي ولا تضيّق أبداً ما يلتقطه النفق.

ملاحظة: تجنّب إدراج النطاقات الخاصة (10.0.0.0/8 و 172.16.0.0/12 و 192.168.0.0/16) بكاملها. فذلك غير ضروري عادةً وقد يربك توجيه النظام نفسه؛ ويحترم Chute مدخلاً كهذا لكنه يسجّل تحذيراً — إلا في نوع Network Extension من الوضع المحسن على macOS، الذي يحترمه دون تحذير. والسبب المعتاد لاستخدام هذا الخيار هو الوصول إلى نطاق يملكه نفق تطبيق VPN آخر.

ملاحظة: يُرفض المدخل الذي يقطع الغصن الذي يجلس عليه Chute، ويُذكر السبب في السجل: العنوان الاسترجاعي، والشبكتان الفرعيتان الخاصتان بـ VIF (198.18.0.0/15 و fd12:1:1:1::/64)، والعناوين المحلية للوصلة، والبث المتعدد، والبث العام، وطول بادئة يساوي 0. ويرفض نوع helper-utun من الوضع المحسن على macOS كذلك المدخل الذي يغطي البوابة الافتراضية الحالية. وفي نوع Network Extension يُكتب السبب في سجل النظام لا في سجل Chute.

ملاحظة: على iPhone يقرر النظام التقاط الشبكة المحلية على حدة. فالشبكة الفرعية المحلية المدرجة هنا لا تُحترم إلا إذا كان تضمين الشبكات المحلية (Include Local Networks) مفعّلاً أيضاً في إعدادات التطبيق — وهو مفتاح لا يمكن تفعيله إلا ما دام تضمين كل الشبكات (Include All Networks) مفعّلاً؛ أما النطاق الذي يملكه نفق تطبيق آخر فلا يحتاج إلى ذلك المفتاح. ويعرض Chute tvOS المفاتيح نفسها لكنه لا يطبّقها على النفق. وعلى macOS تُثبَّت المسارات مباشرةً فلا ينطبق هذا القيد.

ملاحظة: على macOS يثبّت نوع helper-utun من الوضع المحسن هذه المسارات عند إرفاق الواجهة، فتغيير القائمة يعيد إرفاق الواجهة عند إعادة التحميل. ويتطلب هذا الخيار إصدار المساعد 0.8.6 أو أحدث — بعد تحديث Chute وافق على طلب إعادة تثبيت المساعد مرة واحدة، وإلا أبلغ نوع helper-utun أن المساعد لا يعمل.


استكشاف البروتوكول

sniffing-enabled = true
sniffing-timeout = 100

يستطيع Chute اكتشاف البروتوكول الفعلي للاتصال عن طريق فحص البايتات الأولية. هذا يمكن قواعد مثل PROTOCOL,TLS,Proxy من العمل بشكل صحيح حتى للاتصالات الواردة غير HTTP.

sniffing-enabled (الافتراضي: false)

sniffing-enabled = true

تفعيل اكتشاف البروتوكول لاتصالات TCP. وفي الوضع المحسن يتيح المفتاح نفسه مطابقة تدفق HTTP/3 (QUIC) الموجّه إلى عنوان IP مجرد بالاسم: يقرأ Chute اسم الخادم من ClientHello الخاص بـ QUIC، فترى قواعد DOMAIN ذلك الاسم بدل العنوان، وتتبع كل الحزم اللاحقة في التدفق حكم الحزمة الأولى. أما ClientHello الأكبر من أن تسعه حزمة واحدة — وهو شائع مع تبادل مفاتيح ما بعد الكم — فيُعاد تجميعه لكل تدفق من حزم Initial التي تحمله، بحد أقصى 16 كيبيبايت للـ hello المُجمَّع، فيُقرأ اسمه أيضاً. وبينما لم يصل باقي الـ hello بعد، تُحتجز مخططات بيانات التدفق بدل إرسالها بعنوانها المجرد، ثم تخرج معاً وفق سياسة الاسم بمجرد قراءته — فلم يعد الجزء الأول من hello مقسّم يسلك طريقاً مختلفاً عن بقيته. والحدود الاحتياطية هي: انتظار ثانية واحدة، وثماني مخططات بيانات أو 16 كيبيبايت محتجزة لكل تدفق، و64 تدفقاً قيد التجميع في آن واحد؛ والتدفق الذي يتجاوز أياً منها، أو الذي لا تكتمل ClientHello من حزم Initial الخاصة به أبداً، يُطابَق بالعنوان كما في السابق.

في الاتصال بعنوان حقيقي ترى القواعد الاسم الذي يعلنه العميل نفسه (TLS SNI أو HTTP Host)، حتى إن كانت ذاكرة DNS المؤقتة في Chute تحتفظ باسم لذلك العنوان: فالذاكرة المؤقتة تحفظ اسماً واحداً لكل عنوان، هو آخر اسم حُلّ إليه، وقد يكون خلف العنوان المشترك اسم موقع آخر. ويُستخدم الاسم المحفوظ عندما يتعذر قراءة اسم من الاتصال. والطلب المكتوب لبروكسي HTTP (CONNECT أو طلب هدفه عنوان URL كامل) يظل يُكتشف على أنه HTTP، لكن المضيف المذكور فيه هو الوجهة التالية لذلك البروكسي وليس اسم هذا الاتصال؛ فيحتفظ الاتصال بالاسم المحفوظ في الذاكرة المؤقتة أو بالعنوان. والبروتوكول الذي يبدأ فيه الخادم بالإرسال لا يقدّم اسماً يُقرأ: فالاتصالات إلى المنافذ 21 و22 و23 و25 و110 و119 و143 و587 و2222 و2525 و3306 و5900 لا يجري عليها الاكتشاف وتُوصَل فوراً، وعلى أي منفذ آخر ينتظر مثل هذا البروتوكول انقضاء sniffing-timeout قبل أن يُوصَل.

sniffing-timeout (الافتراضي: 100ms)

sniffing-timeout = 200

الحد الأقصى للوقت بالمللي ثانية لانتظار البيانات الأولية لتحديد البروتوكول. قم بزيادة هذه القيمة إذا فشل اكتشاف البروتوكول على الاتصالات البطيئة.


حظر QUIC

block-quic = auto

يتحكم هذا الخيار في ما إذا كان Chute سيرفض حركة مرور QUIC المكتشفة، بما في ذلك HTTP/3. يعمل QUIC عبر UDP ولا يمكن فك تشفيره بواسطة HTTP MitM في Chute. قد يدفع رفض QUIC العملاء المتوافقين إلى إعادة المحاولة عبر TCP، مما يتيح معالجة البروكسي المعتمدة على TCP وفك تشفير HTTPS عند تفعيله.

القيمة السلوك
off عدم تطبيق حظر عام على QUIC (الافتراضي). تتبع حركة QUIC المكتشفة قواعد التوجيه العادية.
on رفض كل تدفق QUIC مكتشف، بما في ذلك حركة المرور الموجهة إلى DIRECT.
auto رفض QUIC المكتشف فقط عندما تكون سياسة الخروج النهائية بروكسي. يُسمح بحركة المرور الموجهة إلى DIRECT، وتظل حركة المرور الموجهة إلى REJECT مرفوضة وفقاً لتلك القاعدة.
all تهجئة Surge للقيمة on.
all-proxy، per-policy تهجئتا Surge، وتُقرأ كلتاهما على أنهما auto — فليس في Chute حظر QUIC لكل سياسة على حدة، لذا يحظر per-policy كل تدفق QUIC يمر عبر بروكسي. وتُحفظ الكلمة التي كتبتها كما هي عند حفظ الملف.

بالنسبة إلى حركة المرور الداخلة عبر TUN، يرد Chute على تدفق QUIC المرفوض برسالة ICMP/ICMPv6 Port Unreachable، مما يسمح للعملاء المتوافقين بالعودة إلى TCP دون انتظار انتهاء مهلة QUIC.

يُسجَّل تدفق QUIC المرفوض بسياسة REJECT، أياً كانت السياسة التي اختارتها القاعدة.

يتم اكتشاف QUIC الخاص بـ block-quic تلقائياً ولا يتطلب sniffing-enabled؛ إذ يتحكم sniffing-enabled في اكتشاف البروتوكولات — TLS على TCP، واسم الخادم في تدفق QUIC. استخدم قاعدة PROTOCOL,QUIC,... عند الحاجة إلى معالجة تدفقات QUIC منفردة بواسطة القواعد.


الرد على ICMP داخل النفق

icmp-auto-reply = false

يرد Chute بنفسه على أي طلب ICMP echo يدخل النفق — IPv4 أو IPv6 —: يُولَّد الرد محلياً ولا يُرسَل شيء إلى الوجهة. لذلك تجيب كل وجهة، بما فيها عنوان تُسقطه قاعدة REJECT أو مضيف متوقف، فنجاح ping داخل النفق لا يدل على أن الوجهة قابلة للوصول. اضبطه على false لإيقاف الرد: عندها يُمرَّر الطلب خارج الجهاز، لكن رده لا يعود أبداً عبر النفق، فلا يُجاب ping أبداً.

الافتراضي: true. ينطبق على الحركة الواردة عبر TUN؛ ولا يُمرَّر ICMP عبر بروكسي أبداً.


تجاوز TUN

bypass-tun = 192.168.0.0/16, 10.0.0.0/8

مشابه لـ skip-proxy، لكنه يعمل على مستوى توجيه TUN/VIF. الاتصالات إلى نطاقات IP هذه ستتجاوز واجهة TUN بالكامل وتذهب عبر مكدس شبكة النظام مباشرة.

ملاحظة: ينطبق هذا الخيار على نفقَي الحزم في iOS و tvOS، حيث تنضم نطاقاته إلى tun-excluded-routes بوصفها مسارات مستبعدة من النفق، وبالطريقة نفسها على Chute Android في Android 13 وما بعده (ويتجاهله Android 11 و 12). وعلى macOS تنضم نطاقاته إلى tun-excluded-routes في نوعَي الوضع المحسن كليهما — انظر المسارات المستبعدة.


عرض صفحة خطأ للرفض

show-error-page-for-reject = true

عند التفعيل، يرجع Chute صفحة خطأ سهلة الاستخدام للطلبات المرفوضة. وهذا لا ينطبق إلا على الطلب الوارد عبر مدخل بروكسي HTTP؛ ومع إطفاء الخيار يُجاب هذا الطلب بـ HTTP/1.1 503 Service Unavailable بدلاً من ذلك. أما الطلب المرفوض من أي مدخل آخر فيُسقَط في الحالتين.

الافتراضي: false.


DNS المتفائل

optimistic-dns = false

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

الافتراضي: true. عيّن optimistic-dns = false للتعطيل.


السماح بالوصول عبر Wi-Fi PRO

allow-wifi-access = true

يسمح للأجهزة الأخرى على الشبكة نفسها بالوصول إلى منفذَي بروكسي HTTP و SOCKS5 في Chute، عبر توسيع عنوان الربط للمستمعَين إلى 0.0.0.0. إعدادات نمط Surge — وكذلك تحويل allow-lan عند الاستيراد من sing-box — تحمل هذا الخيار وحده وتترك interface على قيمته الافتراضية 127.0.0.1، ولهذا يجب أن يوسّع الخيار عنوان الربط بنفسه. وهذه ميزة من Chute Pro: فبلاها يُتجاهل الخيار وinterface بحرف بدل، ويبقى المستمعان على 127.0.0.1، ولذلك لا يبدآن على iOS و tvOS.

وللتطبيقات أيضاً مفتاح لهذا، Allow LAN Connections: على Chute Mac في قائمة شريط القوائم (LAN Connections في لوحة شريط القوائم)، وفي لوحة التحكم على Chute iOS و Chute Android؛ ولا يوجد على Chute tvOS. يبدأ بالحالة التي يطلبها الإعداد، وينقل المستمعَين كليهما إلى كل الواجهات أو يعيدهما إلى 127.0.0.1 للتشغيل الحالي فقط؛ وعلى iOS، حيث لا يعمل المستمعان إلا على كل الواجهات، يشغّلهما ويوقفهما أيضاً. ولا يُكتب شيء في الإعدادات: فالتشغيل التالي، أو إعادة التحميل المقبولة، يعود إلى ما تقوله الإعدادات. ويحتاج تشغيله إلى Chute Pro، أما إيقافه فلا.

هذا الخيار وكتابة interface بحرف بدل صريح طريقتان للتعبير عن النية نفسها، و Chute يأخذ الاتحاد بينهما: الإعداد الذي يكتب 0.0.0.0 أصلاً لا يتغيّر سلوكه. تغيير الخيار يعيد ربط المستمعَين، لذا يسري سحب الوصول عند إعادة التحميل لا عند التشغيل التالي.

هذه منافذ البروكسي، ولا تملك أي مصادقة ما لم تضبط http-auth. على شبكة لا تتحكم بها، اضبط بيانات الاعتماد أيضاً.


الإعدادات المدارة

#!MANAGED-CONFIG https://example.com/config.conf interval=86400 strict=false

الإعداد الذي يبدأ سطره الأول بترويسة #!MANAGED-CONFIG يُعاد جلبه تلقائياً من عنوان URL. معلمات الترويسة وسلوك التحديث موثقة في الإعدادات المدارة.


Replica / تسجيل حركة المرور PRO

replica = true

مفتاح replica في [General] (replica = true) يفعّل تسجيل حركة المرور؛ بينما يتولى قسم [Replica] تصفية ما يعرضه Chute Dashboard، ومفاتيحه موثقة في النسخ المتماثل.

يلزم كذلك ترخيص Chute Pro فعّال على كل المنصّات: فبدونه لا يلتقط replica = true شيئاً، ولا يمكن قراءة أجسام خلّفها تشغيل مرخّص سابق.


الوصول إلى المتحكم الخارجي (Chute Dashboard)

external-controller-access = password@0.0.0.0:6155

يبدأ خادم التحكم عن بعد المستخدم بواسطة Chute Dashboard. القيمة هي password@host:port؛ ويمكن اختيارياً أن يسبق كلمة المرور اسم مستخدم (user:password@host:port). على iOS و tvOS، تفتح قناة USB مرافقة على port + 1 (وليس على macOS). طريقة الاتصال موصوفة في صفحة Chute Dashboard.


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

نُقل هذا المحتوى إلى صفحة مستقلة: HTTP Control API ووحدة تحكم الويب.


رابط اختبار البروكسي

[General]
proxy-test-url = http://cp.cloudflare.com/generate_204
test-timeout = 3

proxy-test-url هو رابط الاختبار لكل مجموعة url-test و fallback و load-balance لا تضبط url خاصاً بها، و test-timeout (بالثواني) هو المهلة لكل مجموعة من هذا النوع بلا timeout. تواصل المجموعات اتباع هذين المفتاحين بعد حفظ الإعدادات، ولا يتجاوزهما إلا url أو timeout مكتوب في سطر المجموعة. قيمة proxy-test-url غير الصالحة خطأ في الإعدادات. تستخدم وحدة تحكم الويب قيمة internet-test-url لاختبار الإنترنت المباشر، ويجلبها من دون بروكسي؛ وإذا لم تُضبط، يستخدم المحرك رابط نجاح مدمجاً.


UDP عبر سياسة لا تدعم UDP

udp-policy-not-supported-behaviour = DIRECT

ما يحدث لحزمة UDP عندما لا تستطيع سياستها تمرير UDP، مثل بروكسي HTTP عادي: REJECT (الافتراضي) يُسقطها، و DIRECT يرسلها مباشرة بدلاً من ذلك. ويُقرَّر block-quic قبل ذلك، بناءً على السياسة التي اختارتها القاعدة: مع block-quic = auto يُرفض QUIC المتجه إلى بروكسي لا يستطيع تمرير UDP بدلاً من إرساله مباشرة. أما بقية حركة UDP فتعود إلى DIRECT كما من قبل. ويُعامل بالطريقة نفسها UDP الخاص بـسياسة مُسلسلة لا يستطيع المرور عبر منبعها، وكذلك خادم DoQ أو DoH3 أعلى يتبع وضع الخروج إلى سياسة لا تحمل UDP: REJECT يتخطى ذلك الخادم، و DIRECT يستعلم منه مباشرة.


البروكسي الأمامي

[General]
global-underlying-proxy = Airport

يرسل كل سياسة بروكسي ليس لها underlying-proxy خاص بها عبر السياسة أو المجموعة المسمّاة — وهو ما يسمّيه Shadowrocket البروكسي الأمامي (前置代理) ولا يُضبط فيه إلا من التطبيق. وتدخل في ذلك سياسات مزودي البروكسي. وتُترك كما هي: كل سياسة قد يمر بها اتصال عبر السياسة الأمامية نفسها — أعضاؤها ومنابعهم وقفزات أي ترحيل بينها — كي لا تمر السياسة الأمامية عبر نفسها أبداً؛ والسياسة التي تكتب underlying-proxy=DIRECT، أي تنسحب منه؛ ومجموعات السياسات، إذ يقرر أعضاؤها؛ وDIRECT وREJECT وTAILSCALE. احذف المفتاح، أو اكتب DIRECT، لإيقافه. واسمٌ غير معرّف يجعل كل سياسة كان سيشملها تُرفض بدلاً من أن تتصل مباشرة.

يُقرأ close-if-proxy-chain-missing (Shadowrocket) ويُكتب مجدداً عند حفظ ملف الإعدادات. يتصرف Chute دائماً كما تفعل قيمته true: تُرفض السياسة المُسلسلة التي فُقد منبعها. أما false — القيمة الافتراضية في Shadowrocket، التي تتخطى القفزة المفقودة وتتصل بالعقدة مباشرة — فلا تُتّبع، ويُنبَّه إلى ذلك مرة واحدة.


بصمة العميل

global-client-fingerprint = chrome

يحدد بصمة عميل TLS لكل سياسة لا تحمل fingerprint خاصة بها، بما في ذلك السياسات التي يقدمها مزود البروكسي. قيمة السياسة نفسها هي الغالبة دائماً، لذا هذا افتراضي وليس تجاوزاً.

القيم المدعومة هي chrome و firefox و safari و ios، بالإضافة إلى edge و 360 و qq و android و random التي تُعامل جميعها كـ Chrome، والأسماء الأخرى المذكورة تحت fingerprint. القيمة غير المعروفة تُتجاهل مع التحذير Ignoring unsupported global-client-fingerprint '<value>' ويُستخدم مكدس TLS الخاص بالمنصة.

الافتراضي: فارغ، أي مكدس TLS الخاص بالمنصة. تقرأه سياسات ShadowTLS وAnyTLS دائماً، وسياسات Trojan وVMess وVLESS التي تضبط tls=true أو reality=true، وسياسات Shadowsocks التي تضبط ws=true وtls=true معاً أو تضبط shadow-tls-password؛ والسياسة التي تستخدم نقل gRPC من دون REALITY تحتاج إلى كتابة tls=true أيضاً. ولا تقرأه سياسات ShadowsocksR.

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

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

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

results matching ""

    No results matching ""