تنقيح Apple TV

من بين المنصّات الثلاث، Apple TV أصعبها تنقيحاً، لأسباب لا علاقة لها بـ Chute: فـ tvOS بلا متصفح، وبلا ورقة مشاركة، وبلا متصفح ملفات، وبلا طريقة لتثبيت شهادة من الجهاز نفسه، وفي يدك جهاز تحكم عن بعد بدل لوحة مفاتيح. ويجيب Chute tvOS عن كل نقطة من هذه بنقل الواجهة إلى مكان آخر — إلى متصفح على هاتفك أو جهاز Mac، أو إلى رمز QR، أو إلى نافذة Dashboard.

ولهذا يختلف شكل هذا الدليل عن الدليلين الآخرين: كل شيء تقريباً يحدث خارج التلفاز.

1. إيصال ملف إعدادات إلى التلفاز

لا أحد يريد تحرير الإعدادات بجهاز التحكم مرتين، فاكتبها في مكان آخر وأرسلها. على Apple TV يقدّم Add Configuration From... ثلاثة مسارات:

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

في مسار الرفع يجب أن يكون التلفاز والجهاز الآخر على شبكة Wi-Fi نفسها، ولا يوجد المستمع إلا ما دامت تلك الشاشة مفتوحة — ومغادرتها أو قفل الجهاز يلغي النقل.

2. شغّل المستمعَين اللذين ستستخدمهما فعلاً

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

HTTP API + Web UI — أي وحدة تحكم الويب، حيث تقيم الأجسام وتصدير HAR والتشخيص:

[General]
external-http-controller = 0.0.0.0:9090
external-http-secret = your-own-token
external-http-ui = true

اربطها بـ 0.0.0.0 لا بـ 127.0.0.1: فوحدة التحكم المربوطة بالعنوان الاسترجاعي لا يمكن فتحها من جهاز آخر، ولا يوجد على التلفاز متصفح يفتحها محلياً. والربط بغير العنوان الاسترجاعي يستلزم external-http-secret صريحاً، وإلا رفض المتحكم أن يبدأ.

External Controller Access — القناة الثنائية التي تتكلمها Chute Dashboard. في محرر الإعدادات افتح External Controller:

1. شغّل External Controller Access.
2. اضبط Port (الافتراضي هنا 6171) وPassword من عندك؛ ولا يجوز أن تكون فارغة.
3. شغّل Allow Access From Wi-Fi. على Apple TV ليس هذا اختيارياً كما في الهاتف — إذ لا يوجد مسار كابل بديل، فمع إطفائه لا يستطيع شيء خارج التلفاز الاتصال.

ما ينبغي أن تراه في لوحة التحكم: HTTP API Port وWeb UI بحالة On، وExternal Access Port يعرض منفذك. وغياب ذلك يعني أن النفق يعمل بنسخة قديمة من الإعدادات — أعد تشغيله.

3. فتح وحدة التحكم من جهاز آخر

في لوحة التحكم صف Web UI Address أسفل مفتاح Web UI. اختره:

• إن كان المستمع قابلاً للوصول من أجهزة أخرى عرض التلفاز رمز QR. امسحه بهاتف على الشبكة نفسها، أو اكتب العنوان في أي متصفح. ورمز تسجيل الدخول يسافر داخل الرمز بدل أن يُعرض على الشاشة، فلا يحتاج أحد إلى نسخ 32 محرفاً ست عشرياً من شاشة تلفاز.
• وإن كان المتحكم مربوطاً بالعنوان الاسترجاعي عرض التلفاز شرحاً بدل الرمز — انظر الخطوة 2.

ومن هناك تكون وحدة التحكم واحدة على كل المنصّات: Connections بفحص كل اتصال على حدة مع الأجسام، وRules بقائمة إعادات الكتابة التي عملت، وDiagnostics بمجسّات ping و DNS والمخرج واختبار الروابط، وLogs.

4. وصل Chute Dashboard

على جهاز Mac افتح Chute Dashboard واستخدم قسم Remote: Host هو عنوان Apple TV — وتعرضه لوحة التحكم تحت LOCAL IP — مع المنفذ وكلمة المرور من الخطوة 2. وقسم USB مخصص لأجهزة iPhone؛ أما Apple TV فيُوصل عبر الشبكة.

وكل ما تفعله Dashboard لهاتف تفعله هنا — قائمتا Active و Recent، وعرضا DNS و UDP، ولوحات أدوات MitM، وتصدير HAR و curl بنقرة يمنى.

5. فك تشفير HTTPS

يختلف أمران على هذه المنصّة، وكلاهما يفاجئ الناس.

لا يمكن تثبيت شهادة CA من التطبيق. ليس في tvOS متصفح Safari ولا مثبّت ملفات تعريف، فلا بد أن تصل الشهادة بالطريقة الوحيدة التي يقبل بها tvOS الشهادات أصلاً: MDM أو Apple Configurator. والتطبيق يقول ذلك في الموضع الذي تُحرَّر فيه قائمة المضيفين. أنشئ الشهادة أو استوردها في الإعدادات كالمعتاد، وصدّرها، ثم أوصلها إلى الجهاز بأحد هذين المسارين.

لا يوجد مفتاح MitM في لوحة التحكم. في iOS و macOS مفتاح، وفي tvOS لا. ويُشغَّل فك التشفير بواحد مما يلي:

• الإعدادات — enable = true في [MITM]، وهو الجواب الباقي.
• وحدة التحكم، أو مفتاح شريط أدوات Chute Dashboard.
• ‏PUT /api/features/mitm مع {"enabled": true}.

والثلاثة الأخيرة تعمل على النواة العاملة وحدها وتُنسى عند إعادة التشغيل التالية. وتُقرأ قائمة hostname من ملف الإعدادات، ويمكن تحريرها مباشرة من وحدة التحكم أو من Dashboard.

[MITM]
enable = true
hostname = api.example.com, *.example.net

6. التسجيل، وإخراج النتيجة من الجهاز

‏Dump Data في لوحة التحكم هو مسجّل الحركة — الإعداد replica — وأحد المفتاحين اللذين يحتاجان ترخيصاً على tvOS. وبدونه تظهر الاتصالات ومعها قاعدتها وسياستها وتوقيتاتها؛ الناقص هو الحمولات فحسب.

ثم يأتي الجزء الخاص بهذه المنصّة وحدها: لا مكان في Apple TV لوضع ملف. لا ورقة مشاركة ولا تطبيق ملفات، فكل تصدير يخرج عبر HTTP:

• HAR — صفحة الاتصالات في وحدة التحكم، Export HAR. وينزل الملف على الجهاز الذي يشغّل المتصفح.
• حزمة تشخيص وقت التشغيل — صفحة التشخيص في وحدة التحكم، Download diagnostic bundle.
• حزمة التشخيص دون اتصال — الإعدادات ← Offline Diagnostic Bundle، حين لا يكون النفق يعمل. يبني التلفاز الأرشيف ويعرض رمز QR؛ ويعمل الرابط ما دامت تلك الشاشة مفتوحة فقط.

7. ما يستطيع التلفاز نفسه أن يخبرك به

بعض الأسئلة لا تحتاج جهازاً آخر إطلاقاً. تحت الإعدادات ← DIAGNOSIS:

• Sessions — اتصالات هذا التشغيل. واختيار واحد يفتح لوحة تفاصيل فيها BASIC (التاريخ والحالة وسبب الإغلاق والمدة)، و POLICY (القاعدة المطابِقة والسياسة التي اختارتها)، و NODES (المحلي والخادم والبعيد والمضيف)، و TRAFFIC، و TIMING (جهوزية البروكسي وحلّ DNS والقاعدة وجهوزية الطرف البعيد وإجمالي وقت النشاط)، وإعادات الكتابة التي عملت. ولا توجد أجسام طلبات أو استجابات — فتلك تحتاج وحدة التحكم أو Dashboard.
• Sessions ← شاشة السجل — وفوقها مرشّح خطورة (All / Notify+ / Warning+ / Fatal)، فيكفي جهاز التحكم عن بعد لتضييق تشغيل كامل إلى تحذيراته.
• Network Diagnosis وProxy Diagnosis وRoute Table — قابلية الوصول والمستمعون والتوجيه كما يراها الجهاز.

وفي لوحة التحكم أيضاً Purge DNS Cache، وهو أسرع طريقة لإعادة اختبار تعيين [Host] دون إعادة تشغيل النفق.