Как установить Hermes Agent на Ubuntu VPS: пошаговое руководство

Установка Hermes Agent на Ubuntu VPS даёт вашему ИИ-агенту сервер, который остаётся онлайн после выключения ноутбука или завершения сессии терминала.

Чтобы установить Hermes Agent на Ubuntu VPS, вам потребуется:

• Подключиться к вашему VPS по SSH.
• Обновить Ubuntu и установить необходимые пакеты Linux.
• Создать выделенного пользователя Hermes.
• Запустить официальный установщик Nous Research.
• Завершить мастер настройки Hermes.
• Проверить установку с помощью hermes doctor.
• Запустить шлюз Hermes через systemd, если вы хотите, чтобы агент оставался онлайн.

Например, вы можете захотеть, чтобы Hermes Agent отслеживал задачу, отвечал через Telegram или Discord, сохранял память между сессиями или оставался доступным для автоматизации браузера, пока ваш ноутбук выключен. Запуск Hermes Agent на Ubuntu VPS предоставляет тому же агенту постоянную серверную среду вместо привязки к локальной машине.

Это руководство проведёт вас через полную настройку: от подготовки сервера до установки, конфигурации, тестирования шлюза, усиления брандмауэра и устранения неполадок. В итоге у вас будет работающая установка Hermes Agent на Ubuntu VPS, готовая к реальным задачам.

Краткий ответ: Как установить Hermes Agent на Ubuntu VPS

Самый быстрый способ установить Hermes Agent на Ubuntu VPS — запустить официальный установщик Linux от Nous Research:

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

После завершения установщика перезагрузите оболочку и выполните проверки настройки:

source ~/.bashrc
hermes setup
hermes doctor

Используйте hermes setup для настройки провайдера LLM, ключей API, инструментов и предпочтений времени выполнения. Используйте hermes gateway, если хотите, чтобы тот же агент подключался к каналам обмена сообщениями, таким как Telegram, Discord, Slack, Signal или email.

Примечание: В этом руководстве показана ручная настройка Ubuntu VPS. Если вы хотите пропустить большую часть подготовки сервера, Bluehost Hermes Agent VPS Hosting предоставляет путь развёртывания в один клик для запуска Hermes Agent на самостоятельно управляемом VPS. Ручные шаги ниже всё ещё полезны, если вы хотите понять, настроить или самостоятельно устранить неполадки серверной среды.

Что вам нужно перед установкой Hermes Agent

Перед установкой Hermes Agent на Ubuntu VPS убедитесь, что у вас есть:

• VPS с Ubuntu 22.04 LTS или Ubuntu 24.04 LTS
• SSH-доступ к серверу
• Пользователь с привилегиями sudo
• Стабильное интернет-соединение с сервера
• curl установлен или доступен через apt
• План провайдера LLM, ключи API или путь настройки Nous Portal
• Доменное имя или статический IP, если вы планируете открывать вебхуки, веб-панель или внешний доступ
• Базовое владение командами Linux, доступом к терминалу и настройкой командной строки

Для большинства рабочих нагрузок агента на основе API можно начинать со скромных ресурсов сервера. Если вы планируете запускать локальные модели на том же VPS, вам понадобится больше CPU, RAM, хранилища и дополнительный запас.

Рекомендуемые требования к Ubuntu VPS для Hermes Agent

Ваш VPS должен соответствовать типу рабочей нагрузки агента, которую вы планируете запускать.

Для базовой настройки Hermes Agent с использованием удалённых API моделей начните с:

• 2 ядра vCPU
• 4 ГБ ОЗУ
• 40 ГБ хранилища
• Ubuntu 22.04 LTS или 24.04 LTS
• Доступ root или sudo
• Выделенный IP-адрес

Для более тяжёлых рабочих процессов, параллельных задач, автоматизации браузера или экспериментов с локальными моделями рассмотрите:

• 4 или более ядер vCPU
• 8 ГБ ОЗУ или больше
• NVMe-хранилище
• Больше дискового пространства для логов, памяти, файлов проектов, конфигурационных файлов и ресурсов моделей
• Тариф VPS, позволяющий обновлять или масштабировать ресурсы без пересборки сервера

Если вы хотите только установить Hermes Agent на Ubuntu VPS и подключить его к облачным API провайдера LLM, базовой настройки достаточно для начала. Если вы хотите, чтобы VPS обрабатывал локальный вывод, выберите больше ОЗУ перед развёртыванием.

Шаг 1: Подключитесь к вашему Ubuntu VPS и обновите пакеты

Войдите на ваш VPS через SSH:

ssh username@your-server-ip

Затем обновите Ubuntu перед установкой чего-либо:

sudo apt update && sudo apt upgrade -y

Если обновление включает обновление ядра, перезагрузите сервер:

sudo reboot

Подключитесь снова после перезагрузки:

ssh username@your-server-ip

Обновление сначала помогает избежать конфликтов пакетов и предоставляет Hermes Agent чистую среду Ubuntu для работы.

Шаг 2: Установите curl и базовые системные пакеты

Официальный установщик Hermes Agent обрабатывает основные зависимости, но ваш сервер всё равно нуждается в базовых инструментах Linux, таких как curl.

Примечание: В этом руководстве используется официальный установщик Hermes Agent для Linux, который самостоятельно выполняет основную настройку среды выполнения. Вам не нужно вручную создавать виртуальное окружение Python или устанавливать Hermes Agent с помощью pip, если только официальная документация для вашей конкретной версии не предписывает использовать ручную настройку на основе Python.

Выполните:

sudo apt install curl git ca-certificates -y

Вы также можете проверить, что curl доступен:

curl --version

Это подготавливает сервер Ubuntu к команде официального установщика. Тот же общий подход может показаться знакомым на системах Linux на основе Debian, но это руководство фокусируется на развёртывании на Ubuntu VPS.

Шаг 3: Создайте выделенного пользователя Hermes Agent

Не запускайте долгоживущие процессы агента от root. Вместо этого создайте выделенного пользователя для Hermes Agent:

sudo adduser --disabled-password --gecos "" hermes
sudo usermod -aG sudo hermes

Затем переключитесь на этого пользователя:

sudo -iu hermes

Использование выделенного пользователя позволяет хранить файлы Hermes Agent, конфигурацию, файлы .env и среду выполнения отдельно от учётной записи root. Это также упрощает управление службой systemd в дальнейшем.

Шаг 4: Установите Hermes Agent на Ubuntu VPS

Теперь запустите официальный установщик Linux от имени пользователя hermes:

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

Это ключевая команда для установки Hermes Agent на Ubuntu VPS. Это также основной шаг для установки Hermes из терминала.

После завершения установщика перезагрузите конфигурацию оболочки:

source ~/.bashrc

Если ваша оболочка использует Zsh вместо Bash, выполните:

source ~/.zshrc

Затем проверьте, что команда hermes доступна:

command -v hermes

Вы должны увидеть путь, похожий на:

/home/hermes/.local/bin/hermes

Если команда не найдена, закройте SSH-сессию, войдите снова как пользователь hermes и повторите попытку.

Шаг 5: Проверьте установку Hermes Agent

Проверьте установленную версию:

hermes --version

Затем выполните диагностическую команду:

hermes doctor

hermes doctor проверяет среду и сообщает об отсутствующих зависимостях, проблемах с путями или конфигурацией. Выполните это перед настройкой агента для использования в production.

Вы также можете запустить Hermes Agent из командной строки:

hermes

Это открывает интерактивный CLI. Для новой установки на Ubuntu VPS это самый простой способ подтвердить, что Hermes Agent запускается корректно и что вы можете запустить Hermes из терминала.

Шаг 6: Настройте Hermes Agent

После установки запустите мастер настройки:

hermes setup

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

hermes model

Чтобы просмотреть или настроить инструменты, выполните:

hermes tools

Если вы хотите использовать Nous Portal для настройки, вы можете выполнить:

hermes setup --portal

Используйте путь настройки, соответствующий вашему провайдеру и рабочему процессу. Некоторые пользователи используют собственные ключи API. Другие применяют настройку через портал. Важно завершить конфигурацию Hermes перед попыткой запуска Hermes Agent как долгоживущего сервиса.

Это руководство фокусируется на настройке VPS на Ubuntu, а не на установке Hermes Desktop. Цель — сохранить агента доступным на сервере, не завися от локальной сессии рабочего стола.

Шаг 7: Тестирование Hermes Agent из командной строки

Перед созданием службы systemd убедитесь, что Hermes Agent работает в обычной сессии оболочки.

Выполните:

hermes

Начните простой разговор, чат или задачу. Затем выйдите из CLI.

Если вы планируете использовать платформы или каналы обмена сообщениями, настройте шлюз:

hermes gateway

В зависимости от вашей настройки вы также можете использовать:

hermes gateway setup

Затем протестируйте шлюз вручную:

hermes gateway start

Для установки шлюза Hermes это этап, на котором вы подтверждаете, что шлюз может работать до того, как им будет управлять systemd. Это важно, если вы хотите, чтобы агент или бот работали через несколько каналов, таких как Telegram, Discord, Slack, Signal, электронная почта или бот Discord.

Не пропускайте этот тест. Если Hermes Agent завершится с ошибкой при ручном запуске, он также завершится ошибкой под управлением systemd. Ручное тестирование даёт более понятные сообщения об ошибках и упрощает поиск неисправностей.

Шаг 8: Запуск Hermes Agent с systemd

Прямая сессия CLI закрывается при завершении SSH-сессии. На VPS вам может потребоваться, чтобы шлюз Hermes Agent перезапускался автоматически после сбоя или перезагрузки сервера.

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

Используйте для этого systemd.

Сначала определите путь к команде Hermes:

command -v hermes

Если вы устанавливали от имени пользователя hermes, путь обычно будет:

/home/hermes/.local/bin/hermes

При необходимости вернитесь к вашему sudo-пользователю:

exit

Создайте файл службы systemd:

sudo nano /etc/systemd/system/hermes-agent.service

Важно: замените путь ExecStart в файле службы на точный путь, возвращённый командой command -v hermes на вашем сервере. В примере ниже используется /home/hermes/.local/bin/hermes, но ваш путь может отличаться в зависимости от пользователя, оболочки и места установки.

Добавьте эту конфигурацию:

[Unit]
Description=Шлюз Hermes Agent
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=hermes
WorkingDirectory=/home/hermes
Environment=HOME=/home/hermes
ExecStart=/home/hermes/.local/bin/hermes gateway start
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

Сохраните и закройте файл.

Перезагрузите systemd:

sudo systemctl daemon-reload

Включите автозапуск службы:

sudo systemctl enable hermes-agent

Запустите службу:

sudo systemctl start hermes-agent

Проверьте статус:

sudo systemctl status hermes-agent

Просмотрите логи в реальном времени:

sudo journalctl -u hermes-agent -f

Оставьте RestartSec=5. Небольшая задержка перезапуска предотвращает быстрые циклы сбоев, которые усложняют отладку сервера.

Важно: используйте эту службу, если вам нужно, чтобы шлюз Hermes работал непрерывно. Если вы используете Hermes Agent только как интерактивный CLI, systemd может не понадобиться. В этом случае вы можете запускать Hermes вручную по необходимости.

Шаг 9: Обеспечение безопасности VPS с Hermes Agent перед запуском

VPS, на котором работает AI-агент, не должен предоставлять ненужные службы публичному интернету. Начните с включения брандмауэра и разрешения SSH:

sudo ufw allow OpenSSH
sudo ufw enable

Проверьте статус брандмауэра:

sudo ufw status

Открывайте дополнительные порты только тогда, когда этого действительно требует настройка Hermes Agent. Например, если вы разместите обратный прокси перед веб-интерфейсом, веб-панелью или конечной точкой вебхука, может потребоваться HTTPS:

sudo ufw allow 443/tcp

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

sudo ufw allow from ваш-ip-адрес to any port 443 proto tcp

Также соблюдайте следующие основные правила безопасности:

• Используйте ключи SSH вместо входа по паролю.
• Отключите вход root по SSH, если это позволяет ваш рабочий процесс.
• Поддерживайте пакеты Ubuntu в актуальном состоянии.
• Не прописывайте ключи API в публичных репозиториях.
• Не храните учётные данные провайдера в файлах проекта и файлах .env.
• Регулярно просматривайте логи Hermes Agent.
• Меняйте ключи API при подозрении на компрометацию.
• Используйте обратный прокси, такой как Nginx или Caddy, если вам нужен доступ по HTTPS.
• Запускайте службу Hermes Agent под выделенным пользователем.

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

Краткий обзор настройки: установка Hermes Agent на Ubuntu VPS

Шаг	Действие	Основные команды	Почему это важно
1	Подключитесь к вашему Ubuntu VPS и обновите пакеты	ssh username@your-server-ipsudo apt update && sudo apt upgrade -ysudo reboot	Обеспечивает чистую обновлённую среду Ubuntu для Hermes Agent и помогает избежать конфликтов пакетов.
2	Установите curl и базовые системные пакеты	sudo apt install curl git ca-certificates -ycurl --version	Устанавливает базовые инструменты, необходимые для запуска официального установщика Hermes Agent.
3	Создайте выделенного пользователя для Hermes Agent	sudo adduser --disabled-password --gecos "" hermessudo usermod -aG sudo hermessudo -iu hermes	Изолирует файлы Hermes, конфигурацию, ключи API и активность среды выполнения от учётной записи root.
4	Установите Hermes Agent на Ubuntu VPS	curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashsource ~/.bashrccommand -v hermes	Устанавливает Hermes Agent и подтверждает, что команда hermes доступна.
5	Проверьте установку Hermes Agent	hermes --versionhermes doctorhermes	Проверяет, что Hermes Agent установлен корректно и может быть запущен из командной строки.
6	Настройте Hermes Agent	hermes setuphermes modelhermes toolshermes setup --portal	Подключает Hermes к вашему провайдеру моделей, ключам API, инструментам, навыкам и настройкам среды выполнения.
7	Протестируйте Hermes Agent из командной строки	hermeshermes gatewayhermes gateway setuphermes gateway start	Подтверждает, что Hermes и шлюз работают, прежде чем запускать их как фоновую службу.
8	Запустите Hermes Agent с systemd	command -v hermessudo nano /etc/systemd/system/hermes-agent.servicesudo systemctl daemon-reloadsudo systemctl enable hermes-agentsudo systemctl start hermes-agent	Обеспечивает непрерывную работу шлюза Hermes после отключения SSH, сбоев или перезагрузок сервера.
9	Обеспечьте безопасность VPS с Hermes Agent перед запуском	sudo ufw allow OpenSSHsudo ufw enablesudo ufw statussudo ufw allow 443/tcp	Снижает риски, ограничивая публичный доступ, защищая SSH и открывая только те порты, которые необходимы вашей настройке.

Устранение неполадок при установке Hermes Agent на Ubuntu VPS

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

Вот переведённый HTML-контент с сохранением всех тегов:

Проблема	Вероятная причина	Решение
hermes: command not found	Путь оболочки не перезагружен	Выполните source ~/.bashrc, переоткройте SSH или проверьте command -v hermes
Установщик не работает	Отсутствуют базовые пакеты или проблема с сетью	Установите curl, git и ca-certificates, затем повторите
Отказано в доступе	Hermes был установлен под другим пользователем	Переключитесь на правильного пользователя или переустановите от имени выделенного пользователя hermes
hermes doctor сообщает об отсутствующих зависимостях	Установщик завершился некорректно	Запустите установщик снова и проверьте вывод
Служба шлюза не работает под systemd	Путь ExecStart неправильный	Выполните command -v hermes от имени пользователя hermes и обновите файл службы
Служба запускается и завершается	Шлюз не настроен	Сначала выполните вручную hermes gateway setup
Ошибка аутентификации API	Настройка провайдера неполная или учетные данные неверны	Снова выполните hermes setup, hermes model или процесс настройки вашего провайдера
Отключение SSH останавливает агента	Вы запускаете Hermes вручную, а не через systemd	Используйте systemd для шлюза или запускайте интерактивные сеансы только вручную
На сервере заканчивается память	Нагрузка превышает доступную оперативную память	Обновите VPS или используйте удаленный вывод модели

Если журналы systemd неясны, протестируйте вручную от имени пользователя hermes:

sudo -iu hermes
hermes doctor
hermes gateway start

Ручные запуски обычно показывают более понятные ошибки, чем вывод состояния службы.

Как обновить Hermes Agent

Чтобы обновить Hermes Agent после установки, переключитесь на пользователя hermes:

sudo -iu hermes

Затем выполните:

hermes update

После обновления выполните:

hermes doctor

Если вы используете службу шлюза systemd, перезапустите её:

exit
sudo systemctl restart hermes-agent
sudo systemctl status hermes-agent

Проверяйте журналы после каждого обновления:

sudo journalctl -u hermes-agent -n 100

Это подтверждает, что обновленная версия запускается чисто и ваша конфигурация шлюза все еще работает.

На что обратить внимание при выборе VPS для Hermes Agent

Лучший VPS для Hermes Agent зависит от того, как вы планируете его использовать. Для базовых рабочих процессов с поддержкой API подойдет VPS поменьше. Для локальных моделей, параллельных задач, автоматизации браузера или более тяжелой автоматизации выбирайте больше CPU, RAM и хранилища.

Обратите внимание на следующие функции:

• Полный root-доступ или sudo
• Поддержка Ubuntu 22.04 LTS или Ubuntu 24.04 LTS
• Хранилище NVMe
• Выделенные ресурсы
• Масштабируемые CPU и RAM
• Поддержка статического или выделенного IP
• Надежное время безотказной работы
• Удобный доступ по SSH
• Управление брандмауэром
• Поддержка долго работающих фоновых служб
• Однощелчковое предоставление или простой доступ к панели управления, где это возможно

Когда имеет смысл использовать Bluehost Hermes Agent VPS Hosting

Bluehost Hermes Agent VPS Hosting имеет смысл, если вы хотите запустить Hermes Agent на самостоятельно управляемом VPS, не начиная с пустого сервера. Вместо ручной подготовки каждого уровня вы получаете путь развертывания в один клик для Hermes Agent, а затем продолжаете настраивать провайдера моделей, ключи API, рабочие процессы шлюза, память, навыки и параметры сервера самостоятельно.

Это полезно, если ваша цель — не просто установить Hermes Agent один раз, а поддерживать работу того же агента за пределами сеанса на ноутбуке. VPS предоставляет Hermes Agent постоянную среду выполнения для запланированных задач, каналов обмена сообщениями, автоматизации браузера и долго выполняющихся рабочих процессов. Bluehost добавляет более быстрый путь настройки, при этом предоставляя техническим пользователям контроль над средой.

Все же стоит понимать ручные шаги, описанные в этом руководстве. Они помогут вам устранить неполадки установки, защитить сервер, проверить шлюз Hermes и узнать, что происходит за однощелчковой настройкой.

Дайте Hermes Agent сервер, в который он может вырасти

Установка Hermes Agent на Ubuntu VPS — это больше, чем задача настройки. Это шаг, который превращает локального ИИ-агента в постоянную систему, которая может продолжать работать после выключения ноутбука, закрытия терминала или завершения сеанса.

Ручной путь дает вам полное представление о том, как подготавливается сервер, как устанавливается Hermes Agent, как мастер настройки подключает вашего провайдера моделей и как шлюз Hermes остается онлайн через systemd. Эти детали важны, потому что агент настолько надежен, насколько надежна среда, в которой он работает. Чистая установка, выделенный пользователь, безопасная обработка ключей API, правила брандмауэра и поведение при перезапуске — все это влияет на стабильность агента в реальных рабочих нагрузках.

Если вы хотите больше контроля, следуйте ручной настройке Ubuntu VPS. Если вы хотите более быструю отправную точку, Bluehost Hermes Agent VPS Hosting предоставляет путь развертывания в один клик, при этом оставляя возможность самостоятельно настраивать агента, шлюз, память, навыки и параметры провайдера. В любом случае, реальное решение заключается не только в том, где установить Hermes Agent. Это вопрос того, хотите ли вы, чтобы ваш агент оставался временным инструментом на машине, которую вы открываете время от времени, или постоянным работником с собственным сервером.

Часто задаваемые вопросы

Все HTML-теги сохранены в точности, текст переведён на русский язык.

Обычно это происходит из-за того, что systemd использует другой путь к команде или окружение, отличное от вашего интерактивного сеанса терминала. Выполните command -v hermes от пользователя hermes и убедитесь, что путь ExecStart в /etc/systemd/system/hermes-agent.service соответствует этому точному пути. После редактирования файла службы выполните sudo systemctl daemon-reload, перезапустите службу и проверьте журналы с помощью sudo journalctl -u hermes-agent -n 100.