Gateway 常驻服务
要关闭终端后继续收消息、运行 Cron 和管理后台任务,需要常驻 Gateway。Dashboard、TUI、CLI 和消息渠道都连接到它;仅有一个页面打开,并不能证明它仍在线。
先看当前管理的是哪个 Home
anyy gateway status
anyy status
第一条检查服务与运行时,输出解析到的 Profile Home、服务宿主和 Socket;能获取版本时,还会比较运行中的 Gateway 与当前 CLI。第二条查看产品状态。排查多 Profile 时,先确认 Home 和 Socket,再决定是否停止或重启。
常用维护命令
anyy gateway start
anyy gateway restart
anyy gateway stop
start 在服务缺失时安装支持的服务并等待可达;restart 也会修复缺少服务安装的情况。macOS 使用 launchd 用户服务,常见 Linux 使用 systemd 用户服务,受支持部署还包括 procd 或 s6。
服务资产绑定一个 Home。macOS 的 com.anyy.anyy 和 systemd 的 anyy.service 不是每个命名 Profile 各有一份;已有资产属于另一 Home 时,不应靠手改服务文件覆盖它。--profile 选择要解析的 Profile,例如:
anyy --profile work gateway status
命名 Profile 的资料保持独立,服务能否管理它仍以实际宿主和归属检查为准。详见Profiles。
临时运行和常驻不同
TUI 在没有可用默认 Socket 时,可以为当前交互临时启动 Gateway;退出 TUI 会清理这次临时运行。需要长期在线时,显式启动常驻服务后再连接。
Gateway 停止会断开渠道并中断依赖它的实时工作。Dashboard 的独立进程或浏览器标签可能仍在,但不能继续使用已停止的 Gateway。维护前检查活动任务与需要保全的资料。
修改后用 Reload 还是 Restart
账号保存通常会触发运行时协调;渠道需要重新协调时用 anyy channel reload。改变 channel_webhooks.enabled/listen 这类启动监听设置,需要重启 Gateway。Webhook 监听不是 Dashboard 端口,设置见消息平台。
运行中的 Gateway 与当前 CLI 版本不同、服务已安装但不可达,或修复提示明确要求时,再使用 restart。不要通过删除 Socket 绕过 Profile 所有权。
排查顺序:
anyy gateway status
anyy doctor
anyy gateway restart
随后再次检查 status/doctor。若离线维护无法获得 Profile 锁,先停止持有该 Home 的运行时再重试;不能只凭进程名字结束其它 Profile。诊断字段见状态检查与 Doctor。