Surveiller son mineur à distance : outils et alertes

AxeOS fait bien son travail en local. Mais si votre Bitaxe se déconnecte du WiFi à 3h du matin ou si la puce surchauffe pendant que vous êtes au travail, vous ne le saurez pas avant de rentrer chez vous. Quelques outils permettent de surveiller votre mineur à distance, sans infrastructure compliquée.

L’API locale d’AxeOS

AxeOS expose une API REST en local qui retourne les mêmes données que l’interface graphique. L’endpoint est simple :

GET https://[IP-du-bitaxe]/api/system/info

La réponse JSON contient hashrate, température, consommation, shares acceptés/rejetés, best diff, et statut de connexion au pool. Tout ce dont vous avez besoin pour construire une alerte ou un dashboard est là.

Script Python minimal avec alerte Telegram

Le scénario le plus utile : recevoir un message Telegram si votre mineur se déconnecte ou si la température dépasse un seuil. Voici un script qui fait exactement ça :

import requests, time

BITAXE_IP = "192.168.1.XXX"  # remplacez par l'IP de votre appareil
TG_TOKEN  = "votre-bot-token"
TG_CHAT   = "votre-chat-id"
TEMP_MAX  = 72  # seuil d'alerte en degres C
CHECK_SEC = 300  # intervalle de verification en secondes

def send_tg(msg):
    requests.get(
        f"https://api.telegram.org/bot{TG_TOKEN}/sendMessage",
        params={"chat_id": TG_CHAT, "text": msg}
    )

def check():
    try:
        r = requests.get(f"https://{BITAXE_IP}/api/system/info", timeout=5)
        d = r.json()
        temp = d.get("temp", 0)
        pool = d.get("isUsingFallbackStratum", False)
        hr   = d.get("hashRate", 0)

        if temp > TEMP_MAX:
            send_tg(f"Bitaxe ALERTE temp : {temp}C (seuil {TEMP_MAX}C)")
        if pool:
            send_tg(f"Bitaxe bascule sur pool fallback")
        if hr == 0:
            send_tg(f"Bitaxe hashrate nul - verifier la connexion")

    except Exception as e:
        send_tg(f"Bitaxe injoignable : {e}")

while True:
    check()
    time.sleep(CHECK_SEC)

Pour le token Telegram, créez un bot via @BotFather sur Telegram. Pour le chat ID, envoyez un message au bot puis appelez https://api.telegram.org/bot[TOKEN]/getUpdates pour récupérer votre chat ID.

Ce script tourne en continu sur n’importe quelle machine de votre réseau local — un Raspberry Pi, un vieux PC allumé en permanence, ou un NAS. En dehors de votre réseau local, il faut un accès VPN ou une solution de tunnel.

Intégration Home Assistant

Si vous utilisez déjà Home Assistant sur votre réseau, le Bitaxe s’intègre proprement via la plateforme rest. Ajoutez dans votre configuration.yaml :

sensor:
  - platform: rest
    name: "Bitaxe hashrate"
    resource: https://192.168.1.XXX/api/system/info
    value_template: "{{ value_json.hashRate | round(2) }}"
    unit_of_measurement: "GH/s"
    scan_interval: 60

  - platform: rest
    name: "Bitaxe temperature"
    resource: https://192.168.1.XXX/api/system/info
    value_template: "{{ value_json.temp }}"
    unit_of_measurement: "C"
    scan_interval: 60

Une fois les capteurs déclarés, vous pouvez créer des automations HA standard : notification mobile si la température dépasse 75°C, alerte si le hashrate tombe à zéro, historique graphique sur une semaine.

Surveiller plusieurs appareils

Si vous avez plusieurs Bitaxe ou un NerdQaxe++, chaque appareil a sa propre IP et son propre endpoint. La même logique s’applique à chacun. Dans le script Python, une liste d’IPs et une boucle suffisent. Dans Home Assistant, dupliquez les capteurs avec les IPs correspondantes.

Pour centraliser l’affichage, des projets communautaires comme AxeOS Dashboard (disponible sur GitHub) proposent une interface multi-appareils qui agrège les données de plusieurs Bitaxe sur un seul tableau de bord local.

Ce que vous ne pourrez pas surveiller à distance

Depuis l’extérieur de votre réseau local sans VPN ou tunnel, l’API AxeOS n’est pas accessible par défaut — et c’est bien ainsi. N’exposez pas l’interface AxeOS directement sur internet. La solution propre pour surveiller depuis l’extérieur est un VPN maison (WireGuard sur votre routeur est l’option la plus légère) ou une solution comme Tailscale.

Questions fréquentes