حلّ المجتمع

تعذّر اتصال ZimaClient على جهاز Mac: ما الذي ينبغي تجربته أولًا؟

A Mac client stayed on Connecting after ZimaOS upgrades; rebooting and reinstalling did not help, but signing out and back in restored the verified case.

إذا ظل ZimaClient على macOS عالقًا عند حالة «جارٍ الاتصال»، فسجّل الخروج من العميل ثم سجّل الدخول مجددًا قبل إعادة تثبيت التطبيق أو تغيير خادم ZimaOS. أعاد هذا الإجراء تحديدًا حالة المصدر المُتحقَّق منها للإصدار 2.1.0 بعد أن ظلت عالقة لعدة ساعات.

ومع ذلك، لا تعتبر تسجيل الخروج/الدخول حلًا شاملًا للسبب الجذري. فقد تناول النقاش نفسه أعراض اتصال على أجهزة Mac وAndroid بعد ترقيات ZimaOS، كما طلبت IceWhale تحديدًا معلومات عن جدران الحماية وشبكات VPN والوكلاء وتغييرات مزود خدمة الإنترنت وإعدادات الشبكة. ويفصل مسار استكشاف الأخطاء الجيد بين حالة الحساب/الجلسة وإمكانية الوصول إلى الشبكة.

الخطوة 1: تأكد من أن الخادم يعمل محليًا

افتح لوحة معلومات ZimaOS مباشرةً باستخدام عنوان IP المحلي للشبكة LAN في متصفح. إذا كان الخادم يعمل محليًا لكن ZimaClient لا يستطيع الاتصال، فركّز على طبقة العميل/الجلسة/الوصول عن بُعد.

الخطوة 2: سجّل الخروج ثم سجّل الدخول مجددًا

كان المستخدم الأصلي قد أعاد تثبيت ZimaClient وأعاد تشغيل ZimaOS بالفعل دون نجاح. وقد أدّى تسجيل الخروج من ZimaClient ثم المصادقة مجددًا إلى استعادة الاتصال.

يشير ذلك إلى احتمال وجود حالة قديمة في العميل/الجلسة، لكن النقاش لم يثبت تحديدًا أي رمز مميز أو حالة شبكة قد تغيّرت.

الخطوة 3: تحقق من الوصول عن بُعد في ZimaOS

يوضح دليل الوصول عن بُعد إلى ZimaOS الحالي أنه يمكن تشغيل الوصول عن بُعد أو إيقافه من الإعدادات ← الشبكة.

تأكد من تمكينه إذا كنت تتوقع أن يعمل ZimaClient خارج المنزل.

الخطوة 4: اختبر الاتصال على شبكة LAN نفسها

توصي إرشادات الإعداد الحالية في ZimaOS بإجراء الاتصال الأول على الشبكة نفسها. إذا تعذّر على ZimaClient الاتصال حتى محليًا، فلن يكون اجتياز NAT عن بُعد هو المشكلة الأولى.

الخطوة 5: تحقق من VPN والوكلاء وجدار الحماية وتغييرات الشبكة

طلب دعم IceWhale تحديدًا معرفة ما إذا كان المستخدم قد غيّر جدار الحماية أو شبكة VPN/الوكيل أو مزود خدمة الإنترنت أو إدارة الشبكة قبل حدوث العطل.

عطّل مؤقتًا عملاء VPN/الوكيل المتعارضين أثناء التشخيص، وتأكد من أن إذن الشبكة المحلية في macOS يسمح لـ ZimaClient باكتشاف الأجهزة.

الخطوة 6: أعد تشغيل عمليات ZimaClient العالقة

يوصي دليل تثبيت ZimaClient الحالي باستخدام مراقب النشاط لإغلاق العمليات المرتبطة بـ Zima عندما يبدو التطبيق قيد التشغيل لكنه لا يعمل بشكل صحيح.

الخطوة 7: اجمع السجلات قبل إعادة التثبيت مجددًا

توضح الوثائق الحالية أن سجلات ZimaClient على macOS موجودة ضمن:

~/Library/Application Support/Zima/logs

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

استخدم أدوات VPN القياسية كمسار بديل

يدعم ZimaOS الحالي أيضًا Tailscale وWireGuard Easy وFirefly وNetBird كخيارات بديلة للشبكات عن بُعد. وهي لا تحل محل النسخ الاحتياطي أو تكامل Finder في ZimaClient، لكنها قد توفر مسار شبكة خاصًا مستقلًا.

يساعد دليل الاتصال عن بُعد في مقارنة هذه الطبقات.

ميّز بين المصادقة والاتصال

إذا كان جهاز Mac يستطيع اكتشاف الخادم لكن المصادقة تفشل، فقارن حساب ZimaOS نفسه في واجهة الويب المحلية. إذا كان الحساب يعمل في المتصفح ولا يعمل في ZimaClient، فمن المرجح أن تكون المشكلة في حالة العميل/الجلسة لا في كلمة المرور نفسها.

إذا لم يتمكن المتصفح ولا العميل من الوصول إلى الخادم عبر عنوان IP، فاستكشف الخادم أو شبكة LAN أولًا.

تحقق من إذن الشبكة المحلية في macOS

يمكن لـ macOS تقييد قدرة التطبيق على اكتشاف الأجهزة الموجودة على الشبكة المحلية. إذا لم يعرض ZimaClient جهاز ZimaOS قريبًا، فراجع إذن الشبكة المحلية للتطبيق ضمن إعدادات الخصوصية والأمان في macOS، ثم أعد تشغيل العميل بعد تغييره.

أعد ضبط الطبقة المعطلة فقط

لا تُعد ضبط خادم ZimaOS وRemote ID وكلمة المرور وتثبيت العميل كلها في الوقت نفسه. غيّر طبقة واحدة في كل مرة حتى تعرف ما الذي أصلح المشكلة فعليًا.

تُعد حالة المصدر مثالًا جيدًا: لم تُفد إعادة تشغيل الخادم وإعادة تثبيت العميل، بينما أفاد تسجيل الخروج ثم الدخول مجددًا. وتشير هذه الأدلة إلى أن المشكلة كانت في حالة الجلسة لا في تثبيت الخادم التالف.

متى تستخدم مسارًا بديلًا للوصول عن بُعد؟

إذا ظل ZimaClient غير متاح لكن الخادم نفسه سليم، فيمكن لمسار Tailscale أو WireGuard مُعدّ بشكل منفصل أن يُبقي الإدارة متاحة بينما تجمع السجلات. استخدمه كمسار شبكة مستقل، لا كدليل على حل مشكلة ZimaClient.

الأسئلة الشائعة

لماذا لم تُفد إعادة تثبيت ZimaClient؟

قد تترك إعادة التثبيت ظروف الحساب/الجلسة أو الشبكة دون تغيير. وفي حالة المصدر المُتحقَّق منها، كان الإجراء الذي أعاد الخدمة هو تسجيل الخروج ثم الدخول مجددًا.

لماذا قد يعمل SMB بينما يفشل ZimaClient؟

إن SMB على شبكة LAN واتصال ZimaClient عن بُعد/عبر الجلسة طبقتان مختلفتان. وقد تعمل إحداهما بينما تكون الأخرى معطلة.

أين توجد سجلات ZimaClient على Mac؟

تُدرج الوثائق الرسمية الحالية المسار ~/Library/Application Support/Zima/logs.

هل ينبغي إعادة ضبط كلمة مرور ZimaOS؟

ليس لمجرد أن ZimaClient يعرض حالة «جارٍ الاتصال». تحقق أولًا من تسجيل الدخول المباشر، ثم سجّل الخروج/الدخول، وافحص حالة الشبكة والسجلات.