feat(host-agent): start local console by default
Tests / Test passed: 662

This commit is contained in:
2026-07-14 07:31:31 +08:00
parent a166ffd8a4
commit 8b7e5a2800
10 changed files with 101 additions and 152 deletions
+4 -10
View File
@@ -392,22 +392,16 @@ uv run --package device-host-agent device-host-agent
首次启动顺序为:持久化候选 Host secret、向云端换取 `host_id`、为每个本地设备
换取 `device_id`、保存映射、连接 WDA、发送 heartbeat、开始 long-poll 领取任务。
Host Agent 不监听入站端口。必须保留并保护 `tasks/host_identity.json`
Host Agent 会在本机回环地址提供 Console。必须保留并保护 `tasks/host_identity.json`
`tasks/device_config.sqlite3`;前者等同于 Host bearer credential。
直接注册意味着任何能访问该云端地址的设备都能自行注册成为 Host,没有审批环节,
也没有限流保护;这一取舍依赖网络边界(防火墙/反向代理)而非应用层限制。
### 用本地 Web Console(可选)
### 使用本地 Web Console
Host Agent 内置一个默认关闭的本地 Web Console,用于在这台 Mac 上直接查看和管理
正在运行的 Host,无需 SSH 进去读原始状态文件。启用时追加环境变量后再启动:
```bash
export HOST_AGENT_CONSOLE_ENABLED="true"
uv run --package device-host-agent device-host-agent
```
Host Agent 启动时会同时启动本地 Web Console,用于在这台 Mac 上直接查看和管理
正在运行的 Host,无需 SSH 进去读原始状态文件。
不要修改 `HOST_AGENT_CONSOLE_BIND_HOST`,保持默认回环地址 `127.0.0.1`;Console
启动后在同一台 Mac 上打开: