Альфа-версия. Возможны ошибки. noHuman Team запускает ИИ-сотрудников на вашем компьютере с настоящим доступом к файлам, браузеру и рабочему столу. Начинайте с задач, где ошибка не страшна, и не отключайте очередь одобрений. Что пока не работает

Назад в блог
Обложка статьи «Docker для ИИ-агентов: руководство для начинающих»
8 мин чтенияНачало работы

Docker для ИИ-агентов: руководство для начинающих

Docker для ИИ-агентов простыми словами: что такое контейнеры, зачем они нужны, как установить Docker и как управлять ресурсами компьютера.

Автор:

Опубликовано · Обновлено

Вы скачали инструмент с ИИ-агентом, и где-то в инструкции по установке написано: «требуется Docker».

Docker упаковывает процесс и определяет, какие файлы, процессы и сети ему видны. Он может ограничить доступ ИИ-агента к остальной системе, но граница зависит от конфигурации. Папки хоста, подключённые на чтение и запись, по-прежнему можно изменить, а привилегированный доступ может открыть гораздо больше, чем собственные файлы контейнера.

Docker Desktop доступен для поддерживаемых версий macOS, Windows и Linux. Время установки и требования к ресурсам зависят от компьютера и нагрузки.

Для noHuman Team Docker не нужен. Нынешняя версия приложения для компьютера работает на macOS и Windows, подробнее об этом ниже.

Если вы не разработчик, фраза «требуется Docker» может отпугнуть. Docker звучит как инфраструктура, а инфраструктура — как что-то сложное.

Кратко
  • Контейнеры Docker изолируют процессы и файловую систему средствами операционной системы
  • У контейнеров часто меньше накладных расходов, чем у виртуальных машин, но производительность зависит от хоста, нагрузки и конфигурации Docker Desktop
  • Docker сокращает доступ только тогда, когда подключённые папки, привилегии, сети, секреты и доступ к демону настроены безопасно
  • noHuman Team запускает нативных сотрудников без Docker; её средства контроля учётных данных и одобрений не создают песочницу для файловой системы
  • Разбирайтесь с нагрузкой по журналам и метрикам ресурсов Docker, а не полагайтесь на одну универсальную настройку памяти
  • Становиться специалистом по контейнерам не нужно, но понимать, какие папки подключает инструмент и какие привилегии получает, необходимо

Хорошая новость: Docker проще, чем кажется. Нужно установить одно приложение и понять одну идею. Это руководство простыми словами объясняет Docker, показывает, зачем он ИИ-агентам, проводит через установку и помогает исправить самые частые проблемы.

Что такое Docker (простыми словами)

Docker запускает упакованные процессы в контейнерах, откуда видна только часть операционной системы.

У контейнера своя видимая файловая система, пространство имён процессов, программы и сетевая конфигурация. Контейнеры Linux работают на одном ядре с хостом или с виртуальной машиной Docker Desktop. Они также видят файлы хоста, устройства, службы и секреты, которые вы им явно открыли.

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

Представьте многоквартирный дом:

  • Компьютер — это дом
  • Каждый контейнер Docker — это квартира
  • У квартир общие электричество и водопровод (процессор, оперативная память), но у каждой свои замки, мебель и планировка
  • Общие подъезды, коммуникации и ключи — это подключённые папки, сети, ядро и привилегии; неудачная конфигурация может соединить квартиры
  • Квартиры можно добавлять и убирать, не перестраивая дом

Почему это важно для ИИ-агентов: контейнер может сузить набор файлов и сервисов, доступных коду, который запускает агент. Ущерб ограничен лишь настолько, насколько ограничены подключённые папки, учётные данные, сети, привилегии и внешние действия.

Контейнеры и виртуальные машины

ХарактеристикаВиртуальная машинаКонтейнер
ЯдроОтдельное гостевое ядроОбщее ядро хоста или виртуальной машины Docker Desktop
Типичные накладные расходыВышеНиже
Граница изоляцииКак правило, надёжнееСильно зависит от среды выполнения и конфигурации
СовместимостьЗапускает полноценную гостевую операционную системуУпаковывает приложения для совместимой среды выполнения контейнеров
Когда подходитБолее надёжное разделение нагрузокЭффективная упаковка и изоляция процессов в нужных пределах

Для многих задач с агентами контейнеры полезны. Но если речь идёт о враждебном коде или строгой границе между арендаторами, используйте виртуальную машину или более надёжную песочницу.

noHuman Team и Docker

Ранние версии noHuman Team запускали каждого агента в контейнере Docker. Нынешнее нативное приложение для macOS и Windows запускает по одному управляемому процессу на каждого агента, с общим рабочей папкой команды и без Docker. Для подключений Claude и ChatGPT, которыми управляет шлюз, сотрудники работают с заглушкой вместо настоящих учётных данных, а авторизацию у провайдера добавляет локальный шлюз. При локальном входе и резервных подключениях настоящие учётные данные могут храниться в файлах сотрудника. Сотрудники работают с правами вашей учётной записи в операционной системе, а одобрения и бюджеты песочницу для файловой системы не создают. Подробнее об этих пределах доступа читайте в руководстве по аккаунтам ИИ-сервисов.

Установка Docker Desktop

Docker Desktop — самый простой способ запустить Docker. Это одно приложение, которое берёт на себя всё необходимое.

macOS

  1. Скачайте Docker Desktop на странице docker.com/products/docker-desktop
  2. Откройте файл .dmg и перетащите Docker в «Программы»
  3. Запустите Docker Desktop
  4. Подождите, пока значок Docker в строке меню не покажет «Docker Desktop is running»
  5. Проверьте: docker --version

Совет по ресурсам: начните с поддерживаемых значений по умолчанию в Docker Desktop, запустите типичную задачу агента и по метрикам Docker подберите память и процессор так, чтобы не лишить ресурсов сам компьютер.

Windows

  1. Включите WSL 2: откройте PowerShell от имени администратора, выполните wsl --install и перезагрузите компьютер
  2. Скачайте Docker Desktop и запустите установщик (оставьте включённым «Use WSL 2»)
  3. Запустите Docker Desktop
  4. Проверьте: docker --version

Windows Home и Pro: Docker Desktop работает в обеих редакциях — в Home всё берёт на себя WSL 2.

Linux

# Ubuntu/Debian — Docker Engine (lighter, CLI-only)
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# Log out and back in, then verify:
docker --version

Частые проблемы Docker и их решения

«Docker daemon is not running»

Решение: запустите Docker Desktop. Подождите, пока значок с китом не замрёт.

Контейнер сразу завершается

Решение: проверьте журналы контейнера: docker logs <container-name>. У ИИ-агентов самая частая причина — не указан API-ключ.

«Port already in use»

Решение: измените проброс портов в файле Docker Compose: используйте 8081:8080 вместо 8080:8080.

Контейнеры работают медленно

Решение: проверьте docker stats, журналы контейнеров, нагрузку на память хоста, активность диска, использование браузера и задержки сети. Меняйте ресурсы, только выяснив, где узкое место.

Нехватка памяти — лишь одна из возможных причин медленной работы или сбоев контейнеров. Процессы браузера, сборки, нехватка места на диске, сбои сети и циклы повторов могут вызывать похожие симптомы, поэтому сначала изучите метрики и журналы.

«No space left on device»

Решение: посмотрите, сколько места занято, командой docker system df и определите, что можно безопасно удалить. Команда docker system prune удаляет неиспользуемые данные Docker; прежде чем продолжить, прочитайте её запрос и параметры. Очистка по фиксированному расписанию не заменяет проверку того, что занимает место.

Управление ресурсами: оперативная память и процессор для ИИ-агентов

ИИ-агентам в контейнерах Docker не нужны огромные ресурсы: тяжёлые вычисления выполняются на серверах провайдера API. В контейнере работают среда выполнения агента, иногда браузер и несколько локальных инструментов.

Измерьте реальную нагрузку

Сколько памяти и процессора расходует агент, зависит от среды выполнения, вкладок браузера, инструментов разработки, одновременных задач и места, где работает модель. Надёжной универсальной цифры для какого-то числа агентов нет.

Запустите типичную задачу и запишите:

  • Пиковый и фоновый расход памяти по каждому контейнеру
  • Нагрузку на процессор во время сборок и работы в браузере
  • Рост занятого места на диске из-за образов, кэшей, журналов и профилей
  • Нагрузку на память хоста, пока контейнеры активны
  • Приводят ли лимиты ресурсов к перезапускам или сбоям в работе

Запустите docker stats, чтобы увидеть текущую нагрузку на процессор и память по каждому контейнеру. Прежде чем приписывать скачок браузеру или менять лимит, сопоставьте его с журналами и выполняемой задачей.

Docker — это сантехника, а не навык

Помогает взглянуть на это иначе: «учить Docker» не нужно. Достаточно установить его и дать ИИ-инструментам им пользоваться.

Docker — это сантехника. Чтобы пользоваться раковиной, не нужно разбираться в диаметрах труб. Хорошая среда выполнения полностью скрывает Docker: вы настраиваете агентов в панели управления, а контейнерами занимается среда. (noHuman Team пошла ещё дальше и отказалась от контейнеров в пользу нативных процессов, так что её пользователи с Docker не встречаются вовсе.) Нужно лишь знать, где находится запорный вентиль (Docker Desktop → Quit), как проверить, нет ли засора (журналы контейнера), и когда звать сантехника (Stack Overflow).

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

Частые вопросы

Нужен ли Docker для запуска ИИ-агентов? Зависит от инструмента. Многие серверные фреймворки для агентов и те, что вы размещаете сами, используют его для упаковки и изоляции процессов. noHuman Team — нет: это нативное приложение для macOS и Windows, которое запускает управляемые процессы с отдельным рабочим состоянием и профилями браузера. Её средства контроля учётных данных, одобрений и бюджета не создают границу файловой системы на уровне контейнера.

Сколько оперативной памяти нужно Docker для ИИ-агентов? Универсального значения нет. Важны код среды выполнения, браузеры, сборки, число одновременных задач и накладные расходы Docker Desktop. Уточните текущие требования фреймворка, запустите типичную нагрузку и по docker stats и метрикам хоста задайте лимиты, которые оставляют хосту достаточно ресурсов.

Что такое контейнер Docker простыми словами? Контейнер Docker — это упакованный процесс со своей видимой файловой системой, пространством имён процессов и сетевой конфигурацией. Он работает на одном ядре с хостом Linux или с виртуальной машиной Docker Desktop. И он может влиять на файлы хоста и внешние системы, которые вы открыли через подключённые папки, привилегии, учётные данные или сети.

Безопасно ли использовать Docker для ИИ-агентов? Docker может ограничить доступ агента, если защита контейнера усилена. Проверьте подключённые папки, доступ к сокету Docker, привилегированный режим, привилегии, устройства, сети, секреты, лимиты ресурсов и обновления. Если код враждебный или последствия побега неприемлемы, используйте более надёжную границу.

Как исправить медленную работу Docker с ИИ-агентами? Проверьте docker stats, журналы контейнеров, нагрузку на память хоста, использование диска, задержки сети и поведение агента при повторах. Меняйте по одному лимиту за раз и каждый раз повторяйте типичную задачу. Прежде чем запускать команду очистки, посмотрите, какие данные не используются.


Главное

  • Docker даёт полезную изоляцию процессов, но реальная граница зависит от конфигурации
  • У контейнеров часто меньше накладных расходов, чем у виртуальных машин; не полагайтесь на универсальное соотношение производительности
  • Подключённые папки, доступ к сокету Docker, привилегии, сети, устройства и секреты определяют, до чего может добраться агент
  • Проблемы с ресурсами диагностируйте по метрикам и журналам, прежде чем менять лимиты или удалять неиспользуемые данные
  • Изучите Docker настолько, чтобы понимать, какие папки подключает агентский инструмент, какие разрешения и сеть использует и как выполняет очистку

Установите noHuman Team — нативную команду для macOS и Windows. Ежемесячная подписка начинается с пробного периода на 7 дней; при оформлении нужны платёжные данные. Провайдер ИИ берёт плату отдельно.

Поделиться: X / Twitter