Files
mining-client/README.md

112 lines
3.6 KiB
Markdown
Raw Permalink Normal View History

2025-11-26 11:39:20 +08:00
# 云算力平台卖方客户端
本程序为云算力平台卖方客户端用于将卖方身份与GPU主机绑定实现自动挖矿匹配功能。
## 功能特性
1. **身份绑定**将云算力平台上的卖方身份和GPU主机进行绑定
2. **GPU信息上报**自动获取并上报主机GPU详细参数GPU型号、显存容量等
3. **自动挖矿匹配**:自动匹配买方的挖矿需求,无需手动操作挖矿
## 系统要求
- Go 1.25.4 或更高版本
- Windows 或 Linux 操作系统
- 已配置好挖矿环境(显卡驱动、挖矿软件、执行权限等)
## 编译方法
### Windows 系统
在项目根目录下运行:
```bash
cmd\windows.bat
```
编译后的可执行文件将位于 `bin/client.exe`
### Linux 系统
在项目根目录下运行:
```bash
chmod +x cmd/linux.sh
./cmd/linux.sh
```
编译后的可执行文件将位于 `bin/client`
## 使用方法
1. **准备身份文件**:在 `bin` 目录下创建 `auth` 文件,包含你的卖方身份信息
2. **运行客户端**
- Windows: 运行 `bin\client.exe`
- Linux: 运行 `bin/client`
3. 客户端将自动:
- 读取身份信息
- 获取主机MAC地址和GPU信息
- 连接到云算力平台服务器
- 等待并处理挖矿任务
## 重要注意事项
### 启动前准备
1. **挖矿环境配置**:确保客户端执行主机已配置好挖矿环境,包括:
- 显卡驱动已正确安装
- 挖矿软件已安装并配置
- 执行权限已设置
- 可以手动通过挖矿软件进行挖矿
### GPU 操作注意事项
#### 移除 GPU
- 如果要对本机GPU进行移除拔出GPU操作云算力平台会同步移除对应的GPU
- **重要**如果在相关GPU有租约且没有在平台申请故障处理的情况下直接移除GPU会导致产生罚没
- **建议**在有租约的情况下要移除故障GPU请第一时间前往平台申请故障处理在平台确认后再进行移除GPU的操作
#### 更换 GPU
- 如果要对本机GPU进行更换拔出后又新插入GPU操作云算力平台会重新读取GPU数据
- 如果更换型号相同,则会按原有配置上架
- 如果更换的型号不同,则需在更换后前往卖家中心手动调整上架配置
- **重要**如果在相关GPU有租约且没有在平台申请故障处理的情况下直接更换GPU可能会导致产生罚没
- **建议**在有租约的情况下要更换故障GPU请第一时间前往平台申请故障处理在平台确认后再进行更换GPU的操作
## 项目结构
```
cloud-client/
├── bin/ # 编译输出目录
│ ├── auth # 身份认证文件(需手动创建)
│ ├── mining.linux.conf # Linux 挖矿配置
│ └── mining.windows.conf # Windows 挖矿配置
├── cmd/ # 主程序目录
│ ├── main.go # 程序入口
│ ├── windows.bat # Windows 编译脚本
│ └── linux.sh # Linux 编译脚本
├── internal/ # 内部包
│ ├── client.go # 客户端主逻辑
│ ├── msg/ # 消息处理
│ ├── src/ # 系统相关实现
│ │ ├── linux/ # Linux 系统实现
│ │ └── windows/ # Windows 系统实现
│ └── utils/ # 工具函数
├── go.mod # Go 模块定义
└── README.md # 本文件
```
## 依赖项
- `github.com/google/uuid` v1.6.0
- `gopkg.in/ini.v1` v1.67.0
## 许可证
[根据实际情况填写]