Gateway 常驻服务
Gateway 是 Anyy 的常驻运行时。会话、工具、渠道、Cron、后台任务和消息投递在这里运行;TUI、Dashboard、CLI 和消息平台都连接到它。
先看服务状态
anyy gateway status
输出会说明当前解析到的 Profile 目录、服务宿主、Socket、进程状态,以及服务命令是否与当前安装版本一致。
需要同时查看整个产品的状态时,再运行:
anyy status
启动、重启与停止
anyy gateway start
anyy gateway restart
anyy gateway stop
start 会在服务尚未安装时安装当前系统支持的用户服务,并短暂等待运行时可连接。restart 遇到缺少服务安装时也会先补齐再启动。
Anyy 会使用宿主系统支持的服务管理方式,例如 macOS 的 launchd 用户服务、常见 Linux 的 systemd 用户服务,以及已经支持的 procd 或 s6 环境。
停止会中断常驻工作
Gateway 停止后,渠道会断开,正在运行的定时任务、后台工作和所有连接界面都会受影响。维护前先确认没有重要任务在运行。
管理指定 Profile
一个常驻 Gateway 服务于一个解析后的 Profile:
anyy --profile work gateway status
anyy --profile work gateway restart
不要让两个自行启动的 Gateway 同时使用同一个 Profile。离线写操作会获取 Profile 所有权,就是为了避免与常驻运行时同时修改状态。
什么情况下才重启
多数 Dashboard 和设置操作会自动刷新运行时,不需要手动重启。以下情况再重启:
gateway status提示命令或版本不一致;- 修复提示明确要求重启;
- 正常 Reload 后服务仍已安装但不可连接;
- 正在完成一项必须离线进行的维护操作。
排查顺序
-
查看服务本身:
anyy gateway status -
运行综合诊断:
anyy doctor -
重启当前 Profile 的服务:
anyy gateway restart -
再次运行
status和doctor。在此之前不要直接手改 Socket 或服务管理器文件。
| 现象 | 下一步 |
|---|---|
| 服务尚未安装 | anyy gateway start |
| 服务命令来自另一版本 | 更新 Anyy 后执行 anyy gateway restart |
| Dashboard/TUI 无法连接 | 确认它们解析到同一个 Profile 和 Socket |
| 离线维护无法获取所有权 | 停止这个 Profile 的 Gateway 后重试 |
诊断字段详解见 状态检查与 Doctor。