Запустите Collabora CODE на 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

64-битная ARM Linux-платформа обычно использует значение aarch64` uname -m.`. Значение, например, `.`, armv7lобычно указывает на 32-битную платформу ядра ARM, которая отличается от linux/arm64`.`. В метке архитектуры Docker может использоваться другое написание, поэтому сравнивайте тип хоста, конфигурацию Compose и манифест образа, а не сопоставляйте одну строку механически.

Прочитайте первое сообщение о критической ошибке и состояние завершения. «No matching manifest for linux/arm64» означает, что для выбранного тега нет соответствующего варианта для запрошенной платформы. «Exec format error» указывает на несоответствие архитектуры или явно заданную чужую платформу. Ошибка доступа или завершение процесса из-за нехватки памяти имеют другую причину; не следует рассматривать каждый цикл перезапуска как сбой совместимости с 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 и откройте тестовый документ. Перед обновлением перепроверьте список тегов реестра, поскольку доступные версии и манифесты платформы могут измениться.