Как запустить Hermes Agent на VPS круглосуточно: служба и автозагрузка

После установки Hermes Agent на ноутбук может возникнуть вопрос: кто будет отвечать в Telegram и готовить утренние сводки, когда компьютер закрыт? На личной машине агент работает лишь до тех пор, пока она включена. Чтобы бот оставался доступен, а запланированные задачи выполнялись автоматически, Hermes нужно разместить на сервере.

В этой инструкции описана установка Hermes на обычный Linux-сервер, настройка шлюза как постоянно работающей службы с запуском после перезагрузки и ограничение доступа к терминалу. Материал основан на официальной документации.

Если Hermes ещё не установлен, сначала прочитай отдельное руководство: что это за агент и как его установить. Здесь предполагается, что на твоём компьютере Hermes уже запущен; речь пойдёт только о переносе на сервер.

Сведения о работе с Ailoot собраны в документации.

Почему Hermes Agent переносят с ноутбука на сервер?#

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

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

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

Что нужно подготовить перед установкой Hermes на VPS?#

До установки подготовь три вещи.

Сервер. Подойдёт обычный VPS под Linux. Документация указывает Linux и WSL2 в качестве начальных поддерживаемых платформ; тестирование проводится на актуальной Ubuntu. При наличии glibc, systemd и стандартной структуры каталогов Hermes обычно устанавливается без проблем. Для серверной настройки особенно важен systemd: на Ubuntu и Debian он доступен по умолчанию, а на нём основан описанный ниже автозапуск.

Подключение по SSH. Управлять сервером предстоит через терминал и SSH, а не мышью. Все команды из инструкции вводятся в этом сеансе. Если терминал пока незнаком, можно просто копировать приведённые команды целиком.

Модель. Hermes обращается к модели для выполнения задач. Для сервера, работающего без присмотра, важно, чтобы авторизация оставалась действительной. Один из вариантов — подключение к Nous Portal командой hermes setup --portal: вход выполняется через OAuth, а токен обновляется автоматически. Можно использовать собственные API-ключи, но тогда нужно следить за балансом: при его исчерпании агент не сможет продолжить работу. Модель должна поддерживать контекст не менее 64 000 токенов, иначе Hermes не запустится. Это условие выполняют облачные модели из списка.

Как установить Hermes Agent на сервер одной командой?#

Установка на сервере почти не отличается от установки на ноутбуке. Обычно браузер агенту там не нужен, а его автоматизация устанавливает тяжёлый Chromium. Поэтому здесь используется параметр --skip-browser.

1. Подключись к серверу по SSH

   ssh root@адрес-твоего-сервера
   

   Все последующие команды выполняй в этом сеансе непосредственно на сервере.

2. Запусти установщик, пропустив браузер

   curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser
   

   Скрипт установит необходимое окружение и добавит команду hermes. Параметр --skip-browser исключает браузерную автоматизацию, которая занимает место на сервере без графической среды. Если браузер понадобится позже, его можно установить отдельно.

3. Обнови оболочку и настрой модель

   source ~/.bashrc
   hermes setup --portal
   

   Первая команда обновляет PATH, чтобы терминал нашёл hermes. Вторая запускает авторизацию в Nous Portal: после подтверждения входа агент получает доступ к модели и сервисам без необходимости настраивать отдельный ключ для каждого.

4. Убедись, что установка прошла успешно

   hermes doctor
   

   Команда проверит установку, сообщит о недостающих компонентах и подскажет, как исправить проблемы. Зелёные отметки означают, что всё готово.

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

Как настроить круглосуточную работу Hermes?#

Шлюз (gateway) — это фоновый процесс Hermes, который поддерживает соединение с мессенджерами, управляет сессиями и запускает задачи по расписанию. Именно от него зависит непрерывная работа агента. Нужно настроить автоматический запуск процесса и его восстановление после сбоя.

Сначала настрой шлюз и подключи мессенджер:

hermes gateway setup

Мастер настройки предложит выбрать платформы, добавить токен бота и указать список разрешённых пользователей. Инструкция по подключению Telegram — созданию бота через BotFather, поиску своего ID и добавлению токена — приведена в основном руководстве по установке.

Если просто запустить hermes gateway, процесс будет работать лишь до завершения SSH-сеанса. Закрытие терминала остановит шлюз. Чтобы процессом управляла система, установи его как службу:

hermes gateway install

В Linux эта команда создаёт пользовательскую службу systemd, а в macOS использует launchd. Система наблюдает за процессом и запускает его снова, если он завершится.

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

sudo hermes gateway install --system

Такой вариант подходит для VPS: после перезагрузки служба стартует сама, и бот снова становится доступен. Для управления шлюзом предусмотрены команды:

hermes gateway start     # запуск
hermes gateway stop      # остановка
hermes gateway status    # проверка состояния

Для системной службы добавь sudo и параметр --system. Без него команда будет обращаться к пользовательской службе, а не к той, которая запускается вместе с сервером:

sudo hermes gateway start --system
sudo hermes gateway stop --system
sudo hermes gateway status --system

Для чего нужен linger и что произойдёт без него?#

Здесь часто возникает проблема: служба установлена, но ночью бот перестаёт отвечать. Причина связана с тем, как Linux управляет пользовательскими службами.

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

Режим linger позволяет системе сохранять менеджер пользователя активным даже тогда, когда пользователь не вошёл в систему:

sudo loginctl enable-linger имя-пользователя

После включения linger пользовательская служба работает самостоятельно и запускается при старте сервера без ожидания входа пользователя. Без него шлюз может завершаться после выхода из SSH и не запускаться при загрузке.

Как включить автоматический перезапуск Hermes в Docker?#

Docker — ещё один способ держать агента на сервере. Он подойдёт тем, кто уже использует контейнеры или хочет отделить агента от основной системы. Сначала настрой Hermes командой docker run ... setup, затем запусти контейнер в фоне:

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  nousresearch/hermes-agent gateway run

Параметры, обеспечивающие постоянную работу:

• -d — контейнер запускается в фоне и не занимает терминал.
• --restart unless-stopped — Docker запускает контейнер после перезагрузки сервера или его сбоя. Исключение — случай, когда контейнер остановили вручную.
• -v ~/.hermes:/opt/data — настройки, ключи, сессии и память хранятся на сервере вне контейнера и сохраняются при его пересоздании.

Внутри образа за процессом также следит супервизор s6. Если шлюз завершится, s6 запустит его снова через несколько секунд, не перезапуская контейнер. Таким образом, Docker наблюдает за контейнером, а s6 — за процессом шлюза внутри него.

У Docker-установки есть особенность: команда hermes update её не обновляет. Чтобы установить новую версию, нужно загрузить свежий образ и пересоздать контейнер.

Как убедиться, что всё работает и запустится после перезагрузки?#

Состояние пользовательской службы и её журналы можно проверить так:

hermes gateway status
journalctl --user -u hermes-gateway -f

Для рекомендуемой на VPS системной службы используй системную область:

sudo hermes gateway status --system
sudo journalctl -u hermes-gateway -f

Первая команда проверяет выбранную службу, вторая показывает её журнал. Имена относятся к стандартной установке ~/.hermes. У другого Hermes home может быть суффикс службы: изучи status и используй точное имя. Не наблюдай пользовательскую службу при проверке системной. Логи Hermes хранятся в ~/.hermes/logs/; секретные данные автоматически скрываются, поэтому при обращении в поддержку их можно отправить без раскрытия секретов.

После этого перезагрузи сервер и проверь, что агент восстановился самостоятельно. Для серверной настройки это основная проверка:

sudo reboot

Когда сервер снова доступен, подключись по SSH. Для системной установки проверь sudo hermes gateway status --system и системный журнал; для пользовательской с linger — hermes gateway status и пользовательский журнал. Затем отправь сообщение Telegram-боту и проверь ответ без дополнительных действий.

Переписка сохраняется: Hermes записывает сессии на диск, поэтому они переживают перезапуск шлюза. Если шлюз завершился во время отправки ответа, после восстановления он продолжит отправку, не запуская задачу заново. Это помогает сохранить ход разговора после случайного перезапуска.

Как защитить агента с доступом к серверному терминалу?#

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

Ограниченный доступ к боту. По умолчанию шлюз отвечает только пользователям из списка доступа или тем, кто прошёл привязку по коду в личном сообщении. Для бота с доступом к терминалу это важная защита: незнакомый пользователь не сможет управлять агентом. Список можно задать числовыми ID, например для Telegram:

TELEGRAM_ALLOWED_USERS=123456789,987654321

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

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

hermes config set terminal.backend docker

В этом режиме действия из терминала выполняются внутри изолированной среды, а не непосредственно на сервере. Это дополнительная мера при самостоятельной работе агента.

Что делать, если бот не отвечает или шлюз остановился?#

Если бот замолчал, сначала проверь область установки: sudo hermes gateway status --system и системный журнал для системной службы либо hermes gateway status и пользовательский журнал для пользовательской. Если шлюз запущен, но сообщения не доходят, проверь настройки платформы: токен бота может быть неверным, а отправитель — отсутствовать в списке доступа. Повтори hermes gateway setup в том же Hermes home, затем проверь выбранную службу: sudo hermes gateway status --system для системной или hermes gateway status для пользовательской. Успешная настройка не доказывает работу нужного шлюза.

Если ответы модели пустые или выглядят некорректно, проверь её через hermes model и подтверди выбор провайдера и способ входа. Для общей диагностики выполни hermes doctor, hermes model, hermes setup, затем sudo hermes gateway status --system для системной установки или hermes gateway status для пользовательской.

Для редкого случая, когда процесс полностью зависает, но не завершается, можно включить сторожевой таймер systemd. Добавь параметр в ~/.hermes/config.yaml, затем переустанови службу с обновлением конфигурации.

gateway:
  systemd_watchdog_seconds: 120

# Системная служба VPS: тот же Hermes home, что при исходной установке.
sudo hermes gateway install --system --force
sudo hermes gateway status --system

Для пользовательской службы вместо этого обнови только её через hermes gateway install --force и проверь hermes gateway status. Выбери одну область: не устанавливай обе ради исправления одного шлюза.

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

Какие вопросы о Hermes Agent на сервере задают чаще всего?#

Познакомься с Ailoot.