hermes gateway 命令 — 完整参考与示例

概述

hermes gateway 管理统一消息网关，将 Hermes 连接到 Telegram、Discord、WhatsApp、Weixin 等平台。它支持交互式前台模式，也支持作为后台服务运行。

hermes gateway <run|start|stop|restart|status|install|uninstall|list|setup|migrate-legacy|enroll>

子命令

run — 前台模式（推荐用于 WSL、Docker、Termux）

hermes gateway run
hermes gateway run -v           # 提高日志详细程度（-v=INFO，-vv=DEBUG）
hermes gateway run -q           # 静默所有 stderr 日志
hermes gateway run --replace    # 替换任何已存在的网关实例
hermes gateway run --force      # 即使已有服务监管该 profile 也强制启动

start / stop / restart — 服务控制

hermes gateway start
hermes gateway start --system   # 目标为 Linux 系统级服务
hermes gateway start --all      # 启动前先结束所有 profile 的残留网关进程
hermes gateway stop
hermes gateway restart

status — 显示网关状态

hermes gateway status
hermes gateway status --deep    # 深度状态检查
hermes gateway status -l        # 显示完整、未截断的输出
hermes gateway status --system  # 目标为 Linux 系统级服务

install / uninstall — 安装为服务

hermes gateway install --start-now
hermes gateway install --system --start-on-login --run-as-user hermes
hermes gateway uninstall
hermes gateway uninstall --system

选项：--force、--system、--run-as-user、--start-now、--no-start-now、--start-on-login、--no-start-on-login。

list — 列出所有 profile 及其网关状态

hermes gateway list

setup — 配置消息平台

hermes gateway setup

migrate-legacy — 移除旧版服务单元

hermes gateway migrate-legacy --dry-run
hermes gateway migrate-legacy -y

停止、禁用并移除旧版安装遗留的 hermes.service 单元，不会触碰 profile 单元或第三方服务。

enroll — 注册到 relay connector

hermes gateway enroll --token <TOKEN> --connector-url wss://connector.example.com/relay

选项：--token、--connector-url、--gateway-id、--wake-url。

常见场景

交互式运行网关

hermes gateway run

安装并启动为服务

hermes gateway install --start-now --start-on-login
hermes gateway status

配置更改后重启

hermes gateway restart

清理旧版服务单元

hermes gateway migrate-legacy --dry-run
hermes gateway migrate-legacy -y

技巧

• 初次设置、WSL、Docker 和调试时优先使用 hermes gateway run，错误会直接显示。
• 只有在理解第二个 dispatcher 可能破坏共享网关状态的前提下才使用 --force。
• start --all 会在启动服务前结束所有 profile 的残留网关进程。
• setup 会引导完成平台配置（Telegram、Discord、WhatsApp 等）。
• enroll 将 relay 凭据写入 ~/.hermes/.env；需要先登录（通过 hermes setup）。