wikipedia/Hermes/hermes-desktop-connect-guide.md

#hermes #guide

Подключение Hermes Desktop (Windows) к серверу

Общая схема:

[Windows] --LAN--> [Сервер 192.168.1.44:9119]
Hermes Desktop        Hermes Dashboard
                      (тот же агент, что в этом сеансе)

---

1. Что уже сделано на сервере

• Dashboard запущен на 0.0.0.0:9119 (слушает все интерфейсы)
• Basic auth включена: логин admin, пароль agent
• Dashboard автоматически стартует при загрузке сервера (systemd-сервис hermes-dashboard.service)
• При падении перезапускается автоматически через 10 секунд

Проверить статус можно с сервера:

curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:9119/api/health
# → 200

systemctl status hermes-dashboard.service
# → active (running)

---

2. Подключение из Hermes Desktop (Windows)

1. Открой Hermes Desktop на Windows
2. Нажми Ctrl+K (Cmd+K на Mac) — откроется палитра команд
3. Набери Remote Gateway и выбери Connect to Remote Gateway... (или найди в Settings → Gateway → Remote)
4. Введи данные:
   • URL сервера: http://192.168.1.44:9119
   • Логин: admin
   • Пароль: agent
5. После подключения в левой панели появится серверный профиль — можно выбирать его и общаться как обычно.

Если Windows подключён через VPN или из другой подсети — IP может отличаться. Узнать текущий IP сервера: hostname -I

---

3. Управление сервисом (на сервере)

Сервис уже установлен и активен. Команды управления:

Действие	Команда
Статус	systemctl status hermes-dashboard.service
Стоп	systemctl stop hermes-dashboard.service
Старт	systemctl start hermes-dashboard.service
Рестарт	systemctl restart hermes-dashboard.service
Отключить автозапуск	systemctl disable hermes-dashboard.service
Логи (свежие)	journalctl -u hermes-dashboard.service -n 50
Логи (хвост)	journalctl -u hermes-dashboard.service -f

---

4. Безопасность

• Доступ к dashboard возможен из любого устройства в той же LAN (подсеть 192.168.1.0/24), кто знает логин/пароль
• За пределами LAN dashboard недоступен — сервер не торчит в интернет
• Пароль хранится в /root/.hermes/config.yaml — не свети этот файл
• Для доступа из интернета — облачный relay (Nous Portal) или VPN/SSH-туннель

---

5. Что если не работает

Симптом	Решение
Desktop пишет "Connection refused"	Сервис не запущен → systemctl start hermes-dashboard.service
401 Unauthorized	Неправильный логин или пароль — проверь в config.yaml секцию basic_auth
Desktop видит сервер, но не отвечает	hermes doctor на сервере — проверить модель и соединение
Нет соединения после ребута сервера	Сервис включён в автозапуск, проверь статус systemctl status hermes-dashboard.service