В 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. Используйте его во всех командах, варианты не смешивайте.
Запуск с новым каталогом:
mkdir "$HOME/hermes-docker-check"
docker run -it --rm \
-v "$HOME/hermes-docker-check:/opt/data" \
nousresearch/hermes-agent setupМастер настройки запишет ключи в .env этого хранилища. Содержимое .env не выводите. Затем запустите разовый чат:
docker run -it --rm \
-v "$HOME/hermes-docker-check:/opt/data" \
nousresearch/hermes-agentЛибо постоянный шлюз:
docker run -d --name hermes-check \
--restart unless-stopped \
-v "$HOME/hermes-docker-check:/opt/data" \
nousresearch/hermes-agent gateway runДальше проверяем сохранность на примере шлюза; разовый чат закройте. В чат-платформе разрешите доступ только себе и проверьте ответ бота. Это проверка связи, не сохранности. Для работы только через чат-платформу порты публиковать не нужно.
Как оставить шлюз работать через Docker Compose?
Compose заменяет ручной запуск. Остановите только свой учебный контейнер:
docker stop hermes-checkУдалите остановленный контейнер. Данные в подключённом хранилище оставьте:
docker rm hermes-checkВ отдельном каталоге создайте compose.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 и объявите на верхнем уровне:
volumes:
hermes-data-check:
external: trueТак Compose использует уже созданный том с этим именем. Запустите шлюз из каталога с файлом:
docker compose up -dКлючи уже в .env подключённого хранилища, env_file не нужен. Не запускайте 2 шлюза на одном хранилище: сеансы и память не рассчитаны на одновременную запись из них.
Подключение Гермеса к Telegram разобрано в отдельной статье.
Как проверить, что файл пережил замену контейнера?
Пусть агент покажет, что работает. Не сходится с тем, что вы просили, пусть чинит и показывает заново.
Создайте учебный файл штатным пользователем контейнера. Прочитать его нужно до и после замены:
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 и подключения:
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 и имя тома, если он именованный. Замените контейнер без обновления образа. При ручном запуске:
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:
docker compose stop hermes
docker compose rm -f hermes
docker compose up -dКаталог и том не удаляйте. При ручном запуске с именованным томом используйте прежнее имя.
Повторите docker inspect и прочитайте файл:
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, не шлюз из предыдущих шагов. Создайте несекретную папку; имя занято - выберите другое:
mkdir "$HOME/hermes-access-check"
printf '%s\n' 'hermes-access-check' > "$HOME/hermes-access-check/sample.txt"Начальная настройка тестового config.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, обязательно посмотрите.
Внутри - какие права давать агенту, как выбирать подключения через MCP и не поставить вредный MCP. Посмотрите перед подключением рабочих сервисов.
Как проверить границы доступа у Codex, разобрано в отдельной статье. Его настройки не переносите в Hermes.
Если вы собираете свои проекты с ИИ-агентами, посмотрите программу практикума СмыслоКода.
Как обновить Гермес и не принять том за резервную копию?
Запишите образ и источник /opt/data, остановите пишущие в него процессы. Сделайте независимую копию всего хранилища, ограничив доступ к секретам в .env и home/. Копии только базы или памяти недостаточно.
Задайте частоту копий, срок хранения и место вне основного сервера. Уточните допустимую потерю данных и время восстановления до выбора расписания. Запишите, кому доступна копия и как проверить восстановление в отдельной среде.
Затем для Compose:
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 - завершаться отказом.
Частые вопросы
А у вас файл пережил замену контейнера? Где агент смог записать? Обсудим в комментариях в канале.
Источники
- Nous Research: Docker - запуск, состояние, обновление.
- Nous Research: Configuration - песочница, подключения.
- Docker: Bind mounts -
ro, пути,Mounts.
Новые материалы - дайджестом, без спама
Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

