bitaxe-monitor

⛏️ 比特币矿机实时监控助手

基于 Bitaxe 官方 API 的开源矿机监控工具,实时获取算力、温度、功耗数据,零第三方依赖,轻量可靠。

收藏
1.4k
安装
551
版本
v1.0.2
CLS 安全性认证2026-07-11
点击查看完整报告 >

使用说明

Bitaxe Monitor 是一款专为 Bitaxe Gamma 比特币矿机设计的轻量级监控工具,通过调用设备内置 REST API 实时获取运行状态数据。

核心用法

该技能通过 Python 脚本与矿机 HTTP API 通信(默认端点 /api/system/info),获取包括实时算力(GH/s)、1分钟/10分钟/1小时平均算力、ASIC 温度、电压调节器温度、风扇转速、功耗(瓦特)、矿池连接状态、WiFi 信号强度及运行时间等关键指标。用户可通过三种方式配置目标设备 IP:命令行参数直接指定、使用 --set-ip 保存至 ~/.config/bitaxe-monitor/config.json 配置文件,或设置 BITAXE_IP 环境变量。脚本支持 --format 参数在文本(带表情符号的人类可读格式)与 JSON(结构化数据)输出间切换,便于日常检查或自动化集成。

显著优点

该技能的核心优势在于零外部依赖,仅使用 Python 标准库(urllib, json, argparse, os)实现,彻底规避了第三方包供应链攻击风险。代码经过安全审计确认无 eval/exec/subprocess 等危险函数,无动态代码加载行为,安全透明。配置管理设计合理,配置文件独立存储于用户主目录,不修改系统 shell 配置文件。错误处理机制完善,对网络超时、无效 JSON 响应、连接失败等异常情况均有捕获和友好提示。输出格式灵活,既提供直观的文本报告(含状态表情符号),也支持结构化 JSON 便于集成到 Grafana 等监控系统。

潜在缺点与局限性

作为专用监控工具,其适用范围受限于 Bitaxe Gamma 及兼容硬件(基于 BM1370 ASIC),无法通用于蚂蚁矿机、神马矿机等其他品牌设备。功能聚焦于状态查询,不支持远程修改矿机配置(如频率、电压调整)或固件升级等写操作。虽支持通过命令行参数逐个查询不同 IP,但缺乏对大规模矿机集群的批量并行监控能力。来源为个人开发者(T3 级),虽代码安全但仍建议用户自行审查。此外,脚本仅支持标准 HTTP 协议,若未来矿机固件启用 HTTPS 或 HTTP Basic 认证,当前版本将无法兼容。

适合的目标群体

主要面向比特币挖矿爱好者小型家庭矿场运维人员硬件 DIY 开发者。适合需要轻量级、本地化监控方案且注重数据隐私(不希望将矿机数据上传至第三方云端监控平台)的用户。对于运行 1-10 台 Bitaxe 设备的家庭矿工或实验室环境,该工具提供了开箱即用的监控能力。开发人员也可将其作为自动化运维脚本的基础组件,通过 JSON 输出集成到更大的矿机管理系统或通知告警平台中。

使用风险

常规风险包括:网络配置风险,若错误配置 IP 地址可能向局域网内其他设备发送 HTTP 请求,虽无破坏性但可能导致信息泄露;内网暴露风险,Bitaxe API 默认无身份验证机制,在不可信网络环境中暴露矿机 IP 和 API 端口(默认 80)可能遭受未授权访问或扫描;硬件兼容性风险,API 响应格式随 ESP-Miner 固件版本更新可能发生变化,极端情况下可能导致 JSON 解析失败;性能风险,过于频繁的轮询(如通过 cron 每分钟多次执行)可能对矿机嵌入式系统造成轻微负载,建议合理设置检查间隔。

安全解读

核心功能

bitaxe-monitor 是专为 Bitaxe Gamma 开源比特币矿机打造的状态监控工具。该矿机基于 BM1370 ASIC 芯片,本 Skill 通过调用其 REST API (/api/system/info) 实时获取运行数据,并以人类可读文本或原始 JSON 格式呈现。

关键监控指标

  • 算力数据:当前实时算力、1分钟/10分钟/1小时平均值(GH/s)
  • 热管理:ASIC 核心温度、电压调节器温度、风扇转速百分比与 RPM
  • 电力监控:实时功耗(W)与电压
  • 挖矿统计:接受/拒绝份额数、历史最高难度
  • 网络状态:WiFi 信号强度(dBm)、矿池连接信息
  • 系统信息:运行时长、固件版本

使用方式

通过 Python 脚本 bitaxe_status.py 调用,支持三级 IP 配置优先级:命令行参数 > 配置文件 (~/.config/bitaxe-monitor/config.json) > 环境变量 BITAXE_IP。首次使用 --set-ip <IP> 可持久化保存配置,后续直接运行即可查看状态。

显著优点

1. 零依赖设计:仅使用 Python 标准库(urllib, json, argparse, os),无第三方包依赖,供应链攻击面为零
2. 配置灵活:支持配置文件、环境变量、命令行参数三种 IP 配置方式

3. 输出友好:文本格式带 emoji 指标指示,JSON 格式便于自动化集成

4. 错误处理完善:对连接失败、无效响应、网络超时等场景均有优雅降级

潜在局限

1. 明文传输:使用 HTTP 而非 HTTPS,在不可信网络环境中存在嗅探风险(矿机通常部署于本地网络,风险可控)
2. 输入验证简单:IP 地址未做严格格式校验,可能因输入错误导致连接失败

3. 功能单一:仅支持状态读取,不支持远程配置修改或固件升级

4. 数据来源:由个人开发者 (pietro395) 维护,非官方 Bitaxe 团队作品

适合人群

  • Bitaxe Gamma / Supra / Ultra 等兼容矿机的个人矿工
  • 希望搭建简易矿场监控系统的家庭挖矿用户
  • 需要通过脚本自动化采集矿机数据的开发者

常规风险

  • 网络层风险:HTTP 明文传输,建议仅在受信任的本地网络使用
  • 配置持久化风险:IP 与 WiFi 信息以明文存储于用户目录,多用户系统需注意权限隔离
  • 供应链风险:尽管当前版本安全,但个人开发者仓库需持续关注更新动态

安全评估结论

CLS-Certify v2.1.0 全量扫描评分 95/100(S 级),六维检测全部通过:

  • 无危险函数调用,无敏感信息硬编码
  • 无代码混淆或动态代码加载
  • 网络请求严格限定于用户指定的本地设备 IP

bitaxe-monitor 内容

scripts文件夹
手动下载zip · 4.5 kB
bitaxe_status.pytext/plain
请选择文件