إذا ظلّ Stirling PDF يظهر على الشاشة الرئيسية لـ ZimaOS بحالة «جارٍ تثبيت التطبيق»، فتحقّق أولًا مما إذا كانت حاوية Docker موجودة فعلًا وتعمل. قد تكون بطاقة التثبيت العالقة مشكلة في حالة الواجهة الأمامية أو إدارة التطبيقات، بينما تشير إعادة تشغيل الحاوية بشكل متكرر إلى خطأ حقيقي في النشر. تعامل مع هذين الأمرين على أنهما عطلان مختلفان.
لم يصل النقاش الأصلي إلى حل مؤكّد: إذ لم يؤدِّ إلغاء التثبيت وإعادة التثبيت إلى مسح الحالة، كما أن إعادة تشغيل ZimaOS بالكامل لم تساعد المستخدم الأصلي. لذلك، يتمثل النهج الآمن في تشخيص حالة الحاوية والسجلات وبيانات App Store وسلوك الحزمة الحالية، بدلًا من الادعاء بأن إعادة التشغيل هي الحل.
الخطوة 1: تحقّق مما إذا كان Stirling PDF يعمل
من الطرفية على مضيف ZimaOS:
docker ps -a --format 'table {.Names} {.Image} {.Status}' | grep -i stirlingإذا كانت حاوية Stirling تعمل، فاختبر منفذ واجهة الويب المنشور مباشرةً. إذا عملت عبر عنوان IP والمنفذ مباشرةً، فالتطبيق سليم على الأرجح، وتكون البطاقة العالقة غالبًا مشكلة في حالة الواجهة أو الإدارة.
الخطوة 2: تحقّق من سجلات الحاوية
docker logs --tail 200 <stirling-container-name>ابحث عن تعارضات المنافذ، أو أخطاء الصلاحيات، أو متغيرات البيئة غير الصالحة، أو حلقات إعادة التشغيل. لا تُعد إلغاء التثبيت مرارًا قبل معرفة سبب فشل الحاوية الحالية.
الخطوة 3: أجرِ تحديثًا كاملًا للوحة تحكم ZimaOS
استخدم نافذة تصفح خاصة أو امسح بيانات الموقع المخزنة مؤقتًا لعنوان ZimaOS المحلي. إذا اختفت بطاقة التثبيت في جلسة نظيفة، فقد تكون الواجهة الخلفية صحيحة بالفعل.
الخطوة 4: تحقّق من App Store وحالة Docker معًا
إذا كانت الواجهة تعرض «جارٍ التثبيت» بينما لا يعرض Docker أي حاوية لـ Stirling، فقد تكون مهمة إدارة التطبيق عالقة. أما إذا أظهر Docker حاوية تُعاد تشغيلها باستمرار، فتعكس حالة الواجهة عملية نشر غير مكتملة فعلًا.
استخدم إعدادات Docker الحالية لـ Stirling PDF
تستخدم وثائق Stirling PDF الحالية الصورة الرسمية ووحدات تخزين دائمة للإعدادات، ولا تتطلب تعديلات خاصة بمضيف ZimaOS.
يُعد دليل Docker الخاص بـ Stirling PDF المرجع الأساسي عند إعادة بناء تعريف التطبيق.
لا تحذف البيانات الدائمة لمجرد مسح البطاقة
إذا كان Stirling PDF قد أنشأ إعدادات أو بيانات مستخدم بالفعل، فقد يؤدي حذف AppData إلى تحويل مشكلة تجميلية في حالة التثبيت إلى فقدان للبيانات. انسخ وحدات التخزين المعينة احتياطيًا قبل إجراء أي تنظيف يدوي لـ Docker.
متى تكون إزالة Docker يدويًا مناسبة؟
إذا تعذّر على ZimaOS إزالة حاوية متروكة فاشلة بوضوح عبر الواجهة، فيمكن للمستخدمين المتقدمين إزالة الحاوية المحددة بعد تسجيل صورتها ومنافذها وتعيينات وحدات التخزين الخاصة بها. لا تحذف الصور أو الشبكات أو وحدات التخزين غير المرتبطة.
بعد التنظيف، حدّث App Store وأعد التثبيت من حزمة حالية أو تعريف Compose من المصدر الأصلي.
تحقّق من إصدار ZimaOS الحالي
تعود الحالة الأصلية إلى منتصف عام 2025. وقد تلقى ZimaOS الحالي إصلاحات موسعة منذ ذلك الحين تتعلق بـ App Store وبدء تشغيل Docker ومنافذ واجهة الويب وتوافق YAML. حدّث النظام إلى إصدار مستقر حالي قبل اعتبار عرض التثبيت العالق القديم مشكلة قائمة في المنتج.
يوضح دليل استكشاف أخطاء Docker وإصلاحها النموذج العام للحاويات.
تحقّق مما إذا كانت مهمة التثبيت لا تزال تُنتج نشاطًا
إذا بقيت البطاقة عند النسبة نفسها بلا نهاية، فقارن بين عمليات سحب الصور وإنشاء الحاوية ونشاط الشبكة على مدار عدة دقائق. يجب أن تُظهر الصورة التي يتم تنزيلها فعلًا تغيرًا في حالة الصورة أو الطبقات، بينما قد تبقى مهمة واجهة أمامية عالقة دون تغيير حتى عندما لا يحدث أي شيء.
تحقّق من تعارضات المنافذ قبل إعادة التثبيت
يكشف Stirling PDF عادةً عن خدمة ويب. إذا كان منفذ المضيف الذي حددته الحزمة مستخدمًا بالفعل، فقد يتم سحب الصورة بنجاح، لكن تفشل الحاوية في بدء التشغيل. افحص سجلات الحاوية وارتباطات المنافذ الحالية بدلًا من الضغط على «تثبيت» مرارًا.
تأكّد من أن المسارات الدائمة قابلة للكتابة
قد تفشل الحاوية أيضًا بعد تنزيل الصورة إذا كان مجلد الإعدادات أو مجلد العمل معيّنًا إلى مجلد مضيف لا تملك الخدمة صلاحية الكتابة فيه. تحقّق من وجود مسار المضيف ومن امتلاكه الصلاحيات المناسبة للحاوية، بدلًا من منح صلاحيات واسعة لكل /DATA.
الأسئلة الشائعة
هل ستؤدي إعادة تشغيل ZimaOS إلى مسح تثبيت Stirling PDF العالق؟
قد تمسح الحالة المؤقتة، لكنها لم تُصلح حالة المستخدم الأصلي. افحص حاوية Docker الفعلية وسجلاتها أولًا.
ماذا أفعل إذا فتح Stirling PDF رغم أن لوحة التحكم تعرض «جارٍ التثبيت»؟
من المرجح أن يكون التطبيق سليمًا، وأن تكون المشكلة في حالة الواجهة الأمامية أو إدارة التطبيقات في ZimaOS.
هل ينبغي أن أحذف AppData الخاص بـ Stirling PDF؟
لا، ليس لمجرد مسح بطاقة التثبيت. انسخ وحدات التخزين الدائمة احتياطيًا قبل إجراء أي تنظيف إتلافي.
هل ينبغي أن أستخدم صورة Stirling الرسمية الحالية؟
نعم. إذا أعدت بناء التطبيق، فاتبع وثائق Docker الحالية من المصدر الأصلي بدلًا من استخدام بيان قديم.
