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

> 在 Linux 主机安装 Nonce Agent，并在开始矿机发现前确认连通状态

请在配置矿场时使用本指南。

<Info>
  安装前建议先查看 [Agent 硬件要求](/zh/user-guide/agent-hardware-requirements)。
</Info>

## 1. 创建 Agent 安装任务

1. 在矿场配置向导中进入 **Agent** 选项卡并点击 **Setup**。
2. 如果还没有 Agent，请先注册一个新的 Agent。

<Frame caption="创建 Agent 安装任务">
  <img src="https://mintcdn.com/nonce/Ohp2RKcoUPdYZHRb/images/onboarding/create-farm-4.1.png?fit=max&auto=format&n=Ohp2RKcoUPdYZHRb&q=85&s=320ff9b1a5b9341203026f7ded783b8d" alt="Agent 设置选项卡" width="3360" height="1780" data-path="images/onboarding/create-farm-4.1.png" />
</Frame>

## 2. 运行安装命令

1. 复制系统生成的 Shell 命令。
2. 在能通过网络访问矿机的服务器或 PC 上执行该命令。

<Frame caption="通过命令行安装 Agent">
  <img src="https://mintcdn.com/nonce/Ohp2RKcoUPdYZHRb/images/onboarding/create-farm-4.2.png?fit=max&auto=format&n=Ohp2RKcoUPdYZHRb&q=85&s=f34dbc07a9c54c5cf93639d06289ae2d" alt="用于安装 Agent 的 Shell 命令" width="3378" height="1780" data-path="images/onboarding/create-farm-4.2.png" />
</Frame>

<Warning>
  目前 Agent 仅支持基于 Linux 的安装（例如 Ubuntu、Debian、CentOS）。
</Warning>

<Info>
  如果矿机密码不是默认值，请先阅读 [如果我的矿机密码修改过，不是默认密码，怎么办？](/zh/user-guide/faq#custom-miner-password)。
</Info>

## 3. 确认安装并检查在线状态

1. 命令执行成功后，回到向导并点击 **confirm**。
2. 等待几分钟，让 Agent 回报版本、运行时长和连接状态。

<Frame caption="Agent 安装成功">
  <img src="https://mintcdn.com/nonce/Ohp2RKcoUPdYZHRb/images/onboarding/create-farm-4.3.png?fit=max&auto=format&n=Ohp2RKcoUPdYZHRb&q=85&s=42d3811551eb4b06d36b756d580fe81f" alt="安装完成后的确认面板" width="2612" height="1452" data-path="images/onboarding/create-farm-4.3.png" />
</Frame>

<Frame caption="Agent 在线状态">
  <img src="https://mintcdn.com/nonce/Ohp2RKcoUPdYZHRb/images/onboarding/create-farm-4.4.png?fit=max&auto=format&n=Ohp2RKcoUPdYZHRb&q=85&s=9797cbdb09ed39bd6d417bcd171d6d6e" alt="Agent 在线状态卡片" width="3362" height="1786" data-path="images/onboarding/create-farm-4.4.png" />
</Frame>

当 Agent 显示在线后，继续进行 [扫描网络以发现矿机](/zh/user-guide/onboarding/create-farm-scan-network-to-discover-miners)，然后前往 [查看矿场概览](/zh/user-guide/onboarding/view-farm-overview)。