使用 hermes gateway start 命令让 AI 后台常驻运行

解决 Hermes Gateway 启动失败：从命令检查到 systemd 服务部署

执行 hermes gateway start 后服务未持续运行？无论是命令未找到、进程随终端关闭，还是启动后立即退出，问题根源通常指向三个层面：命令环境配置、后台守护进程模式，以及系统服务集成。遵循以下结构化排查流程，可系统性地定位并修复问题。

一、验证 Hermes Gateway 命令行环境

首先排除基础环境问题。命令无法识别通常意味着安装路径未加入系统 PATH，或安装过程未正确完成。

1. 在终端执行 which hermes。若返回类似 /home/username/.local/bin/hermes 的路径，则证明命令已就位。

2. 若无输出，表明命令未全局注册。需重新执行安装流程，或手动将 Hermes 二进制文件所在目录（如 ~/.local/bin）添加至 PATH 环境变量。

3. 环境变量修改后，执行 source ~/.bashrc（或对应 Shell 的配置文件如 ~/.zshrc）使更改在当前会话生效。

二、启用后台守护进程模式

命令可用但服务无法脱离终端运行，表明需要以守护进程模式启动。使用 --daemon 参数是关键。

1. 确保 Hermes 已完成初始化配置，且配置文件 ~/.hermes/.env 存在且包含有效的访问凭证。

2. 运行启动命令：hermes gateway start --daemon。

3. 使用 ps aux | grep hermes 验证相关进程是否已在后台运行。

4. 停止服务时，执行 hermes gateway stop。

三、注册为 systemd 系统服务（生产环境推荐）

对于要求高可用性、开机自启及集中日志管理的生产部署，将 Hermes Gateway 配置为 systemd 服务是最佳实践。

1. 生成服务文件：执行 hermes gateway setup-service。部分旧版本可能需要先运行 hermes gateway setup 完成交互配置。

2. 启用并启动服务：sudo systemctl enable --now hermes-gateway.service。

3. 检查服务状态：sudo systemctl status hermes-gateway，确认输出显示为 active (running)。

4. 实时查看日志：sudo journalctl -u hermes-gateway -f。

四、手动创建 systemd 服务文件（高级自定义）

若官方命令不可用，或需自定义执行路径、用户等参数，手动创建服务文件提供了完全控制权。确保所有路径准确无误。

1. 创建服务文件：sudo nano /etc/systemd/system/hermes-gateway.service。

2. 写入以下配置（务必将 /home/youruser 替换为实际用户主目录）：

3. 重载配置并启动：sudo systemctl daemon-reload && sudo systemctl enable --now hermes-gateway。

4. 验证服务状态：执行 systemctl list-unit-files | grep hermes，确认服务文件状态为 enabled。