Le WiFi est l’étape où bloquent la plupart des nouveaux propriétaires de Bitaxe ou de NerdQaxe++. Rarement parce que la machine est en panne : ces mineurs utilisent un module ESP32-S3, qui a ses contraintes (2,4 GHz uniquement, WPA2 attendu) et qui supporte mal certaines options des box récentes. Cet article est un guide de dépannage : partez du symptôme, trouvez la cause, appliquez le correctif. Pour une installation pas à pas d’un NerdQaxe++, voyez plutôt configurer le WiFi du NerdQaxe++.
Comprendre ce que fait le mineur quand le WiFi échoue
Les deux familles de firmware ne réagissent pas pareil, et le savoir évite de tourner en rond.
Bitaxe (ESP-Miner / AxeOS). Sans réseau enregistré ou en cas d’échec, le Bitaxe ouvre un point d’accès sans mot de passe nommé Bitaxe_XXXX et retente le réseau configuré toutes les cinq secondes environ. L’écran affiche le nom du point d’accès, un QR code et la raison de l’échec. Un appui de deux secondes sur le bouton BOOT allume ou éteint ce point d’accès à la main.
NerdQaxe++ (firmware ESP-Miner-NerdQAxePlus). Le point d’accès s’appelle Nerdaxe_XXXX. Il est actif au démarrage tant que la machine n’a pas obtenu d’adresse IP, puis il se coupe jusqu’au redémarrage suivant. Si vous changez de box, redémarrez le mineur : faute de pouvoir se connecter à l’ancien réseau, il rouvrira son point d’accès.
Dans les deux cas, connectez-vous au point d’accès depuis un téléphone : la page de configuration s’ouvre d’elle-même ou à l’adresse https://192.168.4.1.
Les messages d’erreur et leur cause probable
Le firmware Bitaxe affiche à l’écran et dans les logs la raison renvoyée par la puce WiFi. Les plus fréquentes :
| Message | Cause la plus probable | Quoi faire |
|---|---|---|
| No access point found | Réseau en 5 GHz seulement, SSID mal orthographié, mineur trop loin | Vérifier que le 2,4 GHz est actif, recopier le nom exact, rapprocher le mineur |
| Authentication failed / Handshake timeout | Mot de passe erroné (la casse compte), signal faible | Ressaisir le mot de passe, tester près de la box |
| No access point found with compatible security | Réseau en WPA3 seul | Passer le réseau en WPA2 ou en mode mixte WPA2/WPA3 |
| Acquiring IP… qui ne se termine pas | Le mineur est associé mais la box ne lui donne pas d’adresse | Voir la section DHCP plus bas |
Le mineur ne trouve pas le réseau
Le 5 GHz. L’ESP32-S3 ne fonctionne qu’en 2,4 GHz. Beaucoup de box diffusent un nom unique pour les deux bandes et orientent les appareils automatiquement (band steering). Ça marche souvent, mais quand ça coince, la solution la plus fiable est de séparer les bandes dans l’interface de la box, ou de créer un réseau 2,4 GHz dédié avec un nom distinct, et d’y connecter le mineur.
Le réseau masqué. Un SSID caché n’apparaît pas dans la liste de recherche : il faut taper son nom exact à la main. Si l’association échoue quand même, rendez le réseau visible le temps du diagnostic.
La distance. L’antenne d’un Bitaxe est intégrée à la carte, et un boîtier métallique, un meuble fermé ou deux murs porteurs suffisent à dégrader le signal. Faites la première connexion à quelques mètres de la box, puis déplacez la machine.
Le réseau est visible mais la connexion échoue
Le mot de passe. C’est la première chose à revérifier, majuscules comprises. Pour éliminer un doute sur un caractère spécial ou un copier-coller qui ajoute un espace, testez avec un réseau temporaire au mot de passe simple, par exemple le partage de connexion d’un téléphone en 2,4 GHz. Si le mineur s’y connecte, le problème vient bien du réseau principal.
Le WPA3. Les deux firmwares se connectent en WPA2 au minimum. Un réseau réglé en WPA3 seul ne fonctionnera pas. Le mode de transition WPA2/WPA3, proposé par les box et routeurs récents (notamment en WiFi 7), posait aussi problème sur les Bitaxe : ESP-Miner v2.15.1 (29 août 2026) a corrigé ce cas. Si votre Bitaxe voit le réseau sans s’y attacher, mettez d’abord le firmware à jour, puis passez le réseau en WPA2 si besoin.
Les options « intelligentes ». Filtrage par adresse MAC, itinérance agressive d’un système mesh, réseau invité isolé : autant de réglages pensés pour les téléphones qui gênent les petits objets connectés. Désactivez-les le temps du test, puis réactivez-les une par une.
Connecté au WiFi mais sans adresse IP
Si le statut reste bloqué sur l’obtention d’une adresse, la connexion radio fonctionne mais le serveur DHCP de la box ne répond pas au mineur. Vérifiez que la plage DHCP n’est pas pleine (fréquent quand beaucoup d’objets connectés s’accumulent), que le mineur n’est pas bloqué par un filtrage, et redémarrez la box si besoin. Une fois connecté, réservez l’adresse IP du mineur dans la box (réservation DHCP par adresse MAC) : vous le retrouverez toujours au même endroit.
Connecté, mais pas de hashrate
Là, le WiFi n’est plus en cause : c’est la liaison avec le pool qui coince.
- Le routeur bloque le minage. La documentation d’ESP-Miner cite les routeurs ASUS et certains TP-Link, dont les fonctions AiProtection et IoT peuvent bloquer la connexion au pool. Désactivez-les si vous n’avez aucun hashrate.
- L’adresse du pool est mal saisie. Dans AxeOS, le champ Stratum Host ne prend que le nom de domaine (par exemple
stratum.ckpool.org), sansstratum+tcp://ni port. Le port (3333) va dans son propre champ. Le formulaire refuse d’ailleurs l’enregistrement sinon. - Le port sortant est filtré. Sur un réseau avec pare-feu, VLAN ou contrôle parental, vérifiez que le mineur peut joindre le port du pool (3333 sur la plupart des pools solo).
- L’adresse Bitcoin est invalide. Le champ User doit contenir votre adresse, éventuellement suivie d’un point et d’un nom de machine. Une adresse tronquée provoque des refus du pool.
Au démarrage, laissez quelques minutes à la machine avant de conclure : le temps de se connecter, d’initialiser la puce et de recevoir du travail du pool. Si le statut du pool reste déconnecté, la page Logs d’AxeOS indique en général pourquoi. La configuration complète d’un pool est détaillée dans configurer son Bitaxe sur CK Pool.
Le mineur décroche régulièrement
Des déconnexions toutes les quelques heures pointent vers le signal ou l’environnement radio. Rapprochez la machine de la box ou d’un point d’accès, fixez le canal 2,4 GHz sur 1, 6 ou 11 plutôt qu’en automatique si votre voisinage est chargé, et évitez qu’un système mesh fasse sauter le mineur d’une borne à l’autre. Pensez aussi à l’alimentation : un bloc sous-dimensionné fait redémarrer la carte, ce qui ressemble de loin à une coupure WiFi. Sur Bitaxe, AxeOS signale une tension d’entrée trop faible depuis la v2.15.
Pour être prévenu quand un mineur décroche au lieu de le découvrir trois jours plus tard, voyez surveiller son mineur à distance.
L’interface ne répond plus dans le navigateur
Le plus souvent, l’adresse IP a changé après un redémarrage de la box. Lisez la nouvelle sur l’écran du mineur, dans la liste DHCP de la box, ou scannez le réseau (nmap -sn 192.168.1.0/24, plage à adapter). Sur Bitaxe à jour (v2.15 et plus), essayez aussi https://bitaxe.local, ou le nom d’hôte que vous avez choisi suivi de .local. Si la page s’ouvre mais reste blanche après une mise à jour, la page de secours /recovery permet de revenir à l’interface intégrée. Le détail des menus est dans le guide AxeOS : prise en main et paramétrage.
Questions fréquentes
Mon Bitaxe se déconnecte régulièrement du WiFi, que faire ?
Vérifiez qu’il est bien en 2,4 GHz, rapprochez-le de la box ou d’un point d’accès et fixez le canal WiFi (1, 6 ou 11). Contrôlez aussi l’alimentation : des redémarrages dus à un bloc trop faible ressemblent à des coupures réseau.
Le Bitaxe accepte-t-il un réseau WiFi caché ?
Un réseau caché n’apparaît pas dans la recherche, il faut saisir son nom exact. Si la connexion échoue malgré tout, rendez le réseau visible le temps de la configuration pour isoler le problème.
Peut-on brancher un Bitaxe ou un NerdQaxe++ en Ethernet ?
Non, ni le Bitaxe Gamma ni le NerdQaxe++ n’ont de port Ethernet : ils fonctionnent uniquement en WiFi 2,4 GHz. Le firmware NerdQAxe gère l’Ethernet depuis sa version 1.1.0, mais seulement pour une nouvelle carte à puces BM1373 qui l’intègre.
Mon mineur est connecté au WiFi mais le pool reste déconnecté, que vérifier ?
Le nom d’hôte du pool (sans stratum+tcp:// ni port), le port dans son champ dédié, votre adresse Bitcoin dans le champ User, puis les fonctions de sécurité du routeur (AiProtection sur ASUS, options IoT sur certains TP-Link) et un éventuel pare-feu sortant.
Faut-il reflasher le firmware quand le WiFi ne marche pas ?
Rarement en premier recours. Éliminez d’abord la bande, le chiffrement, le mot de passe et le signal. Une mise à jour se justifie quand elle corrige votre cas, comme la compatibilité WPA2/WPA3 réglée dans ESP-Miner v2.15.1.
