OrbStack — быстрая и лёгкая замена Docker Desktop для Mac

OrbStack — приложение для macOS, которое запускает Docker-контейнеры, Linux-машины и локальный одноузловой Kubernetes-кластер (систему оркестрации контейнеров). Оно совместимо с привычными инструментами Docker и подходит для локальной разработки на Apple Silicon и поддерживаемых Mac с процессорами Intel.

Материал сверён по официальной документации и журналу изменений по состоянию на 2 сентября 2026 года. На странице журнала последняя указанная версия — 2.2.3 от 7 августа 2026 года; в версии 2.2.2 от 2 августа 2026 года Kubernetes обновлён до версии 1.35.

Содержание

1. Среды, которые запускает OrbStack: область применения
2. Интеграция Docker и ключевые возможности: инструменты, домены и интеграции
3. Установка и миграция: установка и перенос данных
4. Проверка Docker: минимальный проверочный запуск
5. Linux-машины: создание, архитектуры и резервные копии
6. Локальный Kubernetes: запуск и сетевой доступ
7. Полезные сценарии: задачи и проверяемые результаты
8. Ограничения: совместимость и компромиссы
9. Официальные ссылки: документация и журнал изменений

Среды, которые запускает OrbStack

OrbStack объединяет три локальные среды:

• Docker Engine для контейнеров, Docker Compose и Buildx;
• лёгкие Linux-машины с разными дистрибутивами;
• управляемый одноузловой Kubernetes-кластер для разработки.

Документация описывает OrbStack как приложение для macOS. Linux-дистрибутивы в этом контексте запускаются внутри него как машины.

По документации приложение запускается примерно за две секунды, использует мало CPU и дискового пространства в простое, а также оптимизирует сеть и файловую систему. Реальный результат зависит от модели Mac, рабочей нагрузки и настроек.

Интеграция Docker и ключевые возможности

Docker CLI, Compose и Buildx

OrbStack включает Docker CLI, то есть командную строку Docker, Docker Compose для запуска связанных контейнеров и Buildx для сборки образов. Обычные команды Docker, Compose и существующие Dockerfile можно использовать в этом окружении:

docker ps
docker compose up -d
docker build -t my-app .
docker logs -f my-container

Docker Desktop и OrbStack можно оставить установленными одновременно. Для выбора движка используются контексты Docker — профили подключения к конкретному Docker Engine:

# Переключиться на OrbStack
docker context use orbstack

# Вернуться к Docker Desktop
docker context use desktop-linux

Переключение контекста влияет на последующие команды Docker.

Автоматические локальные домены

Для поддерживаемых контейнеров и сервисов доступны автоматические доменные имена в зоне orb.local. Точное имя зависит от контейнера, проекта Compose и настроек домена.

Интерфейс для контейнеров и сборок

В интерфейсе доступны контейнеры, образы, тома, журналы и показатели нагрузки. В версии 2.0 появились файловый менеджер, встроенный терминал и графики Activity Monitor; в версии 2.2.3 добавлена вкладка Builds с историей сборок Docker, шагами и журналами.

Файлы, сеть и SSH

Linux-машины интегрированы с macOS:

• файлы Mac доступны внутри машины по пути /mnt/mac;
• файлы Linux видны на Mac в ~/OrbStack и через Finder;
• SSH-агент Mac автоматически передаётся в обычные Linux-машины;
• встроенный SSH-сервер маршрутизирует подключения к машинам;
• поддерживаются VPN-сценарии, включая Tailscale и WireGuard.

Для изолированных машин передача SSH-агента включается отдельно.

Запуск программ x86 на Apple Silicon

На Apple Silicon OrbStack использует Rosetta для запуска Linux-машин и программ архитектуры x86_64 или amd64:

orb create --arch amd64 ubuntu intel-dev

Для запуска отдельных x86-программ в ARM-машине могут потребоваться библиотеки multi-arch. Поддержка зависит от выбранного дистрибутива.

Установка и миграция

Скачайте приложение с официального сайта OrbStack, установите его в Applications и запустите.

OrbStack добавляет команды orb и orbctl. В комплект также входят поставляемые OrbStack версии Docker CLI, Compose, Buildx и kubectl. При запуске приложения эти инструменты автоматически устанавливаются, если их ещё нет в системе. Если они уже установлены через Docker Desktop, Homebrew или другой источник, OrbStack оставляет их без изменений.

Проверьте выбранный Docker-контекст:

docker context use orbstack
docker context show

Ожидаемый результат — orbstack.

Перенос данных из Docker Desktop

После установки OrbStack предлагает скопировать данные Docker Desktop, включая контейнеры, тома, образы и другие данные. Миграция необязательна. Её можно запустить позже через меню File > Migrate Docker Data или командой:

orb docker migrate

Миграция создаёт копию исходных данных.

⚠️ Сначала проверьте контейнеры, образы и тома в OrbStack. Старые данные Docker Desktop удаляйте только после такой проверки.

docker ps -a
docker image ls
docker volume ls

Проверка Docker

Для минимальной проверки создайте веб-контейнер:

docker context use orbstack
docker run --rm -d --name orbstack-check -p 8080:80 nginx
curl -I http://localhost:8080

Наблюдаемый признак успеха — curl получает HTTP-заголовки от Nginx. После проверки остановите контейнер:

docker stop orbstack-check

Это пример проверочного запуска. Фактическое выполнение команд при подготовке материала не проводилось.

Проекты Compose запускаются обычной командой:

docker compose up -d
docker compose ps
docker compose logs --tail=50

Проверяйте состояние сервисов, журналы и ответ приложения на локальном порту или домене orb.local.

Linux-машины

OrbStack запускает полноценные Linux-машины с разными дистрибутивами. Доступный список выпусков меняется, поэтому перед созданием машины сверяйтесь с разделом Distributions в официальной документации.

Создание и вход в Ubuntu-машину:

orb create ubuntu my-dev
orb -m my-dev

Можно создать конкретный выпуск дистрибутива:

orb create ubuntu:jammy my-dev

Выполнение одной команды без интерактивного входа:

orb -m my-dev -- uname -a

Перенос и ограничение ресурсов

Машину можно экспортировать в файл для резервного копирования или переноса на другой Mac:

orb export my-dev my-dev.tar.zst

Импорт копии выполняется так:

orb import -n restored-dev my-dev.tar.zst

При создании машины можно ограничить память, число процессоров и размер диска:

orb create --memory 4G --cpus 2 --disk 64G ubuntu limited-dev

Для существующих машин параметры меняются в интерфейсе или через orb config set:

orb config set machine.limited-dev.memory_mib 4096 # MiB
orb config set machine.limited-dev.cpu 2 # CPU cores
orb config set machine.limited-dev.disk_bytes 68719476736 # bytes

Локальный Kubernetes

OrbStack включает лёгкий одноузловой Kubernetes-кластер для разработки. Он подходит для локальных манифестов и Helm-чартов, которым не требуется многоузловая среда.

Запуск и проверка:

orb start k8s
kubectl get nodes

Успешный результат — один узел в состоянии Ready.

Управление кластером:

orb stop k8s
orb restart k8s
orb delete k8s

⚠️ Команда orb delete k8s удаляет локальный кластер и его состояние. Перед выполнением убедитесь, что нужные манифесты и данные сохранены отдельно.

Kubernetes использует тот же контейнерный движок, что и остальные контейнеры OrbStack. Локально собранные образы доступны подам, то есть группам контейнеров Kubernetes, без отдельного реестра. Для образов с тегом latest Kubernetes всегда пытается загрузить и обновить образ. Используйте другой тег или задайте:

# Параметр контейнера в спецификации Pod
imagePullPolicy: IfNotPresent

Все типы сервисов Kubernetes доступны с Mac напрямую, поэтому проброс портов не требуется. Для сервисов типа LoadBalancer, включая контроллеры Ingress, используется зона *.k8s.orb.local; контроллер Ingress по умолчанию не установлен.

Порты NodePort и LoadBalancer по умолчанию доступны только с localhost. Доступ с устройств локальной сети включается отдельно в OrbStack Settings > Kubernetes через параметр Expose services to local network devices.

Для многоузловых кластеров и дополнительной настройки можно использовать kind или k3d. k3s и minikube можно запускать внутри Linux-машины. Такие конфигурации могут быть менее полно интегрированы с OrbStack и потреблять больше ресурсов.

Полезные сценарии

Локальная разработка проекта Compose

Задача: запустить локальный проект с несколькими сервисами. Условие: в проекте есть рабочий compose.yaml или docker-compose.yml.

docker compose up -d
docker compose ps
docker compose logs --tail=50

Проверяемый результат: нужные сервисы отображаются как запущенные, журналы не содержат критических ошибок, приложение отвечает на локальном порту или домене orb.local.

Ограничение: совместимость конкретного проекта зависит от образов, архитектуры и используемых возможностей Docker.

Проверка приложения в Linux

Задача: проверить Linux-скрипт или серверное приложение в чистой среде. Условие: выбран поддерживаемый дистрибутив и понятны команды установки проекта.

orb create ubuntu test-linux
orb -m test-linux -- uname -a

Проверяемый результат: команда выводит сведения о ядре Linux, после чего можно выполнить установку и проверку приложения внутри машины. Для сервисов используйте init-систему выбранного дистрибутива, например systemd.

Ограничение: графические Linux-приложения по умолчанию не поддерживаются; для них потребуется отдельная настройка XQuartz как X11-сервера или Xrdp.

Тестирование Kubernetes-манифеста

Задача: проверить манифест или Helm-чарт в локальном кластере. Условие: кластер запущен, а манифест не требует нескольких узлов.

orb start k8s
kubectl apply -f deployment.yaml
kubectl get pods
kubectl get svc

Проверяемый результат: нужные поды переходят в состояние Running, команда kubectl get svc показывает созданный сервис, а сервис отвечает выбранным способом. Для NodePort используйте порт из вывода kubectl get svc; для LoadBalancer — адрес в зоне *.k8s.orb.local.

Ограничение: одноузловой кластер не воспроизводит отказы узлов и распределение нагрузки полноценной производственной среды.

Ограничения

• OrbStack предназначен для macOS. OrbStack 2.0, выпущенный 22 августа 2025 года, прекратил поддержку macOS 13. Требования текущего выпуска проверьте перед установкой.
• Встроенный Kubernetes является одноузловым кластером для разработки.
• Вложенная виртуализация KVM на Apple Silicon не поддерживается.
• Графические Linux-приложения не запускаются из коробки.
• Если команда использует плагины или корпоративные политики Docker Desktop, проверьте их совместимость отдельно.
• Конкретные GPU-сценарии не описаны в использованных официальных фрагментах. Если проект требует определённого GPU, проверьте этот сценарий до миграции.
• Условия личного и коммерческого лицензирования могут меняться. Перед использованием в компании сверяйтесь с разделом Licensing официальной документации.

Официальные ссылки

• Сайт OrbStack
• Документация
• Установка и миграция Docker
• Linux-машины
• Kubernetes
• Журнал изменений

OrbStack стоит рассмотреть, если вам нужна единая локальная среда для Docker, Linux и Kubernetes на Mac. Начните с временного переключения Docker-контекста и минимальных проверок, чтобы оценить совместимость проекта, сохранив Docker Desktop установленным.

Если вы выбираете локальную контейнерную среду для проекта или команды, заранее проверьте архитектуру образов, сетевые требования и корпоративные ограничения.

Следующий шаг

Для продолжения работы с контейнерными образами откройте DockerHub — облачный реестр контейнерных образов.

Связанные материалы

• Статья: Как два ИИ-агента и один человек собрали этот сайт за ночь
• Блог: Не гонитесь за инструментами — гонитесь за пониманием
• База знаний: Directus

Этот разбор будет полезен разработчикам и командам, которые выбирают локальную среду для Docker-проектов на Mac и хотят проверить совместимость до миграции.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov