矿工软件使用说明 - Abcmint Pool [TESTNET]

本文档介绍 abcmint-miner-cuda 命令行版矿工软件的完整使用方法。该软件是 MQSCAN 第三方开发的 ABCMint 挖矿客户端，并非 abcmint-master 官方矿池软件。仅支持 Linux 系统（推荐 Ubuntu 20.04），支持 CPU 和 CUDA GPU 挖矿。

提示：本文档仅适用于 abcmint-miner-cuda 命令行版本，不适用于 GUI（图形界面）版本的 ABCMint Miner。

info1. 软件概述

abcmint-miner-cuda 是基于 Stratum 协议的 ABCMint 命令行挖矿客户端，核心特性：

特性	说明
挖矿算法	MQ (Multivariate Quadratic) 多元二次方程
连接协议	Stratum 挖矿协议
CPU 支持	支持，多线程并行
GPU 支持	支持 NVIDIA CUDA 显卡，支持多卡并行
自动重连	支持断线自动重连，指数退避
钱包绑定	首次挖矿自动注册钱包地址

checklist2. 挖矿前准备

开始挖矿前，需要完成以下步骤：

① 准备 ABC 钱包地址

你需要一个 ABCMint 钱包地址（长度 > 30 字符）。主网地址以 8 开头，测试网地址以 q 或 r 开头。可以通过 ABCMint 钱包客户端生成。

② 绑定钱包到用户名

在矿池主页点击"绑定钱包地址"，或使用以下 API 接口绑定：

curl -X POST http://154.12.89.175:8081/api/bindWallet \
  -H "Content-Type: application/json" \
  -d '{"username": "你的用户名", "wallet": "你的ABC钱包地址"}'

注意：用户名绑定后不可修改，请确保用户名唯一。

③ 获取矿池连接信息

项目	值
Stratum 地址	`154.12.89.175:3335`
HTTP API	`http://154.12.89.175:8081`
挖矿算法	MQ (Multivariate Quadratic)

terminal3. 基本使用命令

最简单的挖矿命令（GPU模式，自动连接默认矿池）：

./release/abcmint-miner-cuda -user 你的用户名 -password 8ABCdef...your_wallet_address

软件会自动：

连接矿池 Stratum 服务器
使用你的用户名授权登录
自动检测 CPU 核心数并启动对应数量的线程
开始接收挖矿任务并进行计算
找到解后自动提交份额（share）到矿池
断线后自动重连

提示：按 Ctrl+C 可安全停止挖矿。

list_alt4. 所有命令行参数详解

运行 ./abcmint-miner-cuda -h 可查看帮助信息。以下是所有支持的参数：

参数	类型	默认值	说明
`-pool <host:port>`	字符串	`mqscan.io:3334`	矿池 Stratum 服务器地址（可选，不填自动连接 `mqscan.io:3334`）。`mqscan.io` 为矿池域名，会自动 DNS 解析到当前矿池 IP
`-user <username>`	字符串	`worker`	矿工用户名。支持两种格式： • `用户名`（如 `mark`） • `用户名.矿工ID`（如 `mark.001`）
`-password <password>`	字符串	必填	abcmint 钱包地址（参数名沿用 Stratum 协议惯例，但实际填的是钱包地址，不是密码）。 • 主网：以 `8` 开头 • 测试网：以 `q` 或 `r` 开头长度需 > 30 字符。首次挖矿时用于向矿池注册并绑定到 `-user` 用户名；已注册用户名必须与原绑定地址一致。
`-threads <count>`	整数	CPU 核心数	挖矿线程数。CPU 模式下为纯 CPU 线程数； GPU 模式下会自动调整为显卡数的倍数。例如4张显卡时填8，则每张卡分配2个线程
`-cuda`	开关	关闭	启用 CUDA GPU 挖矿。加上此参数后使用 GPU 进行核心计算。如未安装 CUDA 驱动或无 NVIDIA 显卡，会自动回退到 CPU 模式
`-h` 或 `--help`	开关	—	显示帮助信息并退出

注意：-password 是必填参数（实际填钱包地址，不是密码）。参数名沿用 Stratum 协议惯例未改名以保持向后兼容；省略或填 x 会导致启动失败。CLI 运行 ./abcmint-miner-cuda -h 时帮助文本也已说明该参数为 abcmint wallet address。

memory5. CPU 挖矿

使用 make cpu 编译的 CPU 版本挖矿：

./release/abcmint-miner -user mark -password 8ABCdef...your_wallet_address

也可以指定线程数：

./release/abcmint-miner -user mark -password 8ABCdef...your_wallet_address -threads 4

提示：默认线程数为 CPU 逻辑核心数，一般不需要手动指定。

developer_board6. GPU (CUDA) 挖矿

使用 make 或 make gpu 编译的 GPU 版本（默认启用 CUDA）：

./release/abcmint-miner-cuda -user mark -password 8ABCdef...your_wallet_address

GPU 挖矿需要：

NVIDIA 显卡（支持 CUDA 架构）
已安装 NVIDIA CUDA 驱动和 Toolkit
软件编译时已启用 USE_GPU 宏

注意：如果没有 NVIDIA 显卡或未安装 CUDA 驱动，软件会输出警告并自动回退到 CPU 模式。

view_module7. 多显卡并行挖矿

软件支持多张 NVIDIA 显卡同时挖矿。只需使用 GPU 版本并通过 -threads 指定总线程数：

./release/abcmint-miner-cuda -threads 8 -user mark -password 8ABCdef...your_wallet_address

线程分配规则：

软件会自动检测可用 GPU 数量，并将线程均匀分配到每张卡上。

显卡数	-threads	每卡线程数	分配方式
1	4	4	GPU0: 4线程
2	4	2	GPU0: 2线程, GPU1: 2线程
4	8	2	GPU0~3: 各2线程
4	4	1	GPU0~3: 各1线程

提示：线程数会被自动调整为显卡数的整数倍。例如3张显卡、-threads 5，实际会使用3个线程（每张卡1个）。

启动时软件会输出设备检测信息：

CUDA devices detected: 4
Mode: CUDA GPU (4 devices, 2 threads/device)

8. 常用场景示例

场景 1：单卡 GPU 挖矿

./release/abcmint-miner-cuda -user mark -password 8ABCdef...your_wallet_address

场景 2：多卡 GPU 挖矿（4张显卡）

./release/abcmint-miner-cuda -threads 8 -user mark -password 8ABCdef...your_wallet_address

场景 3：纯 CPU 挖矿（指定4线程）

./release/abcmint-miner -threads 4 -user mark -password 8ABCdef...your_wallet_address

场景 4：指定用户名+矿工ID

./release/abcmint-miner-cuda -user mark.001 -password 8ABCdef...your_wallet_address

场景 5：Linux 后台挖矿（日志输出到文件）

cd /root/standalone-miner && nohup ./release/abcmint-miner-cuda -threads 4 -user mark -password 8ABCdef...your_wallet_address > miner.log 2>&1 &

场景 6：查看实时挖矿日志

tail -f /root/standalone-miner/miner.log

output9. 运行输出说明

软件启动时会显示以下信息：

========================================
  Abcmint Standalone Miner v1.0
========================================
Pool: mqscan.io:3334
Worker: mark.00001
Threads: 4
Mode: CUDA GPU (1 devices, 4 threads/device)
========================================

连接成功后：

Successfully connected and authorized!
Nonce offset for this session (from pool): 1234567890
Starting mining threads...
Mining thread 0 (GPU:0) started (nonce offset: 1234567890)
Mining thread 1 (GPU:0) started (nonce offset: 1234567891)
Mining started. Press Ctrl+C to stop.

找到解时会输出：

Thread 0 found solution!
  Nonce: 01234567

工作报告（心跳）：

[WorkReport] Sent #1 (jobId: 123)
[WorkReport] Sent #2 (jobId: 123)

断线重连：

[Reconnect] Connection lost! Attempting to reconnect...
[Reconnect] Attempt #1 - Connecting to mqscan.io:3334...
[Reconnect] Successfully reconnected after 1 attempts!

停止挖矿：

Stopping mining threads...
Mining thread 0 stopped
Mining thread 1 stopped
Mining stopped. Goodbye!

power10. 后台运行

Linux 系统：

使用 nohup 在后台运行，日志输出到文件：

cd /root/standalone-miner && nohup ./release/abcmint-miner-cuda -threads 4 -user mark -password 8ABCdef...your_wallet_address > miner.log 2>&1 &

查看后台进程：

ps aux | grep abcmint-miner-cuda

查看实时日志：

tail -f miner.log

停止挖矿进程：

pkill -9 abcmint-miner-cuda

注意：本矿工客户端仅支持 Linux 系统，不支持 Windows。请使用 Ubuntu 20.04 或更高版本的 Linux 发行版。

build11. 常见问题排查

问题	可能原因	解决方法
连接失败	网络不通	测试网络连通性 `ping mqscan.io`，确认端口 3334 可达
授权失败	用户名格式错误 / 钱包地址错误	确保 `-user` 参数格式正确（用户名或用户名.矿工ID）；`-password` 必须为合法 ABCMint 钱包地址（主网 `8` 开头，测试网 `q`/`r` 开头，长度 > 30），且与已绑定用户名一致
未检测到 CUDA 设备	无 NVIDIA 显卡 / 驱动未安装 / 编译未启用 GPU	运行 `nvidia-smi` 检查显卡状态；确认使用 GPU 版本编译
GPU 回退到 CPU 模式	CUDA 驱动异常 / 显卡故障	检查 CUDA 驱动版本，重启系统后重试
频繁断线重连	网络不稳定 / 矿池维护	软件支持自动重连，检查网络质量
矿池显示离线	钱包地址未绑定	在矿池主页绑定钱包地址到用户名
看不到算力收益	刚启动 / 尚未提交有效份额	挖矿需要时间积累份额，等待几分钟后再查看矿池状态
多卡只用到一张卡	线程数不足 / 软件非多卡版本	确保 `-threads` 数 ≥ GPU 数，且使用最新编译版本

提示：如果遇到问题，可以查看矿工日志 miner.log 中的错误信息，或联系矿池管理员寻求帮助。

目录

8. 常用场景示例