112 lines
3.6 KiB
Markdown
112 lines
3.6 KiB
Markdown
# 云算力平台卖方客户端
|
||
|
||
本程序为云算力平台卖方客户端，用于将卖方身份与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
|
||
|
||
## 许可证
|
||
|
||
[根据实际情况填写]
|
||
|