تشغيل كود Collabora على معالج ARM64 باستخدام الصورة الصحيحة

غالبًا ما يكون سبب خروج حاوية Collabora CODE فورًا على مضيف ARM64 هو استخدام منصة صورة خاطئة، مع العلم أن ARM64 نفسه ليس غير مدعوم بطبيعته. ابدأ بالتحقق من بنية المضيف (عدد البتات)، والبيان المنشور لعلامة الصورة، وأي تجاوزات لمنصة Compose قبل تغيير الأذونات أو إعادة بناء الصورة. بحسب تاريخ 10 أكتوبر 2026، تتضمن صورة CODE الرسمية إصدارات ARM64؛ ويُدرج Docker Hub 26.04.4.2.1علامة linux/arm64.

1. تحديد بنية المضيف وخطأ بدء التشغيل بالتحديد

نفّذ هذه الأوامر على مضيف Docker، وليس داخل حاوية Collabora المتوقفة. استبدل هذا collaboraالاسم إذا كانت خدمة Compose الخاصة بك تستخدم اسمًا آخر.

uname -m
docker info --format '{{.Architecture}}'
docker compose ps -a
docker compose logs --tail=100 collabora

عادةً ما يُبلغ مضيف لينكس ARM ذو 64 بت عن معلومات aarch64من خلال uname -m. تشير قيمة مثل armv7lعادةً إلى منصة نواة ARM ذات 32 بت، وهي تختلف عن linux/arm64. قد يستخدم تصنيف بنية Docker تهجئة مختلفة، لذا قارن نوع المضيف، وتكوين Compose، وبيان الصورة بدلاً من مطابقة سلسلة نصية واحدة بشكل آلي.

اقرأ رسالة الخطأ الأولى وحالة الخروج. تعني رسالة "لا يوجد بيان مطابق لـ linux/arm64" أن الوسم المحدد لا يحتوي على متغير مطابق للنظام الأساسي المطلوب. تشير رسالة "خطأ في تنسيق التنفيذ" إلى عدم تطابق في بنية النظام أو فرض نظام أساسي أجنبي بشكل صريح. أما خطأ الأذونات أو إنهاء العملية بسبب نفاد الذاكرة فله سبب مختلف؛ لذا لا تتعامل مع كل حلقة إعادة تشغيل على أنها فشل في التوافق مع ARM.

2. تأكد من أن الوسم ينشر صورة ARM64

افحص الوسم في السجل قبل تغيير المضيف:

docker buildx imagetools inspect collabora/code:26.04.4.2.1

ابحث عن ذلك linux/arm64في قائمة المنصات. في 10 أكتوبر 2026، أظهرت قائمة علامات Docker Hub الرسمية أن هذه المنصة تدعم كلاً من latestو . تُحدد صفحة CODE26.04.4.2.1 الخاصة بـ Collabora بنى x86-64 وppc64 وarm64 كبنى مضيفة مدعومة. يسهل إعادة إنتاج المشكلة باستخدام العلامة ذات الإصدار أثناء استكشاف الأخطاء وإصلاحها. قد تتغير العلامات والبيانات، لذا تحقق من الإصدار المحدد الذي تنوي نشره بدلاً من افتراض أن جميع العلامات السابقة تدعم نفس البنى.

يختار Docker تلقائيًا نسخةً مطابقةً عندما يكون الوسم متعدد المنصات ولا يُغيّر أي تعديل الهدف. يعرض أمر فحص الصور في Docker المنصات المنشورة لصورة السجل.

3. قم بإزالة تجاوز AMD64 واسحب الإصدار الأصلي

تحقق من خدمة Compose المُحَلَّلة، بما في ذلك ملفات التجاوز، للتأكد من عدم وجود تجاوز إجباري platform: linux/amd64. يمكن لمتغير Docker CLI DOCKER_DEFAULT_PLATFORMأيضًا تعيين النظام الأساسي الافتراضي للأوامر التي تقبل علامة النظام الأساسي. platformيحدد حقل Compose نظام التشغيل والبنية المستهدفة بشكل صريح، لذا قم بإزالة أي تجاوز غير صحيح أو عيّنه إلى ARM64. إذا كان لديك تجاوز إجباري jq، فافحص الإعدادات المدمجة دون طباعة قيم البيئة غير ذات الصلة. docker compose config --format json | jq '.services.collabora | {image, platform}'يُعرّف مرجع خدمة Compose هذا الحقل. DOCKER_DEFAULT_PLATFORMموثق في مرجع Docker CLI .

services:
  collabora:
    image: collabora/code:26.04.4.2.1
    platform: linux/arm64

هذا جزء من التعليمات البرمجية: ادمج سطري الصورة والمنصة في خدمتك الحالية مع الاحتفاظ بالإعدادات المطلوبة. إذا كان Docker يختار بيان ARM64 الأصلي بشكل صحيح، platformفسيكون هذا السطر اختياريًا. استبدله collaboraفي الأوامر أدناه إذا كان لخدمة Compose الخاصة بك اسم آخر.

docker compose pull collabora
docker compose up -d --force-recreate collabora

استخدم الوسم المُثبّت كما هو موضح، أو إصدارًا آخر تحققت من بياناته. latest-arm64يُدرج Docker Hub هذا الوسم أيضًا، لكن محتوياته تتغير مع تغير الإصدارات. يُسهّل تثبيت إصدار معين عملية التراجع والمقارنة اللاحقة. تجنّب فرض linux/amd64استخدام المحاكاة كحل أولي عند توفر صورة ARM64 أصلية؛ فالمحاكاة تُضيف عبئًا إضافيًا وتجعل تشخيص بدء التشغيل أقل وضوحًا.

4. تشخيص الأعطال غير المتعلقة بالبنية، ثم التحقق من بدء التشغيل

إذا كانت الصورة الأصلية لا تزال موجودة، فاستخدم السجل والحالة بدلاً من توسيع صلاحيات الحاوية:

استخدم اسم الحاوية أو المعرّف الموضح docker compose ps -aلفحص حالة خروجها:

docker inspect --format 'status={{.State.Status}} exit={{.State.ExitCode}} oom={{.State.OOMKilled}} error={{.State.Error}}' CONTAINER

تُوثّق Docker عمليات فحص الحاويات وسجلاتها لهذه الفحوصات. لا تقم بحذف وحدات التخزين الدائمة أو منح الحاوية بأكملها صلاحيات مميزة لمجرد اختبار مشكلة في بنية النظام.

تحقق من الصورة المسحوبة والخدمة قيد التشغيل

تأكد من أن الصورة المحلية تُظهر بنية النظام المستهدف:

docker image inspect collabora/code:26.04.4.2.1 --format '{{.Os}}/{{.Architecture}}'

القيمة المتوقعة هي linux/arm64. ثم تحقق docker compose ps -aمن حالة التشغيل المستقرة وراجع أحدث السجلات بحثًا عن أخطاء بدء التشغيل الجسيمة. بمجرد اتصال الحاوية بمنصة التخزين أو الخادم الوكيل العكسي، اطلبها /hosting/discoveryعبر عنوان URL المُكوّن لـ Collabora وافتح مستندًا تجريبيًا. أعد التحقق من قائمة علامات السجل قبل التحديثات، لأن الإصدارات المتاحة وبيانات النظام الأساسي قابلة للتغيير.