目录
Hermes Desktop 远程网关配置
0.16版本的Hermes agent 更新了remote功能，刚好自己的Hermes跑在腾讯云上，这次尝试下配置Hermes Desktop，总的来说比较简单，大部分操作都可以通过Hermes自动完成。
场景
- 服务器：腾讯云新加坡轻量服务器（Ubuntu），已经跑着 Hermes Agent + Tg Gateway
- 桌面端：Mac 上的 Hermes Desktop（Electron 原生应用）
- 目标：Desktop 不跑本地 Hermes，而是连到服务器上的 backend，复用服务器的 API key 和配置
一、服务器端配置
1. 确认版本
2. 设置 Dashboard 登录凭据
参数说明：
变量 | 作用 |
USERNAME | 登录用户名 |
PASSWORD | 登录密码 |
SECRET | JWT 签名密钥。设置后重启服务器 session 不丢失 |
3. 启动 Dashboard（两种方式）
直接告诉Hermes 讲dashborad加入到启动进程，将会完成以下这些操作。
方式 A：临时测试（tmux）
方式 B：生产环境（systemd 开机自启）
创建服务文件
/etc/systemd/system/hermes-dashboard.service：启动并启用：
4. 防火墙放行
可以通过云服务厂商自带的AI助手，语言描述，来添加规则，我使用的是腾讯云服务器。
二、Mac 桌面端配置
- 打开 Hermes Desktop
- Settings → Gateway → Remote gateway
- Remote URL 填入：
http://<服务器公网IP>:9119
- 点击 Sign in，输入用户名和密码
- 登录成功 → Save and reconnect
三、两种认证方式对比
ㅤ | 用户名/密码 | OAuth (Nous Portal) |
适用场景 | 内网 / VPN / 自己用 | 公网开放 / 多用户 |
配置难度 | 低（两行 env） | 中（需 Nous 账号 + dashboard register） |
安全性 | 需配合 HTTPS 或 VPN | OAuth 原生安全 |
依赖 | 无 | 服务器需能访问 portal.nousresearch.com |
四、常见问题
Q：Desktop 连上后，Telegram Gateway 还能用吗？
可以。Dashboard 和 Gateway 是两个独立进程，互不影响。
Q：服务器重启后 Desktop 会断吗？
如果配置了 systemd 服务（方式 B），dashboard 会自动重启。Desktop 端会自动重连（前提是设置了
SECRET，否则 session token 会失效）。Q：Desktop 的 session 和 Telegram 的 session 共享吗？
不共享。每个平台上的会话独立，但持久记忆（memory）是共享的——你在哪边留下的个人信息和工作习惯，两边都能读到。
Q：如何验证 Dashboard 正常运行？
连接成功后，桌面会读取到你所有的聊天记录，已经最底下的状态栏会显示当前模型、上下文大小等信息。
五、安全建议
- 不建议将用户名/密码的 dashboard 直接暴露在公网上
- 如必须公网暴露，请使用 OAuth (Nous Portal) 方式
- 认证账号密码请使用强密码