核心用法
Bitaxe Monitor 是一款专为 Bitaxe Gamma（及兼容型号）比特币矿机设计的监控工具，通过调用设备原生 HTTP REST API 获取实时运行数据。用户可通过 Python 脚本 bitaxe_status.py 查询矿机的算力、温度、功耗、风扇转速、矿池连接状态等核心指标，支持人类可读文本与原始 JSON 两种输出格式。
典型使用流程：
1. 首次配置：运行 --set-ip <IP> 将矿机 IP 持久化写入 shell 配置文件（~/.bashrc 或 ~/.zshrc）
2. 日常监控：直接执行脚本即可读取环境变量 BITAXE_IP 并获取状态
3. 临时覆盖：通过命令行参数指定其他 IP 地址，灵活管理多矿机
显著优点
- 即插即用：仅需矿机 IP 地址，无需额外认证或复杂配置
- 开源透明：基于 Bitaxe 官方开源固件（ESP-Miner），API 文档完善
- 多维度监控：涵盖算力（当前/1分钟/10分钟/1小时均值）、温度双监测（ASIC 芯片与电压调节器）、功耗、WiFi 信号强度、 share 统计等 15+ 关键字段
- 灵活集成：JSON 输出格式便于接入 Prometheus、Grafana 等监控体系或自动化脚本
潜在局限
- 局域网限制：仅支持同一网络内访问，无远程公网监控能力
- 单一设备生态：专为 Bitaxe 系列设计，无法兼容 Antminer、WhatsMiner 等其他品牌矿机
- 无持久化存储：脚本本身不提供历史数据存储，需借助
--format json对接外部系统 - 依赖设备端 API：若矿机固件更新导致 API 变更，需同步调整解析逻辑
适合人群
- 家庭矿场运营者（Home Miners）使用 Bitaxe Gamma/Ultra/Supra 设备
- 需要快速排查矿机过热、掉算力、网络连接故障的技术人员
- 构建轻量级监控面板的 DIY 爱好者
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 网络暴露风险 | 矿机 HTTP API 默认无认证，若暴露在公网可能被未授权访问 | 严格限制矿机位于防火墙后的内网，避免端口转发至公网 |
| 信息泄露 | API 返回包含 WiFi SSID、矿池地址等敏感信息 | 确保监控环境可信，日志文件妥善保管 |
| 固件兼容性 | 非官方固件或版本差异可能导致 API 响应格式异常 | 定期核对官方 API 文档（osmu.wiki）|
| 环境变量污染 | `--set-ip` 修改 shell 配置文件可能影响其他工具 | 备份 rc 文件，确认写入内容无误后再 source |
来源可信度与安全评估
本工具直接对接 Bitaxe 官方开源项目（bitaxeorg/ESP-Miner），API 规范公开可查，属于成熟的开源硬件生态组件。脚本仅执行只读查询操作，无写权限或控制功能，风险可控。