بدء الاستخدام على Android

يعمل Chute Android بالمحرك نفسه الموجود في الإصدارات الأخرى، منقولاً إلى Kotlin، ويقرأ ملف الإعدادات نفسه. تشرح هذه الصفحة التشغيل الأول؛ صفحة بدء الاستخدام تحوي المقابل لـ iOS و macOS و tvOS، والإعداد الأدنى الموجود هناك يعمل على Android دون تغيير.

1. الحصول على ملف إعدادات

عند التشغيل الأول دون أي إعدادات، يفتح Chute معالج إعداد ("Let's set up your first proxy configuration") بثلاثة مسارات: رابط اشتراك من مزوّدك، أو رمز QR، أو بيانات خادمك الخاصة تليها المواقع المراد تمريرها عبر البروكسي واختيار DNS. وخطوته الأخيرة، إنشاء واتصال (Create and Connect)، تحفظ الإعداد وتحدده وتبدأ النفق. ويُغلق تخطٍّ (Skip) المعالج؛ وما دام لا يوجد أي إعداد بعد، يُفتح من جديد في المرة التالية التي يُشغَّل فيها Chute، لا عند تدوير الشاشة أو العودة إلى التطبيق. ويعيد إظهار التعريف (Show Onboarding) في الإعدادات فتح المعالج.

يجب أن يكون رابط الاشتراك عنوان https://. والملف الأصلي الذي ينزّله المعالج — من ذلك الرابط، أو من عنوان يحمله رمز QR — يُحفظ إعداداً مُداراً يُحدَّث كل 86400 ثانية، وهي القيمة الافتراضية لـ إضافة اشتراك (Add Subscription) أدناه. وملف Clash أو sing-box، سواء جاء من الاشتراك أو من رمز QR، يُحوَّل إلى لقطة ثابتة لا تُحدَّث، كما في صفحة الإعدادات (Configurations). ويُقرأ رمز QR كما تقرؤه تلك الصفحة: رابط chute://download (أو import أو install-config أو subscribe) هو العنوان المراد تنزيله، ويمكن أن يحمل الرمز إعداداً كاملاً، ورمز chute://tv أو chute://remote يفتح مربع حوار المستودع البعيد في الشاشة الرئيسية.

لإضافة ملف إعدادات لاحقاً، اضغط شريط الإعدادات (Config) في الشاشة الرئيسية لفتح صفحة الإعدادات (Configurations)، ثم إضافة إعداد من... (Add Configuration From...):

• إعداد فارغ (Blank Configuration) — يحفظ قالباً باسم Untitled.conf دون فتح المحرر؛ افتحه بـ تحرير منظَّم (Edit Structured) أو تحرير النص (Edit Text) من قائمة ⋮ في صفّه.
• إضافة اشتراك (Add Subscription) — ينزّل من رابط المزود ويحتفظ به كـإعداد مُدار يُحدَّث بالفاصل الذي تكتبه في مربع الحوار (86400 ثانية افتراضياً). أما اشتراك Clash أو sing-box فيُحوَّل أثناء الاستيراد ويُخزَّن لقطةً ساكنة بلا ترويسة تحديث، فلا يحدّث نفسه.
• استيراد من ملف محلي (Import from Local File) — يستورد ملف Chute (.conf) أو sing-box (.json) أو Clash/mihomo (.yaml)؛ الصيغ غير الأصلية تُحوَّل.
• تنزيل من رابط (Download From URL)، تنزيل من رمز QR (Download From QR Code)، رفع ملف عبر Wi-Fi (Upload File Via Wi-Fi) — طرق أخرى للشيء نفسه. تعرض صفحة الرفع عبر Wi-Fi العناوين التي تفتحها في متصفح على الشبكة نفسها، محمية برمز PIN.
• خادم بعيد (Remote Server) — يحمّل إعداداً من مستودع إعدادات بعيد.

رابط chute://download?url=... المفتوح من خارج التطبيق — بالنقر عليه أو بمسحه بالكاميرا — ينزّل الملف هو الآخر، وملف Clash أو sing-box يُحوَّل إلى لقطة ثابتة كما في صفحة الإعدادات (Configurations)، لكن الرابط لا يضيف اشتراكاً: فـ chute://subscribe?url=... ليس إلا اسماً مستعاراً لـ download. والملف الأصلي الذي يحفظه رابط كهذا لا يحدّثه التطبيق أبداً، وإن كان المحرك العامل يعيد جلب رابطه كل 24 ساعة ويطبّق المحتوى الجديد في الذاكرة — انظر مخطط الرابط. أما إذا مُسح الرابط نفسه في معالج الإعداد وكان يشير إلى ملف أصلي، فيعطي إعداداً مُداراً يحدّثه التطبيق كل 86400 ثانية.

بدون ترخيص يحتفظ Chute بملف إعدادات محلي واحد؛ وإضافة ملف إعدادات ثانٍ عبر أي قناة من ميزات Chute Pro — انظر الترخيص والتفعيل.

2. اختياره

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

3. البدء والموافقة

اضغط المفتاح (Tap to start VPN). في أول بدء يطلب Android السماح بطلب اتصال VPN — وهي موافقة النظام التي يحتاجها كل تطبيق VPN؛ رفضها يترك Chute متوقفاً. إعدادان يحددان ما يحمله النفق:

• وضع الخدمة (Service Mode) — VPN (الافتراضي) يلتقط حركة الجهاز عبر VPN النظام؛ بروكسي محلي (Local Proxy) يشغّل مستمعي HTTP و SOCKS5 فقط لتشير إليهما تطبيقات أو أجهزة أخرى، دون نفق.
• وضع بروكسي التطبيقات (Application Proxy Mode) — عام (Global) يمرر كل التطبيقات، بروكسي (Proxy) التطبيقات المحددة فقط، قائمة سوداء (Blacklist) كل التطبيقات عدا المحددة.

مفاتيح ذات صلة في الإعدادات: البدء عند الإقلاع (Start on Boot) (يتطلب موافقة VPN مرة)، التقييد بـ Wi-Fi (Restrict to Wi-Fi) (في وضع VPN فقط: يوقف النفق مؤقتاً عندما تكون الشبكة الأساسية محسوبة بالاستهلاك (metered) ويستأنفه عندما لا تكون كذلك — فهذا ما يبلّغ عنه Android، لا وسيلة النقل، ولذلك يتوقف النفق أيضاً على شبكة Wi-Fi محسوبة بالاستهلاك ولا يتوقف على باقة خلوية غير محسوبة)، وVPN دائم التشغيل (Always-on VPN) الذي يفتح قائمة VPN في Android، لأن صفحة التشغيل الدائم نفسها ليست وجهة عامة؛ فعّل VPN دائم التشغيل لـ Chute من هناك. ومن خارج التطبيق، تبدأ النفقَ وتوقفه اختصاراتُ الشاشة الرئيسية بدء (Start) وإيقاف (Stop) وتبديل (Toggle) وBroadcast Intents وإضافة Tasker/Locale، وكذلك مربّع الإعدادات السريعة — ما لم يحوّلها خيار الإجراءات السريعة (Quick Actions) في الإعدادات من VPN إلى وضع (Mode) (تدوير وضع الخروج) أو مجموعة (Group) (تدوير مجموعة السياسات المختارة تحت مجموعة الأداة (Widget Group)، التي لا تُدرج المجموعات الموسومة بـ hidden=true إلا المجموعة المختارة فيها من قبل). وتعرض أداة الشاشة الرئيسية ما إذا كان النفق يعمل وسياسة تلك المجموعة؛ والنقر عليها ينقل المجموعة إلى سياستها التالية.

مع تفعيل VPN دائم التشغيل يبدأ Android النفق بنفسه — عند تفعيل الإعداد، وعند الإقلاع، وبعد تحديث Chute — بالإعداد المحدد، ودائماً بوصفه VPN حتى لو كان وضع الخدمة (Service Mode) هو بروكسي محلي (Local Proxy). وبمعزل عن ذلك، إذا أنهى Android عملية Chute أثناء عمل VPN، يعود النفق من تلقاء نفسه بالإعداد المحدد، إلا إذا كنت قد أوقفته، أو قطعت اتصاله من إعدادات VPN في Android، أو منحت إذن VPN لتطبيق آخر. ويصح الأمر نفسه في وضع بروكسي محلي (Local Proxy): تعود المستمعات التي كانت تعمل ما لم تكن قد أوقفتها — غير أن Android 12 وما بعده قد يرفض إعادة تشغيلها بينما Chute في الخلفية، وعندها يظهر البدء على أنه فشل.

4. التحقق

اترك وضع الخروج على قاعدة (Rule) (وضعا مباشر (Direct) / عام (Global) يتجاوزان البروكسي أو يفرضانه كلياً) ثم افتح موقعاً. يعرض لوحة المعلومات (Dashboard) في الشاشة الرئيسية الحركة الحية في تبويبات الإحصائيات (Statistics) والأنفاق (Tunnels) وDNS وUDP والسجلات (Logs)؛ فتح نفق يعرض تفاصيل الطلب والاستجابة. تحوي لوحة التحكم (Control Panel) مفاتيح التشغيل — مستمعا HTTP و SOCKS5 المحليان، HTTP Control API ووحدة تحكم الويب، MitM، تسجيل حركة المرور (Traffic Capture)، استكشاف البروتوكول (Protocol Sniffing)، Optimus DNS — إضافة إلى مسح ذاكرة DNS (Purge DNS Cache) وحزمة تشخيص وقت التشغيل (Runtime Diagnostic Bundle).

الفروق بين المنصات

• قواعد العمليات تطابق أسماء الحزم. يقارن PROCESS-NAME باسم حزمة التطبيق الذي فتح الاتصال، مثل PROCESS-NAME,com.android.chrome,Proxy؛ يسأل Chute نظام Android عن التطبيق المالك لكل اتصال TCP تحمله واجهة VPN. أما الاتصالات التي تصل إلى المستمعين بدلاً من ذلك — كلها في وضع بروكسي محلي (Local Proxy)، واتصالات التطبيقات التي تستخدم بروكسي HTTP للنظام (System HTTP Proxy) — فلا اسم حزمة لها، ولذلك لا تطابقها القاعدة أبداً.
• فك تشفير HTTPS يحتاج CA خاصاً بك. لا يوجد مولّد شهادات: في صفحة تهيئة CA (Configure CA) بالمحرر، تحت MitM، يكتب استيراد P12 (Import P12) ملف PKCS#12 في ca-p12 الخاص بالإعداد بترميز base64، كما يكتبه Chute على أجهزة Apple، فيحمل الإعداد شهادة CA الخاصة به إلى أي جهاز؛ وبعد ملء عبارة المرور يفتح تثبيت CA (Install CA) مثبّت الشهادات في Android لشهادة CA التي فيه. ولا تخضع صفحة المحرر للترخيص، لكن المحرك يخضع له: فبلا Chute Pro لا يُفكّ تشفير شيء مهما طلب [MITM] enable = true في ملف الإعداد، ومفتاح MitM أثناء التشغيل في لوحة التحكم وفي لوحة المعلومات مقيَّد كذلك.
• ميزات SSID تعمل — مجموعات سياسات ssid، قواعد SUBNET، و[SSID Setting] — بشرط منح إذن الموقع (Android 12 وما قبله) أو أجهزة Wi-Fi القريبة (Android 13 وما بعده) الذي يطلبه النظام لقراءة اسم الشبكة. ويطلب Chute هذا الإذن عندما تبدأ بالمفتاح الرئيسي وفي الإعداد مجموعة سياسات ssid أو subnet، أو قاعدة SUBNET,SSID: أو SUBNET,BSSID:، أو قسم [SSID Setting] / [SSID Suspend]. أما طرق البدء التي لا تستطيع عرض الطلب — مربّع الإعدادات السريعة، والاختصار، والبدء عند الإقلاع (Start on Boot)، والبث، وVPN دائم التشغيل — فتنشر بدلاً منه إشعار SSID Permission Needed، مرة لكل إعداد، والنقر عليه يطلب الإذن. ويعيد المحرك قراءة الشبكة كل دقيقة، فيسري الإذن خلال دقيقة دون إعادة تشغيل. ولا تُكتشف قواعد SUBNET الموجودة داخل مجموعة قواعد خارجية: فإن كانت هناك، فامنح الإذن من إعدادات النظام. وفي وضع VPN يُنزِل مدخل suspend في تعليق SSID واجهة VPN ما دام الجهاز على شبكة مطابقة؛ أما وضع بروكسي محلي (Local Proxy) فيتجاهله.
• Tailscale متاح؛ للمحرر صفحة Tailscale خاصة به.
• توجيهات المنصة — أسطر #!IOS-ONLY و #!MACOS-ONLY و #!TVOS-ONLY تُعامل هنا كتعليقات، فلا ينطبق أي منها على Android.
• أسطر Trojan من الإصدارات القديمة. تحتاج سياسة Trojan إلى tls=true صريح على كل المنصات. وكانت إصدارات Chute Android القديمة تفترض TLS لـ Trojan، ولم يكن محررها يكتب هذا الخيار افتراضياً، ولذلك يضيف أول تشغيل بعد التحديث tls=true إلى كل سياسة Trojan لا تذكر أي خيار tls في إعداداتك المحلية، ويسجّل كل تغيير في سجل خدمة التطبيق. ولا يُمسّ الإعداد المُدار — فمصدره يستبدله — ولا السطر الذي يقول tls=false.
• سجلّان. يبقى سجل المحرك في الذاكرة: اقرأه في صفحة السجلات في وحدة تحكم الويب أو عبر GET /api/logs، أو خذه في حزمة تشخيص وقت التشغيل (Runtime Diagnostic Bundle) (لوحة التحكم، أثناء عمل النفق)، أو تابعه بـ adb logcat. أما التطبيق فلا يكتب على القرص إلا سجل خدمته الخاص — عمليات البدء والإيقاف، والتعليقات، وتغيّرات الشبكة، والإشعارات التي ينشرها — في logs/runtime.log داخل تخزينه الخاص، مع نسخة لكل تشغيل تحت sessions/<run id>/. يعرض تبويب السجلات (Logs) في لوحة المعلومات آخر 80 سطراً من ذلك الملف، ويعرض تبويب السجل (Log) لجلسة نسخةَ تشغيلها؛ ويضم حفظ حزمة تشخيص دون اتصال (Save Offline Diagnostic Bundle) تحت الإعدادات ← التشخيص ذلك الملف، ويحذفه تنظيف السجلات المحلية (Clean Local Logs) في الإعدادات دون النسخ الخاصة بكل تشغيل — انظر استكشاف الأخطاء وإصلاحها.
• يتصل Chute Dashboard على Mac بالهاتف عبر USB من خلال adb أو عبر الشبكة — انظر Chute Dashboard.
• الإشعارات تغطي أحداث المحرك نفسه كما في التطبيقات الأخرى (الإعدادات ← الإشعارات)؛ ويتبع حدث Network Not Carrying Traffic مفتاح Mass Connection Failure (فشل اتصال جماعي). ولا تُنشر هذه الإشعارات إلا في وضع VPN: فوضع بروكسي محلي (Local Proxy) لا يُصدر أي إشعار لأحداث المحرك.
• غير متوفر على Android: الوضع المحسن وVIF الخاصان بـ Mac، مزامنة iCloud، وإجراءات الرابط chute://start / stop / toggle — انظر مخطط الرابط لـ Broadcast Intents التي تحل محلها. ولا يستطيع أي Broadcast إظهار مربع موافقة VPN، ولذلك يُسقَط START_VPN بصمت حتى تُمنح الموافقة مرة واحدة؛ أما TOGGLE_VPN فيفتح التطبيق بدلاً من ذلك، حيث يُظهر النقرُ على المفتاح ذلك المربع، ووضع بروكسي محلي (Local Proxy) لا يحتاج أي موافقة إطلاقاً.