Docker LinuxWindowsmacOS

Docker: no matching manifest for linux/arm64 — несовместимая платформа

  • Обновлено
  • Чтение ≈ 2 минуты

Краткий ответ

Образ не собран под вашу архитектуру. Укажите --platform linux/amd64 или выберите мультиархитектурный образ.

В этой статье
  1. Что означает ошибка
  2. Причины и признаки
  3. Пошаговое решение
  4. Если проблема осталась

#Что означает ошибка

Сообщение
no matching manifest

Образ не собран под вашу архитектуру. Укажите --platform linux/amd64 или выберите мультиархитектурный образ.

#Причины и признаки

Возможная причинаКак узнатьЧто делать
Образ только amd64Для тега опубликован только amd64.Выберите родной ARM-образ, если он есть.
Apple SiliconХост Apple Silicon требует arm64 или эмуляции.Предпочтите arm64; amd64 эмулируйте только осознанно.
Неверный тегНужный тег не существует для платформы.Проверьте манифест образа и список тегов.
Старый образИспользуется устаревший одиночный манифест.Выберите поддерживаемую многоархитектурную публикацию.

#Пошаговое решение

  1. Определите платформу и тег образаВ Linux uname -m покажет архитектуру машины; в Docker Desktop откройте сведения о системе. В терминале выполните docker buildx imagetools inspect ИМЯ:ТЕГ (замените на настоящий образ), чтобы посмотреть опубликованные платформы. Не предполагайте, что тег latest существует для всех процессоров.
  2. Выберите подходящий официальный вариантПосмотрите в документации разработчика поддерживаемый образ/тег с linux/arm64 или многоархитектурным манифестом. Попробуйте docker pull --platform linux/arm64 ИМЯ:ТЕГ только если платформа перечислена. На Apple Silicon предпочтительна родная ARM-сборка.
  3. Эмуляция x86 — лишь альтернативный вариантПри отсутствии arm64-образа можно попробовать docker run --platform linux/amd64 ... при наличии подходящей эмуляции в Docker Desktop или QEMU. Это не эквивалент ARM-образу: возможны ошибки аппаратных зависимостей и замедление. На производственном сервере сначала согласуйте платформу и нагрузку.
  4. Подтвердите платформу запущенного контейнераВыполните docker image inspect ИМЯ:ТЕГ --format "{{.Architecture}}" для загруженного локального варианта и запустите проверенную команду приложения. При повторной ошибке сохраните результат imagetools и платформу хоста — это покажет, существует ли пригодная сборка.

#Если проблема осталась

Если «Docker: no matching manifest for linux/arm64 — несовместимая платформа» повторяется, сохраните время, состояние подключения и точный текст ошибки. Не меняйте сразу несколько настроек — иначе станет трудно понять, какое действие повлияло на результат.

Так эту ошибку тоже называют

Docker: permission denied while trying to connect to the Docker daemon socket — причины и решение Добавьте пользователя в группу docker и перелогиньтесь. Программирование и базы данных Docker Linux Docker: «permission denied … /var/run/docker.sock» — решение Сокет Docker принадлежит группе `docker`. Добавьте пользователя в эту группу (`sudo usermod -aG docker $USER`), перезайдите в систему и проверьте `docker ps`. Помните: д… Программирование и базы данных Docker Linux Cannot connect to the… Docker: Cannot connect to the Docker daemon — причины и решение `Cannot connect to the Docker daemon … Is the docker daemon running?` значит, что клиент `docker` не смог связаться с демоном Docker. Причины: служба не запущена или упа… Программирование и базы данных Docker LinuxWindowsmacOS Docker Desktop: WSL 2 installation is incomplete — причины и решение Не установлен или не обновлён компонент WSL 2. Включите виртуализацию, установите ядро WSL и обновите его командой wsl --update. Программирование и базы данных Docker LinuxWindowsmacOS Docker: port is already allocated — порт уже занят — причины и решение Освободите порт или измените публикацию порта. Программирование и базы данных Docker Linux

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.