Web 控制台与 Agent

rauto 有两个看起来相似、但职责完全不同的服务入口：

rauto web
rauto agent

`rauto web`：本地自管理控制台

rauto web \
  --bind 127.0.0.1 \
  --port 3000

它适合单机使用，核心价值是提供一个本地浏览器界面来管理和执行：

已保存连接
命令模板
命令流模板
直接命令执行
事务块、事务工作流和编排
异步任务中心
命令黑名单
备份与恢复
录制与回放

Web 控制台的关键能力

连接配置的增删改查与导入
SSH 安全档位选择：secure、balanced、legacy-compatible
自定义设备 profile 与 prompt 诊断
会话录制、浏览器内回放和历史追踪
中英文界面切换

`rauto agent`：托管执行节点

rauto agent 不是本地自管 UI，而是为了接入 rauto-manager。

rauto agent \
  --bind 0.0.0.0 \
  --port 8123 \
  --manager-url http://manager:50051 \
  --report-mode grpc \
  --agent-name agent-beijing-01 \
  --agent-token my-secret-token \
  --probe-report-interval 300

Agent 模式提供什么

Agent 启动后，主要承担这些职责：

向 manager 注册和发送心跳
上报设备清单与离线通知
接收 manager 下发的任务
通过 HTTP 或 gRPC 回传事件与回调
暴露受保护的状态和探测接口

`web` 和 `agent` 如何分工

命令	面向谁	用途
`rauto web`	单机操作者	本地 UI、自管执行与资源管理
`rauto agent`	`rauto-manager`	被中心化控制平面纳管的执行节点

如果你只想在本机上管理模板、执行命令和查看回放，用 rauto web 即可。

如果你要把多台执行节点纳入统一控制，请使用 rauto agent。

Agent 配置文件

你也可以把 Agent 默认配置写到 ~/.rauto/agent.toml：

[manager]
url = "http://manager:50051"
token = "my-secret-token"
report_mode = "grpc"

[agent]
name = "agent-beijing-01"
heartbeat_interval = 30
probe_report_interval = 300

这样在启动时可以减少重复参数。

接入 `rauto-manager`

如果 manager 使用 HTTP 上报：

rauto agent \
  --bind 0.0.0.0 \
  --port 8123 \
  --manager-url http://<manager-host>:3000 \
  --report-mode http \
  --agent-name edge-sh-01 \
  --agent-token <same-agent-api-key>

如果 manager 使用 gRPC：

rauto agent \
  --bind 0.0.0.0 \
  --port 8123 \
  --manager-url http://<manager-host>:50051 \
  --report-mode grpc \
  --agent-name edge-sh-01 \
  --agent-token <same-agent-api-key>

什么时候应该引入 manager

当你出现这些需求时，通常说明应该从 rauto web 升级到 rauto-manager + rauto agent：

需要集中管理多台执行节点
需要共享设备清单和集中历史
需要由控制平面统一下发任务
需要实时看多 Agent 的状态和任务时间线

更多背景可查看 rauto-manager 概览。

Web 控制台与 Agent

rauto web：本地自管理控制台