文档

概览

AntminerTools 是面向比特大陆 Antminer 矿机的云端 Dashboard。你在矿场网络中的任意 PC 或 Raspberry Pi 上运行一个小巧的 Connector Agent;它会与我们的云端建立一条安全的出站连接,并把命令转发给你的矿机。随后,你可以在浏览器或手机上获得实时 hashrate、温度、告警、远程重启、收益等——无需在你的网络上开放任何端口。

三个组成部分:

• 你的矿机 —— 保持在你的私有 LAN 中,原封不动,运行原厂比特大陆固件。
• Connector Agent —— 一个运行在矿场 PC/Pi 上的轻量级程序,在本地与你的矿机通信,并向云端建立隧道。
• Dashboard —— 你在此监视和控制一切,可用任意设备访问。

快速上手

1. 在 antminertools.com/register 创建免费账户。
2. 创建矿场 —— 进入 Dashboard → 矿场 → “+ 新建矿场”。一个矿场代表一个物理站点。每个矿场都拥有自己独立的安全令牌。
3. 下载 Agent —— 点击矿场卡片上的 “⬇ Agent”,再点击 “📦 下载 Agent ZIP”。它已为该矿场预配置好。
4. 在与矿机处于同一网络的任意 PC 或 Raspberry Pi 上运行 Agent(详见下文)。几秒钟内,矿场卡片就会变为 ● 已连接。
5. 扫描网络 —— 点击 “🔍 扫描”,并添加它发现的矿机。

Connector Agent

Agent 是一个单一的轻量级程序。它通过本地网络(比特大陆的 Web API)与你的矿机通信,并与 AntminerTools 保持一条加密的出站连接。它从不接受入站连接,因此没有任何需要端口映射的东西,也没有任何暴露在互联网上的内容。

在 Windows 上安装

1. 把下载的文件夹解压到任意位置(例如桌面)。
2. 双击 START_AGENT.bat。
3. 首次运行时,Python 及所需库会自动安装。保持该窗口打开——或让它在后台运行;它会在每次登录时重新启动。

在 Linux / Raspberry Pi 上安装

cd AntminerTools-Agent-YourFarm
python3 antminer_agent.py

需要 Python 3.8+(Raspberry Pi OS 已预装)。依赖会自动安装。

重启后自动启动

Agent 会把自己安装为重启后自动启动——在 Windows 上是启动项,在 Linux 和 Raspberry Pi 上是 systemd 服务(或一个 cron @reboot 任务)。如果矿场 PC 断电或重启,Agent 会自行恢复。

自动更新

当我们发布新版本时,运行中的 Agent 会下载它、校验它、保留一份备份、保留你的令牌,并重启进入新版本——你再也无需碰这台矿场 PC。旧版本会被自动清理。

查看状态

在矿场 PC 上,你可以运行 python antminer_agent.py --status 来查看它是否已连接、版本号和运行时长。

发现你的矿机

当 Agent 显示 已连接 后,点击矿场卡片上的 “🔍 扫描”。AntminerTools 会根据 Agent 自动识别你的子网,并扫描其中的 Antminer 设备。

• 在它逐一扫描每个 IP 时,观察实时计数器——“⛏ 发现 1 台… 2… 3…”。
• 完成后,你会得到一张列出所有已发现矿机的表格:IP、机型、worker 名称(来自 pool)、序列号和 MAC。
• 可对其中任意机器重命名,然后点击 “➕ 添加全部新机”(或逐台添加)。

如果某台矿机在不同的子网上,你也可以手动添加(矿机 → “+ 添加矿机”)——只需填写它的 IP、端口和登录信息。Antminer 默认登录为 root / root。

监控

总览每 10 秒刷新一次,展示你的整个集群:在线/离线矿机、总 hashrate、功耗、最高温度、BTC 价格以及每日收入与利润。

矿机详情

点击任意矿机即可打开其详情页:实时的 5 秒和 30 分钟 hashrate、24 小时图表、每条链的芯片与 PCB 温度、风扇转速(或水冷检测)、功耗、能效(J/TH)、运行时长、固件、序列号,以及带接受/拒绝份额的实时 pool 状态。

矿场视图

每张矿场卡片都会显示总 hashrate 和功耗,以及一个温度健康徽章:绿色 正常、琥珀色 偏热;一旦任意矿机达到 85 °C,就会出现红色闪烁的 🔥 异常 警报。点击矿机数量可打开该矿场内每台矿机的实时弹窗。

远程控制

每台矿机的详情页都有一个控制面板:

• 🔄 重启 —— 随时随地重启卡死的矿机。
• ▶ 正常 / 😴 睡眠 / 🚀 Turbo / 🌿 Eco —— 切换工作模式。在高电价时段用睡眠,用 Eco 降温,利润高时用 Turbo。
• 💡 闪灯 —— 让指示灯闪烁,以便在机架中找到某台机器。
• 🔃 刷新数据 —— 强制立即拉取一次数据。

需要一次重启多台?矿场卡片的 “🔄 重启” 按钮会打开一个面板,列出每台矿机当前的 hashrate、24 小时均值和最后在线时间——可单台重启,也可一键 全部重启。

告警与自动化

进入 告警 → “+ 新建规则”。选择一个触发条件、一个阈值,以及一个动作:

触发条件

• 🌡️ 温度高于阈值(例如 85 °C)
• ⚠️ hashrate 降至零(矿机卡死或掉了 pool)
• 📉 hashrate 低于阈值(算力板衰减)
• 🔌 矿机离线

动作

• 📨 仅告警 —— 记录在你的告警页。
• 😴 自动睡眠 —— 在过热矿机损坏算力板之前,自动让它进入睡眠。
• 🔄 自动重启 —— 无需你动手即可重启卡死的矿机。

规则会应用于你的所有矿机,在每次轮询时检查,并带有可配置的冷却时间,让你绝不会被刷屏。在 Unlimited 套餐 上,告警还会发送到你的邮箱。

远程桌面 · Unlimited 套餐

在 Unlimited 套餐 上,已连接的矿场卡片会显示一个 “🖥️ 远程” 按钮。点击它即可在 Dashboard 中直接打开矿场 PC 的完整桌面——移动鼠标、打字、修改配置、重启 Windows——随时随地。它通过同一条 Agent 隧道工作,因此依然无需端口映射,也无需额外安装任何东西。

• 点击并输入即可控制 PC;需要时使用 Ctrl+Alt+Del 按钮。
• 在手机上,点按即可点击,并用 ⌨ 按键 按钮调出屏幕键盘。
• 每个会话都仅属于你的账户,关闭窗口即结束;每个会话都会被记录。

收益与币种

在 设置 → 挖矿经济中,选择你的显示币种(共 166 种,按实时汇率每小时更新),并填入你的电价和 pool 费率。总览随即会展示真实的每日收入、电费和利润——按日、周、月、年计——并结合网络难度与 BTC 价格实时算出你的保本电价和每枚 BTC 挖矿成本。

收益计算器让你做各种假设推演(不同的电价、更多的矿机),而不会改动你已保存的设置。

套餐与计费

升级

升级立即生效。在任何扣费之前,系统都会向你显示精确的按比例折算金额并请你确认;付款成功的那一刻,你的新上限即刻解锁。

降级

降级会安排在你当前计费周期结束时生效——在此之前,你可保留当前套餐及其全部功能,不产生任何额外费用。套餐页会显示确切日期并标出你的下一个套餐。你可随时用 “保留 [当前套餐]” 取消一次已安排的降级。

支付与历史

支付由 Stripe 安全处理——卡片信息绝不经过我们的服务器。在套餐页,你可以查看并更新已绑定的卡片,并查看你完整的订单历史及可下载的收据。可随时取消;变更套餐时,你的矿机和历史绝不会被删除。

安全

• 纯出站隧道 —— Agent 通过 TLS(与 HTTPS 相同的端口)向外拨号。你的网络中没有任何服务在监听入站连接。
• 每矿场独立令牌 —— 每个矿场都用自己的签名令牌进行认证,你可随时吊销并重新生成。
• 加密凭据 —— 矿机密码以 AES-256-GCM 静态加密存储,仅在转发命令时才在内存中解密。
• 高韧性 —— 带退避的自动重连,加上多个中继端点与故障切换,让你的 Dashboard 在 ISP 与 CDN 抖动中依然保持在线。

支持的矿机

任何运行原厂固件、带标准 Web 界面的比特大陆 Antminer:S23、S21 系列(含 XP 与 Hydro)、S19 系列、T21、L9、L7、Kaspa KS5/KS7、KA3 等等。hydro 水冷和 immersion 浸没式机型有专门处理:水冷温度传感器、无风扇检测。保留了比特大陆兼容 API 的第三方固件通常也能工作。

故障排查

矿场显示“离线”

Agent 未运行或无法访问互联网。在矿场 PC 上,确认 Agent 窗口/服务正在运行(python antminer_agent.py --status),且该 PC 能联网。网络恢复后,Agent 会自动重连。

扫描什么都没发现

检查子网是否与你的矿机匹配(扫描会自动识别,但你可以编辑),以及登录是否正确(默认 root/root)。Agent 所在的 PC 必须与矿机处于同一 LAN。

某台矿机显示离线,但仍在出算力

它的 Web API 可能不可达,或凭据已更改。在 LAN 上直接打开该矿机的 IP 加以确认,并在需要时于 AntminerTools 中更新它的用户名/密码。

无法删除某个矿场

先关闭该矿场 PC 上的 Agent,等待约 90 秒让卡片显示“离线”,然后再删除。这样可避免一个仍在运行的 Agent 以幽灵形式重新出现。

远程桌面无法启动

它需要 Unlimited 套餐 和一个已连接的 Agent。首次启动会安装一个屏幕捕获组件(约 15 秒)。在没有桌面的无头 Raspberry Pi 上,远程桌面不可用。

常见问题

我需要开放端口或使用 VPN 吗?

不需要。Agent 只发起出站连接——它可在任意路由器、CGNAT、4G/5G 或 Starlink 后工作,零网络配置。

它能在我的手机上用吗?

可以——整个 Dashboard 完全自适应。你可以在手机上监控、接收告警、重启矿机、管理计费,甚至进行远程桌面。

数据多久更新一次?

每台在线矿机每 15 秒更新一次;Dashboard 每 10 秒刷新一次显示。

有免费套餐吗?

有——1 个矿场、最多 4 台矿机,含完整的监控、远程控制和 Dashboard 告警。付费套餐会增加容量与功能。

还是搞不定?创建账户,然后从你的 Dashboard 联系我们,或阅读博客获取指南与技巧。