بدء الاستخدام

تشرح هذه الصفحة خطوات التشغيل الأول: إدخال إعدادات إلى Chute، واختيارها، وبدء البروكسي، والتحقق من تدفق حركة المرور. كل ما تبقى في هذا الدليل يُبنى على بيئة عاملة.

Chute iOS

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

عند التشغيل الأول دون أي إعدادات، يفتح Chute دليل إعداد ("Welcome to Chute") بثلاثة مسارات: رابط الاشتراك (Subscription Link) لرابط صادر من مزود الخدمة، ومسح رمز QR (Scan QR Code)، والإعداد اليدوي (Manual Setup) الذي يطلب بيانات خادمك والمواقع المراد توجيهها عبر البروكسي واختيار DNS، ثم يبني ملف إعدادات باسم "Default" ويتصل.

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

• إعدادات فارغة (Blank Configuration) — يفتح المحرر المدمج بإعدادات فارغة (انظر المثال الأدنى أدناه لما يوضع فيها).
• إضافة اشتراك (Add Subscription) — ينزّل من رابط اشتراك ويبقيه محدّثاً: يُحفظ الملف الأصلي كـإعدادات مدارة يعاد جلبها كل 24 ساعة، أو بالفاصل الذي يحدده سطر #!MANAGED-CONFIG في الملف نفسه. أما اشتراك Clash أو sing-box فيُحوَّل أثناء الاستيراد ويُحفظ لقطةً ثابتة بلا ترويسة تحديث، فلا يحدّث نفسه أبداً — أعد استيراده للتحديث.
• استيراد من ملف محلي (Import from Local File) — يستورد ملف Chute (.conf) أو sing-box (.json) أو Clash/mihomo (.yaml)؛ الصيغ غير الأصلية تُحوَّل تلقائياً.
• المزامنة من iCloud (Sync From iCloud)، التنزيل من رابط (Download From URL)، رفع ملف عبر Wi-Fi (Upload File Via Wi-Fi)، التنزيل من رمز QR (Download From QR Code) — وسائل نقل إضافية للأمر نفسه.

دون ترخيص يحتفظ iPhone أو iPad بملف إعدادات واحد فقط. فما إن يوجد ملف إعدادات حتى تثير كل القنوات أعلاه تنبيه الشراء، وكذلك اختيار ملف إعدادات مختلف — انظر الترخيص والتفعيل.

2. اختياره

في قائمة الإعدادات، اضغط على إعدادات حتى تظهر علامة الاختيار، ثم اضغط تم (Done). يشغّل Chute دائماً الإعدادات المختارة — ومع عدم اختيار أي منها يرفض المفتاح الرئيسي البدء ("Please select configuration first").

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

اضغط المفتاح الدائري في الشاشة الرئيسية. عند البدء الأول تماماً يطلب iOS إضافة تكوين VPN — وافق عليه وأكّد بـ Face ID / Touch ID / رمز الدخول. إذا رفضت الطلب، فبدّل المفتاح مجدداً فحسب؛ وإذا علق ملف تعريف VPN يوماً، فإن إعادة تعيين تكوين VPN (Reset VPN Configuration) في إعدادات التطبيق يزيله بحيث يعيد التشغيل التالي إنشاءه.

4. التحقق

بعد تشغيل المفتاح، أبقِ وضع الخروج على حسب القواعد (Rule-Based) (الوضعان مباشر (Direct) / عام (Global) يتجاوزان البروكسي أو يفرضانه جملةً)، ثم افتح موقعاً. يعرض زر لوحة المعلومات (Dashboard) حركة المرور الحية وتفاصيل كل اتصال — أسرع طريقة للتأكد من أن الإعدادات تتصرف كما هو مقصود.

Chute Mac

يقيم Chute Mac في شريط القوائم (لا توجد أيقونة Dock افتراضياً). انقر أيقونة شريط القوائم:

1. استيراد إعدادات — استيراد الإعدادات... (Import Configuration...) يفتح تبويب ملفات الإعدادات (Profiles) في النافذة الرئيسية، وفيه الاستيراد من ملف… (Import from File…) لملف على القرص والاستيراد من رابط أو رابط مشاركة… (Import from URL or Share Link…) لرابط اشتراك أو رابط مشاركة (ss://، vmess://، ...؛ ومن بين التطبيقات الأربعة لا يستورد روابط المشاركة إلا Chute Mac). أما مساعد الإعداد... (Setup Assistant...) فيبنيها خطوة بخطوة بدلاً من ذلك. ولا يظهر عنصرا القائمة هذان إلا والبروكسي متوقف. تُخزَّن ملفات الاشتراكات والملفات المحوّلة تحت ~/Library/Application Support/<bundle id>/Profiles/؛ أما الملفات المستوردة من القرص فيُشار إليها في مكانها.
2. اختيارها — اختيار ملف الإعدادات (Select Configuration File)، أو تبديل الإعدادات (Switch Configuration) أثناء تشغيل البروكسي. في أول مرة يبدأ فيها المحرك، يثبّت Chute المساعد ذا الامتيازات الذي يضبط بروكسي النظام وينشئ واجهة الوضع المحسن: يشرح السبب أولاً (Chute Needs a Helper)، ثم يطلب منك macOS الإذن له. وعلى macOS 13 وما بعده قد يلزم أيضاً السماح بالمساعد في إعدادات النظام > عام > عناصر تسجيل الدخول والإضافات؛ ويخبرك Chute بذلك عبر Approval Required أو Allow Chute in Login Items.
3. تشغيلها — مفتاحان مستقلان يلبيان حاجتين مختلفتين:
   • بروكسي النظام (System Proxy) — المفتاح أعلى القائمة. يسجّل Chute كبروكسي HTTP/SOCKS للنظام؛ التطبيقات التي تحترم بروكسي النظام تمر عبر Chute.
   • الوضع المحسن (Enhanced Mode) (⌘E) — يلتقط كل حركة المرور على مستوى طبقة الشبكة، بما في ذلك التطبيقات التي تتجاهل بروكسي النظام. نوعه الافتراضي، Helper utun (Legacy)، يعرض إشعاراً قبل أن يعمل ولا يحتاج إلى أي موافقة أخرى؛ ولا يطلب منك الموافقة على امتداد الشبكة وتكوين VPN الخاصين بـ Chute إلا النوع PacketTunnel (Recommended). انظر الوضع المحسن لاختيار النوع ومسار الموافقة.
4. التحقق — يعرض رأس القائمة "System Proxy: Active"، ويُظهر تبويبا حركة المرور (Traffic) والسجل (Log) في النافذة الرئيسية ما يتدفق ولماذا.

ملاحظة: تصف هذه الخطوات النافذة الرئيسية الجديدة. ولا يفعّلها Chute Mac من تلقاء نفسه إلا في تثبيت لا يحوي أي إعدادات بعد؛ أما التثبيت الذي كانت فيه إعدادات من قبل فيحتفظ بالواجهة الأقدم: تعرض قائمته التفضيلات... (Preferences...) بدلاً من فتح لوحة المعلومات... (Open Dashboard...)، ولا تحوي تلك النافذة تبويبَي حركة المرور (Traffic) والسجل (Log). فعّل استخدام الواجهة الرئيسية الجديدة (Use New Main UI) في القائمة — ويظهر ما دام البروكسي يعمل — للتبديل إليها.

Chute tvOS

يضيف Chute tvOS ملف إعدادات بنفسه. في قائمة الإعدادات يقدّم إضافة إعدادات من... (Add Configuration From...) الخيارات إعدادات فارغة (Blank Configuration) ورفع ملف عبر Wi-Fi أو Chute iOS (Upload File Via Wi-Fi or Chute iOS) والتنزيل من رابط (Download From URL). يضع الرفع عبر Wi-Fi صفحة HTTP بسيطة على عنوان التلفاز يستطيع أي متصفح على الشبكة نفسها أن يرسل إليها ملفاً؛ وإذا فُتحت من iPhone سلّمت الأمر إلى Chute iOS عبر مخطط الرابط chute://tv، وهنا يأتي دور واجهة استيراد الإعدادات عن بعد. وحدّ ملف الإعدادات الواحد هو نفسه كما على iOS.

Chute Android

التشغيل الأول على Android — إضافة ملف إعدادات، موافقة VPN، وضع الخدمة ووضع كل تطبيق، ومكان التحقق — له صفحة خاصة: بدء الاستخدام على Android. الإعداد الأدنى أدناه يعمل هناك دون تغيير.

إعدادات دنيا

إعدادات كاملة وعاملة لخادم Shadowsocks واحد — توجّه حركة الشبكة المحلية والحركة الصينية مباشرةً، وكل ما عداها عبر البروكسي:

[General]
loglevel = notify
dns-server = 1.1.1.1, 8.8.8.8
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

[Proxy]
MyProxy = ss, example.com, 8388, aes-256-gcm, "password"

[Proxy Group]
MainGroup = select, MyProxy, DIRECT

[Rule]
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR,10.0.0.0/8,DIRECT
IP-CIDR,172.16.0.0/12,DIRECT
IP-CIDR,127.0.0.0/8,DIRECT
GEOIP,CN,DIRECT
FINAL,MainGroup

استبدل سطر [Proxy] ببروتوكول خادمك ومعاملاته — كل بروتوكول مدعوم موثَّق في خادم البروكسي. من هنا:

• الإعدادات — صيغة الملف وجميع الأقسام.
• القواعد — كيف تُقيَّم القواعد والفهرس الكامل لأنواع القواعد.
• مجموعة السياسات — الاختيار التلقائي (url-test، fallback، load-balance).
• استكشاف الأخطاء وإصلاحها — عندما لا يعمل شيء ما.