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

77 lines
3.8 KiB
Markdown

# Подключение 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` |