Как Docker работает на macOS и Windows
На этой странице
Linux-контейнерам нужно ядро Linux, поэтому на macOS и Windows Docker запускает лёгкую Linux-VM, а контейнеры работают внутри неё. На Windows это обычно WSL 2, на macOS — VM через Apple Virtualization Framework. Отсюда главные особенности: bind mount файлов с хоста работает медленнее, чем на Linux; localhost контейнера — это не хост; на Apple Silicon образы по умолчанию собираются под arm64.
Вопрос
Как Docker работает на macOS и Windows и какие из этого следуют особенности?
Основная идея
macOS / Windows
└── Docker Desktop
└── Linux-VM (WSL 2 / Virtualization.framework)
└── dockerd
├── контейнер api
└── контейнер dbCLI работает на хосте и общается с демоном внутри VM. Docker Desktop прозрачно пробрасывает порты (-p 3000:3000 доступен на localhost хоста) и файлы (bind mounts).
Производительность bind mounts
На Linux bind mount — просто монтирование каталога, почти без накладных расходов. На macOS и Windows файлы должны пересечь границу VM:
npm installв примонтированную папку проекта может быть в разы медленнее;- file watchers (Vite, Nuxt) иногда не получают события изменений.
Что помогает:
- держать
node_modulesв анонимном или именованном volume, а не на хосте; - на Windows хранить проект внутри файловой системы WSL (
\\wsl$\Ubuntu\home\...), а не наC:\; - на macOS включить VirtioFS (по умолчанию в новых версиях Docker Desktop) или использовать OrbStack;
- использовать
docker compose watchвместо bind mount; - если watcher не видит изменений — включить polling (
CHOKIDAR_USEPOLLING=true,server.watch.usePollingв Vite).
Доступ к хосту из контейнера
Внутри контейнера localhost — сам контейнер. Чтобы обратиться к сервису, запущенному на хосте (например, к локальному API на порту 4000), используют специальное имя:
curl http://host.docker.internal:4000На macOS и Windows оно работает из коробки, на Linux его добавляют явно:
services:
app:
extra_hosts:
- "host.docker.internal:host-gateway"Архитектура: Apple Silicon
Mac на M-чипах — это arm64. Образ, собранный на нём, по умолчанию тоже arm64, а большинство серверов — amd64:
exec /usr/local/bin/node: exec format errorРешение — собирать под нужную платформу (--platform linux/amd64) или сразу мультиплатформенно через buildx — см. урок про сборку под разные платформы.
Ресурсы VM
VM получает ограниченную память и CPU (настраиваются в Docker Desktop или в .wslconfig). Если контейнеры падают с OOM или сборка тормозит, проверь лимиты именно VM, а не только --memory контейнера.
Частые ошибки
- Ждать от bind mount на macOS той же скорости, что на Linux.
- Держать проект на
C:\при работе через WSL 2. - Обращаться из контейнера к сервису на хосте через
localhost. - Собрать образ на M-чипе и задеплоить на
amd64-сервер без указания платформы.
Что важно помнить
- На macOS и Windows всегда есть промежуточная Linux-VM — это объясняет большинство «странностей».
host.docker.internal— способ достучаться до хоста; на Linux нуженhost-gateway.- Архитектуру образа нужно контролировать явно, если разработка на
arm64, а production наamd64.
Мини-шпаргалка
- macOS/Windows: контейнеры живут в Linux-VM.
- Медленные bind mounts → volume для
node_modules, WSL FS,compose watch. - Хост из контейнера:
host.docker.internal. - Apple Silicon:
--platform linux/amd64илиbuildx.
Документация
Docker Desktop: WSL 2 backend, Docker Desktop: Networking, Docker: Multi-platform builds.