> ## 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.

# 安装与更新 Nonce Agent

> 在矿场现场的主机上安装 Nonce Agent，确认 Agent 在线，并在 Nonce 中更新 Agent。

Nonce Agent 运行在矿场现场的主机上，将矿场的矿机接入 Nonce。每个矿场使用各自的 Agent。

## 开始之前

* **角色**：安装和更新 Agent 需要 Admin 或 Manager 角色。
* **主机**：64 位 x86（x86\_64）主机，运行使用 systemd 的 Linux 并具备 root 或 `sudo` 权限，或运行 Windows（Beta）。主机配置见[主机要求](#主机要求)。
* **网络**：主机需要通过 HTTPS 访问 `agent.nonce.app`，并稳定连接每台矿机的 TCP 80、443 和 4028 端口。

> [!NOTE]
>
> Windows 版本处于 Beta 阶段。Windows 主机在 PowerShell 或命令提示符中运行安装命令。Windows 版本与 Linux 版本有三点不同：
>
> * **窗口**：Agent 在独立窗口中运行，需保持窗口开启。窗口关闭后，打开桌面上的 **Nonce Agent** 快捷方式重新启动 Agent。
> * **开机启动**：Agent 不随主机启动。
> * **更新**：无法在 Nonce 中更新 Agent。

## 安装 Agent

1. 在 Nonce 中打开矿场设置，选择 **Agent** 标签页。
2. 点击**设置**。Nonce 创建 Agent，并打开**设置 Agent** 对话框。
3. 选择 **Linux** 或 **Windows**，点击安装命令，将其复制。
4. 在主机上运行该命令。
5. 在对话框中点击**确认**。Nonce 提示「Agent 安装成功」，**Agent** 标签页显示 Agent 的 ID、版本和运行时长，状态点为绿色。

Nonce 提示「Agent 尚未安装」时，等待命令执行完毕，再次点击**确认**。

> [!WARNING]
>
> 安装命令包含该 Agent 的 ID 和密钥，只用于当前矿场。

## 更新 Agent

Agent 不会自动更新。

1. 在矿场设置中打开 **Agent** 标签页。
2. 点击**检查更新**。对话框显示可用版本的更新日志。
3. 点击**更新**。Agent 下载并校验新版本，然后重启。

对话框提示「当前没有可用的更新」时，Agent 已是最新版本。

## 主机要求

| 系统 | 要求 |
| - | - |
| Linux | 使用 systemd 的 64 位 x86（x86\_64）发行版。Agent 已在 Ubuntu 22.04、24.04 和 Debian 11、12 上测试。安装需要 root 或 `sudo` 权限。不支持 Raspberry Pi 等 ARM 主机。 |
| Windows（Beta） | 64 位 Windows 10 或 11。安装不需要管理员权限。 |

硬件按 Agent 管理的矿机数量选择对应的一行。表中数值按每 5 分钟采集一次估算。

| 矿机数量 | 示例硬件 | 最低内存 | CPU | 存储 |
| - | - | - | - | - |
| 最高 1,000 台 | — | 2 GB | 双核 x86\_64 | 32 GB |
| 最高 10,000 台 | Intel Core i5 或同级桌面机 | 4 GB | 4 核中端 CPU（含超线程） | 32 GB |
| 最高 20,000 台 | Intel Core i7 或同级工作站 | 8 GB | 8 核中端 CPU（含超线程） | 32 GB |
| 最高 30,000 台 | Intel Core i7 或同级工作站 | 16 GB | 10 核中端 CPU（含超线程） | 32 GB |
| 50,000 台及以上 | Intel Core i9 或同级服务器 | 24 GB | 12 核中端 CPU（含超线程） | 32 GB |

* **存储**：使用 SSD。表中的存储容量以 SSD 为前提，因为 Agent 需要写入矿机数据和日志，并缓存固件包。
* **余量**：主机同时执行网络扫描和固件更新，或运行多个 Agent 实例时，预留额外的硬件资源。
* **网络**：建议使用千兆以太网。

## 安装程序所做的配置

在 Linux 上，安装程序将 Agent 注册为 systemd 服务，并创建存放 Agent 文件的目录：

| 项目 | 位置 |
| - | - |
| 服务 | `nonce-agent`。服务随主机启动，Agent 停止后自动重启。 |
| 配置文件 | `~/.nonce-agent-default/.env` |
| 日志 | `~/.nonce-agent-default/logs/`。Agent 保留 14 天的日志。 |

`~` 是运行安装命令的用户的主目录。

## 后续步骤

* [扫描矿机](https://docs.nonce.app/zh/user-guide/onboarding.md#第-4-步：扫描矿机)：添加矿场的 IP 段并运行第一次扫描
* [Nonce Agent 工作原理](https://docs.nonce.app/zh/user-guide/agent-scan-mechanism.md)：扫描何时运行，Agent 多久采集一次数据
* [Nonce Agent 故障排查](https://docs.nonce.app/zh/user-guide/agent-scan-troubleshooting.md)：处理 Agent 离线、矿机缺失和非默认矿机密码


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.