حلّ المجتمع

إصلاح مشكلة عدم العثور على Docker 24.0.7 في مُثبّت CasaOS على Ubuntu 24.04

A November 2025 CasaOS installation on Ubuntu 24.04 failed because the installer searched Docker's repository for the removed Docker CE 24.0.7 package even though Docker 29.0.1 was already installed. The installer was later updated to work with current Docker packages.

إذا توقف برنامج تثبيت CasaOS على Ubuntu 24.04 مع ERROR: '24.0.7' not found amongst apt-cache madison results؛ فالخطأ ناتج عن عدم توافق تاريخي بين برنامج التثبيت وإصدار Docker، وليس عن حزمة Ubuntu مفقودة ينبغي إجبار النظام على إعادة تثبيتها. وقد أعاد تقرير مجتمع IceWhale الصادر في نوفمبر 2025 إنتاج الفشل على جهاز جديد يعمل بنظام Ubuntu 24.04 LTS، رغم أن Docker 29.0.1 كان مثبتًا ويعمل بالفعل.

الحد الزمني المهم هو أن هذا الخلل المحدد في برنامج التثبيت عولج لاحقًا. ففي ديسمبر 2025، أفاد مشرفو CasaOS بأن نص التثبيت قد حُدّث لتثبيت أحدث إصدار متاح من Docker Engine بدلًا من تثبيت Docker 24.0.7، ولتطبيق معالجة توافق واجهة برمجة تطبيقات Docker مع الإصدارات الأحدث من Docker. ولم يعد نص تثبيت CasaOS الحالي يُظهر الجزء القديم المشفّر 24.0.7 التبعية التي ظهرت في الموضوع الأصلي.

كيف بدا خطأ برنامج تثبيت CasaOS الأصلي

ثبّت مؤلف المقال من المجتمع CasaOS باستخدام:

curl -fsSL https://get.casaos.io | sudo bash

وحاول أيضًا:

export INSTALL_DOCKER=false

لكن برنامج التثبيت دخل مع ذلك مرحلة تبعيات Docker وبحث في مستودع APT الخاص بـ Docker عن إصدار محدد واحد:

INFO: Searching repository for VERSION '24.0.7'
apt-cache madison docker-ce | grep '24.0.7'
ERROR: '24.0.7' not found amongst apt-cache madison results

كان Docker Engine 29.0.1 مثبتًا بالفعل على المضيف. وحدث الفشل قبل أن تتمكن CasaOS من إكمال التثبيت، لأن مستودع Noble الخاص بـ Docker لم يعد يحتوي على إصدار الحزمة الذي كان يتوقعه النص التاريخي.

لماذا تعذّر على Ubuntu 24.04 العثور على Docker CE 24.0.7

كان برنامج التثبيت التاريخي يطلب فعليًا من مستودع Docker الخاص بـ Ubuntu 24.04 إصدار حزمة لم يعد متاحًا فيه. وقد أدى تشغيل:

apt-cache madison docker-ce

أكّد عدم وجود إدخال مطابق للإصدار 24.0.7.

وصف عضو المجتمع gelbuilding هذا بشكل صحيح بأنه عدم توافق زمني بين برنامج التثبيت ومستودع حزم Docker. وفي ذلك الوقت، اقتُرح استخدام توزيعة أقدم مدعومة، مثل Ubuntu 22.04 أو Debian 12، كحل مؤقت بأقل قدر من التعقيد ريثما يتم تحديث برنامج التثبيت.

ما الذي غيّرته CasaOS بعد إخفاق 2025

أفادت مناقشة لاحقة على GitHub حول حادثة توافق Docker نفسها بأن نص التثبيت قد أُصلح. ووُصف السلوك المحدّث كما يلي:

  • تثبيت أحدث إصدار متاح من Docker Engine بدلًا من Docker 24.0.7؛
  • تطبيق تجاوز لتوافق واجهة برمجة تطبيقات Docker مع الإصدارات الحديثة من Docker؛
  • السماح لخدمات CasaOS وإدارة التطبيقات المضمّنة بالعمل مع إصدارات Docker الأحدث.

يحدّد مصدر المُثبّت الحالي أيضًا حدًا أدنى لإصدار Docker الرئيسي، بدلًا من تثبيت إصدار Docker CE 24.0.7 بشكل ثابت. يمكنك مراجعة البرنامج النصي الحالي لمُثبّت CasaOS.

طريقة تثبيت CasaOS الحالية

لا يزال مستودع CasaOS الحالي يوثّق المُثبّت القياسي ذي السطر الواحد:

curl -fsSL https://get.casaos.io | sudo bash

أو:

wget -qO- https://get.casaos.io | sudo bash

راجع تعليمات تثبيت CasaOS الحالية على GitHub.

لا تُخفّض إصدار Docker إلى 24.0.7 باعتباره الحل الأول اليوم

عندما كُتب منشور المجتمع، كان البحث عن طريقة لاستعادة Docker 24.0.7 مفهومًا لأن المُثبّت كان يطلب ذلك الإصدار صراحةً. وبعد تحديث المُثبّت نفسه، فإن فرض تثبيت حزمة Docker قديمة على أوبونتو 24.04 يكون عادةً خطوة أولى خاطئة.

قد يؤدي خفض إصدار Docker إلى مشكلات أخرى في التوافق والأمان، كما أن خلط إصدارات أوبونتو أو مستودعات الحزم لإحياء إصدار تاريخي واحد قد يترك المضيف في حالة حزم غير مدعومة.

للتثبيت الحالي، ابدأ بمُثبّت CasaOS الحالي وبحالة مستودع Docker الحالية.

كيفية التحقّق مما إذا كنت لا تزال تستخدم مُثبّتًا قديمًا

إذا كنت لا تزال ترى:

البحث في المستودع عن VERSION ‏'24.0.7'

فأنت على الأرجح تنفّذ مُثبّتًا أقدم أو مخزّنًا مؤقتًا أو معكوسًا أو معدّلًا أو تابعًا لجهة خارجية، وليس البرنامج النصي الحالي.

تحقّق من مصدر البرنامج النصي. تجنّب نسخ برنامج نصي قديم casaos-install.sh من مرفق في منتدى أو مستودع أتمتة قديم، بينما يتوفر البرنامج النصي الحالي من المصدر الأساسي.

ماذا لو كان Docker مثبتًا بالفعل؟

كان لدى المؤلف الأصلي Docker 29.0.1 مثبتًا بالفعل. ينبغي للمُثبّت الحالي اكتشاف تثبيت Docker مقبول والعمل معه، بدلًا من طلب الحزمة القديمة المذكورة في موضوع المصدر.

قبل تثبيت CasaOS، تحقّق من الآتي:

docker --version
docker version
systemctl status docker

إذا كان Docker يعمل بشكل سليم، لكن تثبيت CasaOS الحالي لا يزال يفشل، فاحفظ مخرجات المُثبّت الكاملة قبل إزالة Docker. قد يكون سبب الفشل الحالي مختلفًا عن الخلل التاريخي في الإصدار 24.0.7.

أوبونتو 24.04 ليس هو نفسه المضيف الموصى به الأكثر تحفظًا من CasaOS

يسرد مستودع CasaOS الحالي Debian 12 كنظام تشغيل مختبَر وموصى به، ويسرد بشكل منفصل منصات أخرى مدعومة أو مختبَرة من المجتمع. يمكن أن تعمل تثبيتات Ubuntu، لكن مستوى الاختبار الدقيق يختلف باختلاف الإصدار.

إذا كنت تبني خادمًا منزليًا للاستخدام الإنتاجي وتريد تقليل وقت استكشاف الأخطاء وإصلاحها، فاستخدم نظام تشغيل مضيفًا تدرجه CasaOS صراحةً ضمن الأنظمة المختبرة أو الموصى بها، بدلًا من افتراض أن كل إصدار جديد من Ubuntu سيحصل على تحقق فوري من المثبّت.

لا تعطل التحقق من TLS لمعالجة خطأ غير مرتبط بالمثبّت

شهد CasaOS حوادث تاريخية منفصلة تتعلق بالشهادة على get.casaos.io. مشكلة شهادة TLS تختلف عن مشكلة حزمة Docker 24.0.7.

إذا كان curl يعرض خطأ في التحقق من الشهادة، فلا تضف تلقائيًا -k أو عطّل التحقق من الشهادات على مستوى النظام. فهذا يغيّر نموذج الثقة لتنزيل المثبّت، ولا ينبغي دمجه مع استكشاف أخطاء حزم Docker وإصلاحها.

سير عمل استكشاف الأخطاء وإصلاحها الحالي

  1. تحقق من نظام تشغيل المضيف وبنيته.
  2. شغّل docker --version وتأكد من أن Docker يعمل بشكل سليم إذا كان مثبتًا بالفعل.
  3. استخدم المثبّت الحالي من get.casaos.io، وليس نسخة محلية قديمة.
  4. إذا ظل الناتج يطلب Docker 24.0.7 صراحةً، فتوقّف وتحقق من مصدر البرنامج النصي.
  5. لا تضف مستودعات Ubuntu القديمة لمجرد استعادة Docker 24.0.7.
  6. لا تُعد إصدار Docker إلى إصدار أقدم قبل التأكد من وجود متطلب توافق حالي.
  7. احفظ سجل المثبّت الكامل إذا فشل البرنامج النصي الحالي لسبب آخر.

الأسئلة الشائعة حول مثبّت CasaOS لـ Docker 24.0.7

لماذا قال CasaOS إن Docker CE 24.0.7 غير موجود؟

كان المثبّت التاريخي يبحث صراحةً في مستودع Docker عن ذلك الإصدار. وبحلول نوفمبر 2025، لم يعد مستودع Ubuntu 24.04 Noble يوفّره، لذا توقّف التثبيت.

هل لا يزال مثبّت CasaOS الحالي يتطلب Docker 24.0.7؟

لم يعد مصدر المثبّت الحالي في المنبع يعرض متطلب Docker 24.0.7 الثابت القديم، وأفاد مشرفو CasaOS في ديسمبر 2025 بأن المثبّت حُدّث لاستخدام أحدث إصدار متاح من Docker Engine مع معالجة التوافق.

هل ينبغي أن أثبّت Docker 24.0.7 يدويًا؟

ليس باعتباره الإصلاح الحالي المعتاد. كان ذلك هدفًا لحزمة تاريخية. ابدأ بالمثبّت الحالي وحزم Docker الحالية.

هل يمكن لـ CasaOS العمل مع إصدارات Docker الأحدث؟

كان عمل التثبيت والتوافق الذي أُنجز بعد حادثة عام 2025 يهدف تحديدًا إلى تمكين CasaOS من العمل مع إصدارات Docker الحديثة. إذا فشل إصدار حالي، فشخّص خطأ واجهة API أو الخدمة بدقة بدلًا من افتراض أن كل إصدار حديث من Docker غير مدعوم.