简介cgminer 3.1.1 的 Windows 版本面向比特币及衍生币矿工、矿池运维者和挖矿程序研究者支持多线程、多矿池并能对 ATI 显卡进行监控、超频与风扇调速适配 GPU、FPGA 和 ASIC 设备同时提醒同一时间只能接入一条区块链网络。压缩包共 43 个文件、大小约 6.83MB主要包含 dll 动态库、cl 内核脚本、bit 位流文件、conf 配置样例、exe 可执行程序等dll 负责调用底层依赖cl 文件是 GPU 挖矿内核bit 文件对应 FPGA 矿机固件覆盖不同硬件的接入需求。包内还提供 example.conf 矿池配置模板、PHP 与 Java 的 API 调用示例、多份说明文档及编译记录便于快速调整参数并接入自己的矿池也为后续二次开发提供参考。资源已有 555 人浏览学习适合具有一定命令行基础、想深入了解挖矿客户端配置和扩展逻辑的爱好者参考使用。 说实话这玩意儿我在矿场上用了好几年直到现在手头有几台老设备还是会在 Windows 环境下翻出 cgminer-3.1.1-windows 这个包来跑。它是一款老牌开源挖矿客户端支持 ASIC、FPGA 和部分显卡设备连接矿池、调度算力、上报状态全靠它。这篇文章没有什么玄乎的概念就是我从下载、配置、启动到排查问题的完整实操记录写给想在 Windows 上把矿机跑起来、又想弄清楚每一步为什么这么操作的人。纯新手也能按着走老手可以直接跳到自己关心的参数和人坑部分。1. 为什么是 cgminer 3.1.1它在 Windows 生态里到底扮演什么角色1.1 cgminer 的定位矿池和矿机之间的“翻译官”很多人第一次接触挖矿以为下载一个软件就能自动出币其实中间的链路比想象中长。矿机ASIC、FPGA 或者显卡本身只会做一种事拼命计算哈希值。cgminer 做的就是把这些算力整合起来通过 stratum 协议连接到矿池然后把矿池下发的任务分配给每一台设备再把设备算出的结果提交上去。换句话说矿机和矿池互相说不了话cgminer 是中间那个翻译官。它的历史很长从 2011 年左右开始由开发者 ckolivas 维护中间经历了 CPU 挖矿、GPU 挖矿、FPGA 挖矿再到 ASIC 矿机普及的完整周期。3.1.1 这个版本恰好是在 ASIC 开始走向成熟的阶段发布的功能上已经非常完整既保留了过去的 GPU 支持也加入了对主流 ASIC 的良好适配Windows 编译包也在这个时期趋于稳定。所以很多矿场主会在 Windows 备用机上留着这个版本不是因为它新而是因为它经过了足够多实际场景的检验不容易出幺蛾子。1.2 Windows 版本为什么至今还有人用矿场的主力系统其实是 Linux因为更省资源、更稳定。但 Windows 有个不可替代的优势驱动安装方便。特别是用显卡挖矿或者半定制设备时Windows 下装驱动、看设备状态、查错误日志都比 Linux 直观得多。比如我用 cgminer-3.1.1-windows 管理一台组装矿机时设备管理器里能直接看到设备的 PCIe 或 USB 连接情况哪里没识别出来一目了然。另外cgminer 在 Windows 下是绿色免安装的解压即用。它自带一个命令行版的交互界面不需要额外跑一堆依赖对单机、几台设备的规模来说足够轻量。很多人担心老版本在新系统上跑不了实测从 Windows 7 到 Windows 11只要安装了合适的运行库它基本都能正常启动。这一点对怕折腾的用户来说比新版软件那一堆配置项友好得多。2. 部署准备Windows 下的运行环境、文件结构与设备检查2.1 压缩包里面到底有什么拿到 cgminer-3.1.1-windows 压缩包后解压出来你会发现文件并不多。核心的就一个cgminer.exe可执行文件另外有几个.dll动态库、一份示例配置文件cgminer.conf和一堆文本格式的说明文档。可执行文件非常大因为很多逻辑是静态编译进去的这反而省了安装依赖的麻烦。你可能会问为什么没有安装向导这是 cgminer 刻意保持的风格——命令行工具就该是复制、配置、运行三步走。有一个容易忽略的点解压路径最好不要带中文和空格比如别放到C:\Users\张三\我的矿机\这种目录下。虽然大部分情况能跑但偶尔会因为路径解析问题导致配置文件读取失败。我习惯放到C:\miner\这种短路径下省心。2.2 运行库和驱动准备Windows 下运行 cgminer 主要需要两样东西微软的 Visual C 运行库和对应挖矿设备的驱动。运行库是重中之重很多闪退都是因为这个没装。如果你用显卡挖矿还需要正确安装显卡驱动和 OpenCL 组件驱动版本不要太新也不太旧通常选择官方发布半年左右的稳定版即可。ASIC 矿机则要看具体型号有些需要安装专门的 USB 驱动比如某些矿机通过 USB 连接电脑时系统会提示安装驱动这时去设备管理器里更新驱动路径到矿机厂商提供的驱动目录就行。有一个很容易踩的坑装了驱动但系统不识别。解决办法是 USB 线换一个接口试优先插主板上直出的 USB 口不要用机箱前置面板的口供电不足会导致矿机反复掉线。我调试时遇到过一台矿机换了主板背板的 USB 口后立刻被识别之前前置口怎么装驱动都没反应。2.3 首次启动前的设备确认正式运行前先用命令cgminer.exe --verbose启动一次观察屏幕上输出了什么。如果看到类似Detected device with ID: 0之类的内容说明设备已经被软件识别。如果提示No devices detected不用急着改参数先从驱动和设备连接下手。还有一个建议在首次启动前把 Windows 的休眠、自动更新、屏幕保护都关掉。否则矿机跑着跑着系统自动休眠算力直接归零非常影响效率。这不是夸张我见过太多人问“为什么矿机每天定时掉线”一查就是系统默认的睡眠计划在捣乱。3. 核心配置拆解命令行参数和配置文件全解析3.1 从一行启动命令开始只要理解了这一行命令你就算入门 cgminer 了。下面是我在 Windows 上跑莱特币矿机时最常用的启动命令cgminer.exe --scrypt -o stratumtcp://mining.example.com:3333 -u your_username -p your_password --intensity 13逐个拆开说。--scrypt表示切换到 scrypt 算法这是莱特币这类币种的算法如果你挖的是比特币就把这个参数去掉默认走 SHA-256 算法。-o后面填矿池的 stratum 地址格式是stratumtcp://矿池域名:端口务必把协议头写完整光写域名是连不上的。-u和-p是你在矿池的登录账号和密码不同矿池规则略有区别有的直接填钱包地址就行。重点说--intensity这是挖矿工具里最影响性能的参数代表 GPU 或设备的工作密集程度。取值范围是 1 到 20数值越大计算越密集但不是越大越好。我测试过强度拉到 18 以上时虽然单卡算力会往上走一点但温度直线上升稳定性急剧下降最后反而因为频繁 restart 导致平均算力不如 13 的时候。所以我的习惯是先从 11 起步观察每半小时加 1直到出现不稳定再退回上一档。3.2 用配置文件替代命令行参数命令行参数适合临时调试但参数一多就容易敲错。更稳妥的做法是写一个cgminer.conf配置文件然后用-c参数指定它。下面是一份完整的示例{ pools : [ { url : stratumtcp://mining.example.com:3333, user : your_username, pass : your_password } ], intensity : 13, worksize : 256, api-listen : true, api-network : true, api-port : 4028, log : 5, quiet : false }这里面api-listen和api-network是开启 API 监控服务的开关后续可以用浏览器或脚本远程查看矿机状态这点我会在实操章节详细讲。log表示日志输出的详细级别调成 5 能看到最详细的运行记录。quiet设为 false 可以让控制台保持输出提示信息方便观察有没有报错。配置文件写好后启动命令就变得非常干净cgminer.exe -c cgminer.conf一个小技巧配置文件里可以配置多个pools当第一个矿池出问题时cgminer 会自动切换到下一个这比矿机在任务中间掉线再重新连接要稳得多。我会把主矿池和备用矿池都写进去这样矿池维护时不用手动改配置重新启动。3.3 参数避坑与调优心得这部分是我实际踩坑最多的地方。先说worksize这是每次向设备下发工作任务时的粒度大小默认 256 通常够用。但如果设备算力较高调成 512 有时能提升一点性能这需要逐台测试不要一刀切。再说thread-concurrency老版本软件中它用来控制并发线程数。设小了算力上不去设大了会直接导致驱动崩溃。最直接的判断标准是如果启动后几秒内系统报错或者画面卡死多半就是这个值设高了。我一般会参考设备显存大小来粗略估算比如 4G 显存从 8192 起步跑不稳就逐步降。还有温度控制。Windows 下没有像 Linux 那样方便的命令行温度查看工具但 cgminer 自带的--temp-target和--temp-overheat参数可以设置目标温度和过热保护温度。cgminer.exe -c cgminer.conf --temp-target 70 --temp-overheat 85当温度超过temp-overheat时软件会自动降频运行防止硬件损坏。这里建议目标温度不要设太高60 到 70 摄氏度是比较安全区间毕竟长期高温对电子元件的寿命影响很大。4. 实操实录从解压到稳定跑满的完整流程4.1 首次启动与矿池连接我在一台配置一般的 Windows 备用机上完整跑过一次流程这里把关键步骤都记录下来。机器是 Windows 10 系统一张 8G 显存的显卡连接的是某矿池的 stratum 服务。第一步解压cgminer-3.1.1-windows到C:\miner\把写好的配置文件也放到同一目录。第二步以管理员身份打开命令行窗口切换到软件目录执行cd C:\miner cgminer.exe -c cgminer.conf屏幕上会先显示几行算法和版本的提示信息接着是设备检测结果。看到2 GPU devices这样的字样表示两张显卡都被识别到了。然后终端会不断滚动提交算力的记录通常几秒后就会出现Accepted字样这代表矿池已经接受了提交结果整个连接链路是通的。第一次运行不要急着走开盯着状态栏看 10 分钟。cgminer 界面虽然简陋但信息很完整——右上角会显示当前总算力、平均算力、提交的份额数量、错误数量等。如果Accepted数量稳定上涨且没有Rejected被矿池拒绝说明配置没问题可以放心跑起来。4.2 通过 API 实现远程监控矿机放在另一个房间想随时知道它是否在正常工作可以用 cgminer 自带的 API。先确认配置文件中api-listen和api-network都是true然后启动软件API 服务就会默认监听在 4028 端口。在浏览器访问http://矿机IP:4028不过这里有个细节直接用浏览器看到的是原始 JSON 文本不太直观。我当时写了一个简单的 Python 脚本定期请求这个接口把关键信息解析出来再推到监控面板上。核心代码非常简单import urllib.request import json url http://127.0.0.1:4028/summary data json.loads(urllib.request.urlopen(url).read()) summary data[SUMMARY][0] print(Hash Rate: %.2f Mh/s % float(summary[MHS av])) print(Accepted: %s % summary[Accepted]) print(Rejected: %s % summary[Rejected])API 返回的数据很丰富除了算力、份额数还有温度、风扇转速、硬件错误数等做一个小型监控系统绰绰有余。很多人不知道的是cgminer 的 API 还支持部分控制操作比如通过gpuenable、gpudisable命令启用或禁用某一块显卡不用重启程序就能调整设备状态。我远程维护的时候就靠这个命令处理过故障卡。4.3 日志记录与故障复盘运行中出现问题不要慌先看日志。cgminer 在 Windows 下会把运行日志写入当前目录下的log文件夹中按日期存放。这些日志远比控制台输出的内容完整会记录每一次设备重启、矿池重连和错误详细原因。有一次矿机算力突然掉了 30%控制台只显示温度异常日志里则明确记录着某张卡在某个时间点触发了过热保护强制降频。顺着时间线往前查发现是另一张卡的风扇转速为 0原来是显卡风扇停转。日志让我快速定位到具体硬件问题而不必一块一块卡拆下来测试。养成定期看日志的习惯很多玄学问题其实都有据可查。5. Windows 平台常见问题排查与避坑指南5.1 设备无法识别或算力为 0这类问题在 Windows 下最常见。如果启动时提示No devices detected优先检查三件事驱动是否安装完整、设备是否在系统设备管理器里有感叹号、USB 线或者 PCIe 接口是否接触良好。很多时候把设备拔下来重新插一遍就能解决这不是玄学而是接触不良导致的信号问题。如果设备已经识别但算力一直为 0多半是设备驱动版本和软件不兼容。我的做法是去矿机厂商官网下载专门的 Windows 版驱动而不是用系统自动更新的通用驱动。驱动装好后重启电脑再启动 cgminer绝大多数情况下算力就能正常上去。5.2 闪退、崩溃、蓝屏闪退最常见的直接原因是运行库缺失请确保安装了完整版的 Visual C 运行库。另外一个容易忽略的原因是配置文件格式错误。JSON 格式里多了一个逗号或者引号写成了中文全角符号软件启动时会直接退出而且不会给出任何友好的错误提示。我自己就栽过这个跟头检查了半小时才发现配置文件里某个冒号是输入法自动补的全角字符。还有一个 Windows 特有的问题如果系统开了核心隔离或内存完整性某些老版本驱动无法正常加载也会导致软件崩溃。遇到这种情况可以在 Windows 安全中心里暂时关闭内存完整性再试。这不算解决根本问题但能帮你确认到底是哪一层出了问题。5.3 高温降频与长期运行稳定性长时间运行后算力下降先去查温度和风扇转速。Windows 的电源管理策略默认是平衡模式这会导致 CPU 和显卡在高负载时频率波动进而影响算力表现。我会在控制面板的电源选项里把计划改为高性能并关闭 USB 选择性暂停这个选项经常导致 USB 连接的矿机每隔一段时间就掉线。散热方面我的习惯是每三个月清一次灰、检查风扇转速。不要小看散热问题矿机 24 小时高负载运行灰尘积聚对散热的影响是持续的。使用 cgminer 内置的温度监控多关注几个数值当发现同型号设备之间温度差距超过 5 摄氏度时大概率是散热系统出了问题即使还能稳定运行也该安排维护了。最后再说点个人体会。cgminer 3.1.1 这个版本年纪不小了但它能在 Windows 上稳定工作这么多年本身就说明了设计和实现的扎实。刚开始折腾时一定要耐心看完启动日志把每一条参数的含义搞清楚再动手。我见过太多人一上来就把强度拉满、线程数调到最大值结果设备反复重启反而怪软件不稳定。实际部署中真正需要调的参数并不多把驱动、供电、散热这三件硬件底层的事做好软件层面用默认参数跑起来往往比你瞎调半天效果更好。如果你在配置或者运行中卡住了回头翻一翻控制台输出和日志文件答案大概率就在里面。本文还有配套的精品资源点击获取
