跳到主要内容

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 后服务仍已安装但不可连接;
  • 正在完成一项必须离线进行的维护操作。

排查顺序

  1. 查看服务本身:

    anyy gateway status
  2. 运行综合诊断:

    anyy doctor
  3. 重启当前 Profile 的服务:

    anyy gateway restart
  4. 再次运行 statusdoctor。在此之前不要直接手改 Socket 或服务管理器文件。

现象下一步
服务尚未安装anyy gateway start
服务命令来自另一版本更新 Anyy 后执行 anyy gateway restart
Dashboard/TUI 无法连接确认它们解析到同一个 Profile 和 Socket
离线维护无法获取所有权停止这个 Profile 的 Gateway 后重试

诊断字段详解见 状态检查与 Doctor