> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qu.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# HiveOS 安装
> 在 HiveOS 上安装和运行 Quai Network GPU 挖矿程序。
## 简介
在这里，我们将安装 [quai-gpu-miner](https://github.com/dominant-strategies/quai-gpu-miner)，即 Quai Network ProgPOW 挖矿程序的实现。本教程重点介绍如何在 [HiveOS](https://hiveon.com/os/) 上安装和运行 quai-gpu-miner，HiveOS 是一个基于 Linux 的操作系统，使 GPU 挖矿变得简单。HiveOS 还提供了一个基于 Web 的仪表板，用于简化 Quai Network GPU 挖矿程序的管理和维护。
### 系统要求
为了在 HiveOS 上运行 quai-gpu-miner 并挖掘有效区块，您需要以下条件：
## 环境设置
### HiveOS
对于本教程，您需要一台 HiveOS 机器。关于如何在您的矿机上安装和配置 HiveOS 的说明，可以在 [HiveOS 安装文档](https://hiveon.com/install/) 中找到。
### 驱动程序和更新
一旦您在矿机上安装并设置了 HiveOS，您需要更新驱动程序、安装一些 GPU 实用程序包，并确保 Hive 是最新的。
在开始更新和安装之前，我们需要切换用户。通过运行以下命令来执行此操作：
```bash theme={null}
sudo su user
```
要升级 HiveOS，请运行：
```bash theme={null}
sudo selfupgrade
```
要更新和安装必要的显卡驱动程序，请运行：
```bash theme={null}
sudo nvidia-driver-update
```
在开始更新和安装之前，我们需要切换用户。通过运行以下命令来执行此操作：
```bash theme={null}
sudo su user
```
要升级 HiveOS，请运行：
```bash theme={null}
sudo selfupgrade
```
要更新和安装必要的显卡驱动程序，请运行：
```bash theme={null}
sudo nvidia-driver-update
```
驱动程序安装和更新完成后，我们需要安装 OpenCL：
```bash theme={null}
sudo amd-ocl-install 22.20
```
## 安装
现在所有的依赖项都已安装，我们可以安装 quai-gpu-miner。有两种安装选项：
对于绝大多数用户，建议通过预编译二进制文件安装 GPU 挖矿程序。这是开始挖矿最简单快捷的方式。
quai-gpu-miner 的最新版本可从 [GPU 挖矿程序发布页面](https://github.com/dominant-strategies/quai-gpu-miner/releases) 下载。
要将最新版本的二进制文件下载到 `output` 目录，请运行以下命令：
```bash theme={null}
sudo wget -P output https://github.com/dominant-strategies/quai-gpu-miner/releases/latest/download/quai-gpu-miner-nvidia
```
```bash theme={null}
sudo wget -P output https://github.com/dominant-strategies/quai-gpu-miner/releases/download/v0.4.0/quai-gpu-miner-amd
```
这将创建一个包含两个构建二进制文件的 `output` 目录：`quai-gpu-miner-amd` 和 `quai-gpu-miner-nvidia`。对于您拥有的显卡类型，运行以下命令使二进制文件可执行：
```bash theme={null}
chmod +x output/quai-gpu-miner-nvidia
```
```bash theme={null}
chmod +x output/quai-gpu-miner-amd
```
从源代码编译可能需要一段时间才能完成，并且需要大约 10GB 的内存。如果您的机器没有所需的内存，建议通过预编译二进制文件进行安装。
[quai-gpu-miner](https://github.com/dominant-strategies/quai-gpu-miner) 仓库包含一个[自动化脚本](https://github.com/dominant-strategies/quai-gpu-miner/blob/main/deploy_miner.sh)，可用于编译和配置挖矿程序。`deploy_miner.sh` 脚本将安装以下构建依赖项并构建最新版本的挖矿程序：
* git
* cmake
* build-essential
* mesa-common-dev
* [Nvidia CUDA Toolkit v12.6](https://developer.nvidia.com/cuda-12-6-0-download-archive)
要下载脚本，请运行以下命令：
```bash theme={null}
wget https://raw.githubusercontent.com/dominant-strategies/quai-gpu-miner/refs/heads/main/deploy_miner.sh
```
使 `deploy_miner.sh` 脚本可执行：
```bash theme={null}
sudo chmod +x deploy_miner.sh
```
要编译和配置挖矿程序，请使用以下命令运行脚本：
```bash theme={null}
sudo ./deploy_miner.sh
```
这将创建一个包含两个构建二进制文件的 `output` 目录：`quai-gpu-miner-amd` 和 `quai-gpu-miner-nvidia`。对于您拥有的显卡类型，运行以下命令使二进制文件可执行：
```bash theme={null}
chmod +x output/quai-gpu-miner-nvidia
```
```bash theme={null}
chmod +x output/quai-gpu-miner-amd
```
## 配置和运行
### 运行
要运行挖矿程序，您需要一个 Stratum 代理来连接。访问 [quai-stratum-proxy](/cn/guides/client/stratum) 文档以了解如何安装和配置它。代理配置将决定您的 gpu-miner 在哪个分片上运行以及奖励发放到哪个地址。
首先，您需要从 Stratum 代理日志中获取代理运行的 IP 地址和端口。默认端口是 `3333`。
如果您的挖矿程序和代理在同一台机器上，`PROXYIPADDRESS` 将是 `localhost`。如果您的挖矿程序和代理不在同一台机器上，您可能需要转发代理端口。
获得 IP 地址和端口后，使用以下命令运行挖矿程序，确保将 `PROXYIPADDRESS` 替换为 IP 地址，将 `STRATUMPORT` 替换为代理运行的端口：
```bash theme={null}
./output/quai-gpu-miner-nvidia -U -P stratum://PROXYIPADDRESS:STRATUMPORT
```
```bash theme={null}
./output/quai-gpu-miner-amd -G -P stratum://PROXYIPADDRESS:STRATUMPORT
```
quai-gpu-miner 现在应该正在运行并将日志输出到终端。
在确认您的节点已完全同步之前，不要启动挖矿程序。在节点未同步时挖矿将导致挖掘**无效区块**并**浪费算力**。
### 停止
要停止挖矿程序，只需使用 **CTRL+C** 来终止终端进程。一旦日志不再输出到终端，挖矿程序就已停止。