type: adr module: Hermes status: accepted date: 2026-06-14 author: Kabin tags: [#hermes, #adr, #desktop, #nas, #network]
ADR-002：笔记本 Hermes 桌面版连接方案¶
状态¶
accepted
背景¶
需要在 Windows 笔记本上使用 Hermes 桌面版。两台设备都在家里同一局域网（192.168.31.x），Hermes 主实例运行在极空间 NAS 的 Docker 容器中。需要确定桌面版以后端模式运行还是本地独立安装。
方案对比¶
| 方案 | 描述 | 优点 | 缺点 |
|---|---|---|---|
| A：笔记本本地安装 | 桌面版在笔记本本地装完整 Hermes runtime | 不依赖 NAS，离线可用 | 国内下载 Electron 卡在94%（需镜像加速）；模型推理吃笔记本算力 |
| B：重装 Docker 容器 | 在极空间 Docker 重建容器，加端口映射 9119:9119 | 标准方案，文档齐全 | 极空间商店版容器锁死无法编辑；重建容器有心理门槛 |
| C：利用已有端口 ✅ | 商店版容器已暴露 55145（Dashboard）和 55146（API），直接连 | 零改动，5 分钟搞定 | 端口非标准，需记住 55145 |
决策¶
选择： 方案 C — 利用商店版已有端口映射
理由： 1. 商店版容器无法编辑端口映射和 env，重建容器用户曾尝试但担心影响 2. 检查发现 Dashboard 已在容器内运行（PID 121），s6 监督自动保活 3. 用旧密码（Hermes2024!）测试连接成功，确认网络通路 4. 改回用户自定义密码（Swy58899900）后重启 Dashboard 进程即可
影响¶
| 影响范围 | 具体影响 |
|---|---|
| 桌面版配置 | Remote URL = http://192.168.31.27:55145，Basic Auth（kabin/Swy58899900） |
| 算力分布 | 笔记本仅做 UI 渲染，所有推理/工具跑在 NAS 上 |
| 微信/飞书 | 不受影响，走 NAS 端 gateway |
| 升级 | 封面版容器不碰，升级走商店版 |
| SOUL.md | 笔记本桌面版连 NAS 后自动继承 NAS 端的 SOUL.md |
备注¶
- NAS IP：192.168.31.27
- Dashboard 端口：55145（映射到容器 9119）
- API 端口：55146（映射到容器 8642）
- 登录：kabin / Swy58899900
- 故障恢复：Dashboard 意外挂掉时，进入 Hermes 容器进程（PID 共享）执行
kill <dashboard_pid>即可让 s6 重启