إذا كان boredazfcuk/icloudpd ينشئ حلقة مفاتيح لكنه لا يزال يفشل في المصادقة، فأعد تشغيل مسار التهيئة الموثّق للحاوية وركّز على ملف تعريف ارتباط المصادقة متعددة العوامل (MFA)، وليس على كلمة المرور المحفوظة فقط. تحتاج صورة Docker هذه إلى حالة مستمرة في /config وإلى جلسة مصادقة صالحة مع Apple قبل أن تتمكن تنزيلات الصور غير التفاعلية من المتابعة.
كان المستخدم الأصلي قد أنشأ حلقة مفاتيح بالفعل، لكنه ظل يتلقى الرسالة: «معلومات المصادقة متعددة العوامل مفقودة من ملف تعريف الارتباط». توضّح وثائق الحاوية الحالية من المصدر سبب ذلك بالضبط: إذ تحفظ التهيئة كلمة المرور وتنشئ ملف تعريف ارتباط MFA، ثم يحتاج ملف تعريف الارتباط هذا إلى إعادة مصادقة دورية لاحقًا.

ما الذي يجب أن يكون مستمرًا
اربط مجلدًا على المضيف بالمسار /config داخل الحاوية. يخزّن هذا الدليل الإعدادات، وملفات حلقة مفاتيح Python، وملف تعريف ارتباط المصادقة، والحالة المطلوبة بين عمليات إعادة تشغيل الحاوية.
اربط مجلدًا منفصلًا على المضيف للصور التي تم تنزيلها وفقًا لقيمة download_path التي اخترتها. لا تضع مكتبة الصور داخل نظام ملفات الحاوية المؤقت وحده.
شغّل أمر التهيئة الرسمي
يوثّق دليل تهيئة docker-icloudpd من المصدر الأمر التالي:
docker exec -it icloudpd sync-icloud.sh --Initialise
استبدل icloudpd إذا كان لحاوية ZimaOS لديك اسم مختلف.
حلقة المفاتيح ليست سوى جزء واحد من المصادقة
أثناء التهيئة، يطلب البرنامج النصي كلمة مرور حساب Apple ويحفظها في حلقة المفاتيح إذا وافقت. ثم يتعامل مع المصادقة الثنائية وينشئ ملف تعريف ارتباط داخل /config.
إذا كانت كلمة المرور موجودة لكن ملف تعريف الارتباط لا يحتوي على حالة MFA صالحة، فقد تفشل الحاوية بالطريقة نفسها تمامًا كما يظهر في لقطة الشاشة الأصلية.
أكمل MFA من جهاز Apple موثوق
عند الطلب، وافق على تسجيل الدخول من جهاز موثوق وأدخل رمز التحقق الحالي في الطرفية التفاعلية. لا تعِد استخدام رمز منتهي الصلاحية من محاولة سابقة.
إذا لم تُرسل Apple رمز التحقق أو لم تقبله، فتأكد من إمكانية تسجيل الدخول إلى حساب Apple بشكل طبيعي عبر iCloud.com قبل إلقاء اللوم على Docker.
تحقق من ملكية /config وأذوناته
تحتاج الحاوية إلى الكتابة في ملفات حلقة المفاتيح وملف تعريف الارتباط داخل مجلد الإعدادات المستمر. إذا غيّرت PUID/PGID أو ربطت مجلدًا في ZimaOS بملكية غير متوافقة، فقد لا تستمر حالة المصادقة.
بعد التهيئة، تحقّق من ظهور ملفات حلقة المفاتيح وملف تعريف الارتباط الجديدة داخل مجلد الإعدادات المرتبط، ومن بقائها بعد إعادة تشغيل الحاوية.
أعد المصادقة عندما تنهي Apple الجلسة
تذكر وثائق المصدر أن مصادقة Apple الحديثة قد تتطلب إعادة المصادقة كل 30 يومًا تقريبًا. توفر الحاوية الأمر التالي:
docker exec -it icloudpd reauth.sh
ضع ذلك ضمن توقعات الصيانة لديك. فقد تتوقف حاوية سليمة عن التنزيل لاحقًا رغم عدم تغيير أي شيء في ZimaOS.
إذا غيّرت كلمة مرور حساب Apple
يوفر الغلاف البرمجي من المصدر خيارًا لإزالة حلقة المفاتيح. أزل بيانات الاعتماد القديمة المحفوظة، ثم أعد التهيئة بدلًا من تكرار المحاولات باستخدام إدخال قديم غير صالح في حلقة المفاتيح.
أبقِ وجهة الصور منفصلة عن /config
تختلف احتياجات النسخ الاحتياطي لحالة الإعدادات عن احتياجات الصور التي تم تنزيلها. انسخ مكتبة الصور الفعلية احتياطيًا بشكل مستقل، واحمِ /config بما يكفي لتتمكن من إعادة إنشاء الحاوية دون البدء من الصفر.
يفيد دليل النسخ الاحتياطي للصور في إنشاء نسخة محلية ثانية أو نسخة خارج الموقع.
ماذا تفعل إذا استمر فشل مصادقة Apple؟
فعّل تسجيل التصحيح في الحاوية، وافحص مرحلة المصادقة الدقيقة، وتحقق من متعقّب المشكلات والنقاشات من المصدر لمعرفة التغييرات الحالية من جانب Apple. مصادقة iCloud ليست بروتوكولًا محليًا ثابتًا؛ فقد تغيّر Apple سلوك تسجيل الدخول بشكل مستقل عن ZimaOS.
الأسئلة الشائعة
لماذا يفشل icloudpd رغم وجود كلمة المرور في حلقة المفاتيح؟
يحتاج الغلاف البرمجي أيضًا إلى ملف تعريف ارتباط صالح للمصادقة الثنائية. كلمة المرور المحفوظة وحدها لا تكفي.
كم مرة أحتاج إلى إعادة المصادقة؟
تصف وثائق الغلاف البرمجي الحالية إعادة مصادقة MFA الدورية، وعادةً ما تكون كل 30 يومًا تقريبًا.
أين يجب أن أخزّن ملف تعريف ارتباط المصادقة؟
احتفظ بمجلد /config الخاص بالحاوية على مساحة تخزين ZimaOS حتى تستمر حالة حلقة المفاتيح وملف تعريف الارتباط بعد إعادة إنشاء الحاوية.
هل icloudpd منتج نسخ احتياطي رسمي من Apple؟
لا. إنه أداة تنزيل من جهة خارجية تعتمد على سلوك المصادقة لدى Apple. احتفظ بنسخة احتياطية مستقلة من المكتبة التي تم تنزيلها.
