Hermes Agent в Docker: что сохранится и какие доступы вы дали

Опубликовано 22.11.20267 мин чтенияСредний
Артемий Миллер в кепке с логотипом Hermes Agent рядом с логотипом Docker и надписью «ДАННЫЕ И ДОСТУПЫ».
Что узнаешь
  • Чем контейнер всего агента отличается от Docker-песочницы команд
  • Как проверить сохранение файла после замены контейнера
  • Какие проверки покажут доступ к чтению и записи в подключённую папку
Средний
3просмотров

В Hermes Agent Docker может запускать весь агент или только среду его команд: во втором случае сам Гермес остаётся на вашем компьютере. При замене контейнера всего агента данные сохраняются в подключённом хранилище /opt/data. Доступ к вашим папкам проверяйте отдельно: какие инструменты и доступы вы ему дали?

Ответа агента «всё готово» недостаточно. Проверьте, что файл читается после замены контейнера, а попытка записи через подключение только для чтения заканчивается отказом.

Весь Гермес в контейнере или только команды - что вы запускаете?

Гермес соединяет модели с вашими файлами, программами, правилами работы. Выберите режим:

РежимГде сам агентГде состояниеЧто охватывает контейнер
Весь Hermes в контейнереВнутри контейнераПодключённый /opt/dataУстановку с выданными ей доступами и подключёнными сервисами
Docker BackendНа хосте - вашем компьютереВ каталоге Hermes на хостеВызовы terminal, file, execute_code выбранной песочницы

Для переноса установки выбирайте первую строку, для команд агента на хосте - вторую. Проверка Docker Backend не охватывает прочие инструменты и подключения агента.

Это 2 отдельных опыта. Docker внутри Docker и подключение Docker socket здесь не нужны.

Какие инструменты и доступы вы дали своему агенту? Обсудим в канале:

Папка есть - а что из неё действительно сохранится?

Для сохранения файлов подключите папку к контейнеру. Слева в -v должен стоять нужный каталог на компьютере с Docker daemon, справа - /opt/data. При замене контейнера подключите тот же каталог. Восстановление Hermes проверяйте отдельно.

В контейнерной установке программа, состояние и рабочие папки разделены:

/opt/hermes       программа из образа
/opt/data         изменяемое состояние
рабочие папки    отдельные подключения

/opt/hermes закрыт для записи штатному пользователю hermes. В /opt/data находятся .env, config.yaml, state.db, sessions/, memories/, skills/, home/, logs/. Рабочая папка за пределами этого хранилища сама в него не попадёт.

В копию состояния попадут и секреты: решите, кому она доступна и что будет при утечке. Сохранённый том не заменяет независимую резервную копию. ro запрещает запись, но не чтение данных.

Теперь давайте его запустим - на отдельном хранилище

Мы всегда делаем себе тестовую среду. Здесь это новый $HOME/hermes-docker-check и контейнер hermes-check. Имена заняты - замените во всех командах. Действующий ~/.hermes не используйте, данные не очищайте.

Нужны Docker Engine/Desktop и доступ к модели от её поставщика. Команды для POSIX-оболочки и локального Docker daemon. В -v слева источник на компьютере с Docker daemon, справа - путь в контейнере.

Общий запуск Гермеса разобран в отдельной статье.

На Docker Desktop проверьте тип подключения и предупреждения SQLite. Новая база на virtiofs/9p использует DELETE; существующую WAL-базу ради опыта не переключайте. Вместо каталога можно выбрать именованный том hermes-data-check:/opt/data. Используйте его во всех командах, варианты не смешивайте.

Запуск с новым каталогом:

bash
mkdir "$HOME/hermes-docker-check"
docker run -it --rm \
  -v "$HOME/hermes-docker-check:/opt/data" \
  nousresearch/hermes-agent setup

Мастер настройки запишет ключи в .env этого хранилища. Содержимое .env не выводите. Затем запустите разовый чат:

bash
docker run -it --rm \
  -v "$HOME/hermes-docker-check:/opt/data" \
  nousresearch/hermes-agent

Либо постоянный шлюз:

bash
docker run -d --name hermes-check \
  --restart unless-stopped \
  -v "$HOME/hermes-docker-check:/opt/data" \
  nousresearch/hermes-agent gateway run

Дальше проверяем сохранность на примере шлюза; разовый чат закройте. В чат-платформе разрешите доступ только себе и проверьте ответ бота. Это проверка связи, не сохранности. Для работы только через чат-платформу порты публиковать не нужно.

Как оставить шлюз работать через Docker Compose?

Compose заменяет ручной запуск. Остановите только свой учебный контейнер:

bash
docker stop hermes-check

Удалите остановленный контейнер. Данные в подключённом хранилище оставьте:

bash
docker rm hermes-check

В отдельном каталоге создайте compose.yaml:

yaml
services:
  hermes:
    image: nousresearch/hermes-agent:latest
    container_name: hermes-check
    command: gateway run
    restart: unless-stopped
    volumes:
      - "$HOME/hermes-docker-check:/opt/data"

image задаёт образ, command запускает шлюз, restart - политику перезапуска. Каталог данных прежний, Compose подставит HOME. Если раньше выбрали именованный том, замените строку подключения на hermes-data-check:/opt/data и объявите на верхнем уровне:

yaml
volumes:
  hermes-data-check:
    external: true

Так Compose использует уже созданный том с этим именем. Запустите шлюз из каталога с файлом:

bash
docker compose up -d

Ключи уже в .env подключённого хранилища, env_file не нужен. Не запускайте 2 шлюза на одном хранилище: сеансы и память не рассчитаны на одновременную запись из них.

Подключение Гермеса к Telegram разобрано в отдельной статье.

Как проверить, что файл пережил замену контейнера?

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

Создайте учебный файл штатным пользователем контейнера. Прочитать его нужно до и после замены:

bash
docker exec hermes-check sh -c \
  'printf "%s\n" "hermes-data-check" > /opt/data/persistence-check.txt'
before=$(docker exec hermes-check cat /opt/data/persistence-check.txt)
printf '%s\n' "$before"

При ошибке записи или чтения остановитесь. hermes-data-check - учебный образец. Окно оболочки не закрывайте: before нужна для сравнения.

Через Python 3 на хосте выведите только ID и подключения:

bash
docker inspect hermes-check | python3 -c 'import json,sys; c=json.load(sys.stdin)[0]; print(c["Id"]); print(*[(m["Source"],m["Destination"],m.get("Name","")) for m in c["Mounts"]],sep="\n")'

Запишите ID контейнера, источник для /opt/data и имя тома, если он именованный. Замените контейнер без обновления образа. При ручном запуске:

bash
docker stop hermes-check
docker rm hermes-check
docker run -d --name hermes-check \
  --restart unless-stopped \
  -v "$HOME/hermes-docker-check:/opt/data" \
  nousresearch/hermes-agent gateway run

Если используете Compose, вместо этих команд выполните из каталога compose.yaml:

bash
docker compose stop hermes
docker compose rm -f hermes
docker compose up -d

Каталог и том не удаляйте. При ручном запуске с именованным томом используйте прежнее имя.

Повторите docker inspect и прочитайте файл:

bash
after=$(docker exec hermes-check cat /opt/data/persistence-check.txt)
printf '%s\n' "$after"
test "$before" = "$after"

Принимайте результат, если ID изменился, источник /opt/data прежний, до и после прочитана строка hermes-data-check, а test завершился с кодом 0. Ошибка чтения - провал, даже если пустые переменные совпали.

Заполните свой протокол:

НаблюдениеДоПосле
ID контейнера
Источник /opt/data, имя тома
Содержимое файла
Совпало содержимое?

Если файл пропал или отличается, не создавайте его заново: переходите к диагностике. Этот опыт проверяет сохранность файла, но не целостность базы и не восстановление резервной копии.

Какие доступы вы дали: без папки, только чтение, с записью

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

Теперь отдельный опыт: Гермес на хосте с тестовой конфигурацией Docker Backend, не шлюз из предыдущих шагов. Создайте несекретную папку; имя занято - выберите другое:

bash
mkdir "$HOME/hermes-access-check"
printf '%s\n' 'hermes-access-check' > "$HOME/hermes-access-check/sample.txt"

Начальная настройка тестового config.yaml:

yaml
terminal:
  backend: docker
  docker_mount_cwd_to_workspace: false
  docker_volumes: []

По очереди меняйте docker_volumes на список со строкой "/абсолютный/учебный/путь:/data:ro", затем "/абсолютный/учебный/путь:/data". Подставьте абсолютный путь созданной папки, без ~. Рабочие документы и учётные файлы не подключайте.

Общий ключ docker_shared_container_key не задавайте. Без него при изменении подключений создаётся новое окружение. После каждой смены проверяйте контейнер: /quit по умолчанию его не удаляет. Настройки container_persistent и docker_persist_across_processes разрешают повторное использование; при container_persistent: false контейнер удаляется при закрытии сеанса или простое.

ПодключениеОжидаемое чтениеОжидаемая записьЧто предъявить
НетПапка этим способом не предоставленаЧерез это подключение недоступнаВызов и отсутствие подключения
:roПри достаточных правахОтказТекст образца, ошибка, RW=false
С записьюПри достаточных правахПри достаточных правахТекст и пробный файл

Для каждого варианта дайте агенту одинаковое поручение: через terminal Docker-песочницы прочитать /data/sample.txt, попытаться записать write-check в /data/write-check.txt. Вернуть вызовы, вывод, ошибки и коды завершения. Иные пути не трогать. Проверку другим инструментом на хосте не принимайте.

На хосте проверьте, изменился ли исходный файл и появился ли пробный. Через docker inspect контейнера песочницы сверьте в Mounts поля Source, Destination, Mode, RW. Окружение с секретами не печатайте. При ro нужны и RW=false, и ошибка записи. Права ради успешной записи не повышайте.

Неподключённая папка читается или запись в ro прошла - остановитесь. Проверьте контейнер, другие подключения и инструменты. Отсутствие /data не доказывает недоступность всех учётных данных: навыки могут подключать учётные файлы для чтения, переменные - передаваться через окружение. Вы проверили только выбранный путь и вызовы.

Кстати, я снял полный гайд про инструменты и навыки первого агента Hermes Agent, обязательно посмотрите.

Видео загрузится при скролле
Полный гайд - Связка для первого агента Hermes Agent

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

Как проверить границы доступа у Codex, разобрано в отдельной статье. Его настройки не переносите в Hermes.

Если вы собираете свои проекты с ИИ-агентами, посмотрите программу практикума СмыслоКода.

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Как обновить Гермес и не принять том за резервную копию?

Запишите образ и источник /opt/data, остановите пишущие в него процессы. Сделайте независимую копию всего хранилища, ограничив доступ к секретам в .env и home/. Копии только базы или памяти недостаточно.

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

Затем для Compose:

bash
docker compose pull
docker compose up -d

При ручном запуске выполните docker pull nousresearch/hermes-agent, удалите остановленный учебный контейнер и запустите новый с тем же хранилищем. latest меняется. После замены повторите чтение маркера и сверку источника.

Перезапуск сохраняет изменяемый слой контейнера. При замене слой теряется вместе с вручную установленными системными пакетами. Датированные копии .env и config.yaml перед миграцией не заменяют полную независимую копию.

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

Не сходится - что проверить и когда остановиться?

СимптомЧто проверитьНужный результатКогда остановиться
Пропал маркерНовый ID, прежние Source/Destination /opt/data, путь, вид хранилищаПрежний файл читается в новом контейнереДо сбросов и повторной записи маркера
Папка не читаетсяПуть на хосте daemon, назначение, песочницу, праваУчебная копия читается нужным инструментомПри неожиданном пути или отказе прав
Изменился ro-файл или появился пробныйRW, дублирующиеся подключения, другой инструментОтказ записи и неизменность оригиналаДо подключения рабочих папок

Опечатка слева в -v может создать пустой каталог. Сначала найдите, какое подключение указывает не туда.

При Permission denied согласуйте владельца с HERMES_UID/HERMES_GID либо PUID/PGID по инструкции Docker для Hermes. Не делайте секреты общедоступными, не меняйте владельца всего дерева без разбора.

Контейнер шлюза завершился - начните с docker logs hermes-check, не публикуя секреты. Проверьте .env, нет ли второго шлюза и конфликтов портов. Предупреждение о state.db требует отдельной проверки SQLite и хранилища. Базу не удаляйте.

Не подменяйте тесты чтением кода. Файл должен читаться после замены контейнера, а запись через проверяемое подключение ro - завершаться отказом.

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

А у вас файл пережил замену контейнера? Где агент смог записать? Обсудим в комментариях в канале.

Источники

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Была инструкция полезна?
Артемий Миллер
Автор
Артемий Миллер
Предприниматель и вайб-кодер

Артемий Миллер - предприниматель и вайб-кодер. Бывший программист, собирает продукты исключительно вместе с ИИ-агентами, без найма разработчиков.

Связанные инструкции

Codex sandbox: проверьте, какие права вы дали агенту

Codex sandbox ограничивает команды, но запрет внешней записи не доказывает запрет чтения. Проверьте права на искусственных файлах и повторите проверку после перезапуска.

9 мин

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

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

9 мин

Antigravity Skills: не ставьте лишнего - установите навык и проверьте

Для установки навыка в Antigravity скопируйте проверенную папку с SKILL.md в .agents/skills/ тестового проекта. Затем проверьте доступность навыка, чтение инструкций и реальный коммит в истории Git.

7 мин

Голосовой ИИ-агент: поймать квала и передать человеку

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

9 мин