AxeOS 是构建在该固件之上的操作系统和 Web 界面，它是您通过浏览器与之交互的仪表盘和控制层。在日常使用中，大多数人将整个系统统称为 AxeOS。
AxeOS 是专门为 Bitaxe 系列矿机设计的开源固件，基于 ESP-IDF 框架运行在 ESP32-S3 芯片上。它通过内置 Wi-Fi 模块开启一个本地 Web 服务器，让你直接用浏览器访问 192.168.xx.xx 就能实时监控算力、芯片温度（通常运行在 50–65°C）和 Stratum 连接状态。AxeOS 无需任何外部软件、移动应用或云账户。Bitaxe 矿机配置完成后即可自主运行。您只需要一台与矿机连接到同一 Wi-Fi 网络的网络浏览器即可。
1、How does it Run🏃
很多人第一次看到 Bitaxe Miner 的时候会问：这个小盒子到底靠什么跑起来的？答案是 AxeOS 固件，它是整台机器的神经中枢，负责驱动 BM1366/BM1368/BM1370/BM1373等 ASIC 芯片完成 SHA-256 哈希运算，同时协调 Wi-Fi 通信、温控策略和矿池协议握手。
其底层代码库名为 ESP-Miner，托管于github.com/bitaxeorg/ESP-Miner。ESP-Miner是一个完整的固件包，负责处理从 ASIC 通信到网络连接的所有功能。
从底层机制来看，AxeOS 启动后会依次完成以下流程：
- 💪上电自检（POST）：检测 ASIC 芯片是否正常响应，同时读取 NVS 存储中的矿池配置信息
- ➡️ Wi-Fi 连接：使用 WPA2 协议连入局域网，获取 DHCP 地址；若连接失败，自动切换至 AP 模式（热点 SSID：bitaxe）供初次配置
- 🔥 Stratum 握手：与矿池建立 TCP 长连接，完成
mining.subscribe和mining.authorize两步认证 - ⚠️任务调度：ESP32-S3 将矿池下发的 Work 分包推送给 ASIC 芯片，芯片以 GH/s、TH/s为单位的速率持续计算 Nonce
- ➡️ 结果上报：发现满足难度的 Share 后，通过 Stratum V1 协议实时回传矿池，延迟通常低于 30 ms
AxeOS 的运行逻辑属于典型的事件驱动 + 实时任务调度架构。ESP-IDF 的 FreeRTOS 内核负责在多个并发任务之间切片执行，包括：温度采样任务（每 500 ms 读取一次 NTC 热敏电阻）、风扇 PWM 控制任务、HTTP Server 任务和 Stratum Client 任务。这种设计让矿机在算力全速运行的同时，Dashboard 页面依然能实时刷新数据，不会出现卡顿。
2、AxeOS Features❓
把 AxeOS 的功能列表摆出来，你会发现它的定位不是"能用就行"，而是尽可能把一台小型矿机的可控性做到极致。从算力调节到温控策略，再到 OTA 远程升级，整套功能集合放在一个轻量级嵌入式系统里，说实话有点超出预期。核心功能可以分成三个维度来理解：
❄️ 性能调控层，这是玩家最爱调试的部分。AxeOS 支持通过 Dashboard 直接调整 ASIC芯片 的工作频率，以Bitaxe GT 为例子，频率范围约 525 MHz和核心电压（VCORE）为1.15 V，两个参数配合调节可以在不同散热条件下找到最优的稳定性临界点。官方默认超频频率设置在 625 MHz，不过社区测试初步统计数据显示在保持芯片温度低于 70°C 的前提下，部分用户将频率推到 625 MHz以上 后算力提升至少超过 8%。
- 🔥 频率与电压独立调节：支持 Web UI 实时修改，无需重启固件
- 💪 风扇 PWM 自动控制：根据芯片温度动态调整转速（0–100% 范围），也可手动锁定转速百分比
- ➡️ 过温保护阈值：可设定芯片温度上限（默认 60~70°C），触发后自动降频保护
- ❓ 算力自动恢复：Stratum 连接断线后，固件会按指数退避策略自动重连，间隔从 5 s 递增至最长 60 s
🏃 OTA 在线升级是 AxeOS 另一个让人省心的功能。固件更新不需要拆机或连接 USB 串口，直接在 Dashboard 的 Settings 页面上传 .bin 文件，或者填入 GitHub Release 的固件 URL 一键拉取。整个升级过程约 30–45 秒，升级失败会自动回滚到上一个稳定版本，不存在"砖机"风险。Bitaxe 社区在 2024 年发布了 AxeOS v2.x 系列，新增了 LVGL 图形库支持，为带屏版本（如 Bitaxe Supra）提供了本地 OLED 显示驱动。
注意：AxeOS 的 REST API 接口（GET /api/system/info、PATCH /api/system）均未加密，仅适用于局域网内访问。如果你的家庭网络对外暴露了矿机 IP，建议在路由器层面做访问控制，避免配置被外部篡改。
3、How to Access AxeOS Dashboard🔥
第一次想打开 AxeOS Dashboard 的时候，很多人卡在"找不到 IP"这一步。别担心，这个过程其实比你想象的简单，整个从上电到看到 Dashboard 界面，熟练操作控制在 3 分钟以内完全没问题。
访问 Dashboard 的前提是：Bitaxe GT 和你的电脑/手机必须在同一个局域网下。固件通过 mDNS 协议广播自己的主机名，默认为 bitaxe.local，在大多数 macOS 和 Linux 系统上可以直接用这个域名访问。Windows 用户需要安装 Apple Bonjour 服务或者直接查路由器的 DHCP 客户端列表获取 IP 地址。
- ➡️ 首次配置（AP 模式）：如果矿机还没有连接过 Wi-Fi，上电后它会自动开启一个名为 bitaxe 的热点（无密码）。用手机或电脑连上这个热点，浏览器访问
192.168.88.195进入配网页面，填入家用 Wi-Fi 的 SSID 和密码后保存重启。 - 🔥 正常模式访问：重启后矿机连入你的家庭网络，通过路由器管理后台或 IP 扫描工具（如 Fing，iOS/Android 免费）找到矿机分配到的 IP，例如
192.168.88.195，直接浏览器输入即可打开 Dashboard。 - 💪 mDNS 快捷访问：在支持 mDNS 的系统上，直接在浏览器地址栏输入
http://bitaxe.local即可，免去每次查 IP 的麻烦。 - ❓ 访问异常排查：如果页面无法加载，优先检查 Wi-Fi 频段，Bitaxe GT 的 ESP32-S3 仅支持 2.4 GHz 频段，5 GHz 网络无法连接。
Dashboard 的 HTTP Server 监听 80 端口，采用轻量级 esp_http_server 组件实现，并发连接数最多支持 4 个。这意味着你可以同时用手机和电脑打开 Dashboard，数据实时同步刷新，互不干扰。
⚠️ 重要提示：Dashboard 目前没有登录密码保护，任何连接到同一局域网的设备都可以访问并修改矿机配置。如果你在办公网络或共享 Wi-Fi 环境下使用，建议通过路由器的访问控制（ACL）规则限制对矿机 IP 的访问权限，这是目前社区推荐的安全加固方案。
4、➡️Dashboard Overview
打开 AxeOS Dashboard 的第一眼，你不会看到一堆让人头晕，混乱的折线图或复杂的操作数据，它就是一个干净利落的实时监控面板，所有关键参数平铺在单页上，刷新间隔约 2 秒，看着自己的机器在运行，这种掌控感还挺上头的。Dashboard 主界面由四个核心区域构成，各司其职：
| 区域名称 | 核心显示内容 | 典型数值范围 |
|---|---|---|
| Hashrate Panel | 实时算力 / 5分钟均值 / 历史趋势折线图 | 2400+ GH/s（BM1370 标准工况） |
| Temperature Panel | ASIC 芯片温度 / 环境温度 / 风扇转速 RPM | 芯片 50–70°C，风扇 1500–4500 RPM |
| Pool Status | 矿池连接状态 / 已接受 Share 数 / 拒绝率 | 正常拒绝率低于 2% |
| System Info | 运行时间 / 固件版本 / IP 地址 / MAC 地址 | 持续运行可达 720 小时（30天）无需重启 |
登录后，AxeOS 控制面板是您看到的第一个屏幕。以下是各项指标的简单含义。
- 算力：矿机的当前算力，单位为 TH/s（每秒万亿次哈希运算）。
- 效率（J/TH）：矿机每进行一次万亿次算力运算所消耗的电量，单位为焦耳/万亿次算力。
- 误差百分比：实际算力与预期算力之间的差异，以百分比表示。
- 温度： ASIC 芯片的芯片温度，单位为摄氏度。
- VR温度：电压调节器的内部温度。
- 功率 (W)：总功耗，单位为瓦特。
- 输入电压 (mV)：电源向设备提供的电压。
- 核心电压 (mV)：输送至 ASIC 芯片本身的电压。
- 风扇转速（RPM / %）：当前风扇转速，以每分钟转数和最大占空比的百分比表示。
- 已接受份额：您的矿工提交的、已被矿池确认的有效工作量证明解决方案的数量。
- 被拒绝的作业：提交的作业被作业池拒绝。
- 最佳难度：这是您的矿工在本次挖矿会话中找到的最高难度份额。
- 区块高度：您连接的矿池报告的当前比特币区块高度。
- 矿池难度：矿池为您的矿工设定的目标难度。
- 响应时间：共享提交到共享池的往返延迟，以毫秒为单位。
- 运行时间： Bitaxe 自上次重启以来已运行的时间。
- 算力图表：双轴折线图，显示过去一小时的历史数据（最多 720 个数据点，间隔 5 秒，已在源代码中确认）。
Settings 页面是另一个值得细看的地方。它把所有可调参数集中在一个表单里：矿池地址（支持 Stratum+TCP 和 Stratum+SSL）、工作频率、VCORE 电压、风扇模式（Auto/Manual）以及 OTA 固件升级入口。修改配置后点击 Save & Restart，矿机约 8 秒内完成重启并恢复挖矿状态，期间算力中断时间极短。
算力折线图默认展示最近 10 分钟的数据，每个采样点间隔 10 秒，异常掉算力（比如 Stratum 重连瞬间归零）在图上一眼就能识别出来。Share 统计里还有一个细节：Best Share 字段会显示当前会话中发现的最高难度 Share 数值，这个数字越大说明单次碰到高质量 Nonce 的运气越好，是社区里大家最爱截图晒的数据之一。
从架构角度看，Dashboard 的前端采用纯 HTML + JavaScript 实现，所有静态资源压缩后打包进固件的 SPIFFS 分区（约 200 KB），后端数据通过 REST API 轮询获取，无需 WebSocket 长连接。这种设计让 Dashboard 在低内存环境下依然流畅运行，ESP32-S3 的可用 SRAM 仅约 512 KB，AxeOS 在满负载下的堆内存占用通常维持在 60–80 KB 以内，留有充足余量。
