> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nonce.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent 扫描机制

> 了解 Nonce Agent 的扫描链路、常见等待时间，以及影响扫描耗时的主要因素

本参考文档说明 Nonce Agent 如何发现矿机，以及矿机数据如何进入 Nonce。

## 总体流程

从整体上看，链路大致如下：

1. 你在 Nonce UI 中创建扫描任务。
2. Agent 轮询服务端任务并开始执行扫描。
3. Agent 按 IP 逐个探测目标网段，识别是否为矿机。
4. 一旦发现矿机，Agent 会立刻抓取该矿机详情，并发送实时更新。
5. 后端接收原始矿机数据后，会更新 Nonce 中展示的矿机记录。
6. 扫描结束后，Agent 仍会继续运行后台刷新任务，保持矿机数据持续更新。

## 扫描行为

### 手动扫描

* 手动扫描更偏向于尽快给出反馈。
* 在当前产品行为下，有些矿机可能会在整个扫描任务结束前就先出现在系统里。
* 矿机被发现后，Agent 也会把它加入后续持续监控列表。

### 自动扫描

* 已保存的自动扫描 IP 段会被定时重扫。
* 因此，即使你没有再次手动触发扫描，后续新接入的矿机也可能被发现。

## 配置好后，多久能看到矿机数据？

精确耗时取决于 IP 段大小、网络质量、矿机响应速度，以及你的部署是否修改过 Agent 默认时间参数。

在典型部署中，可以这样理解：

* **Agent 安装确认**：通常在执行安装命令并点击确认后的几秒内完成
* **手动扫描任务被 Agent 拉到**：通常约 5 到 10 秒
* **手动扫描后第一批矿机数据出现**：常见是几十秒内，因为发现矿机后会触发实时上传
* **常规全量矿机刷新**：默认约每 5 分钟一次
* **已保存 IP 段的自动重扫**：默认约每小时一次

<Tip>
  “任务执行成功”和“当前页面立刻显示最新矿机数据”并不一定发生在同一时刻。
</Tip>

## 哪些因素会影响扫描耗时？

影响最大的通常是以下几项：

* **IP 段大小**：扫描单个 `/24` 往往比一次扫多个大网段快很多
* **矿机响应速度**：矿机负载高或响应慢时，识别时间会更长
* **网络质量**：路由、丢包、防火墙策略都会影响探测速度
* **矿机密码配置**：某些机型如果 Web 密码不正确，会导致元数据抓取失败
* **重试机制**：Agent 会对失败的矿机抓取做重试，这能提升成功率，但也会增加等待时间