Nicolas Cantu
a6b73f57e6
- Creation docs/BITCOIN_TROUBLESHOOTING.md - Documentation des problemes identifies et solutions - Repertoire wallets manquant: cree avec permissions correctes - Mode debug desactive pour stabilite - Configuration RPC signet documentee - Dependances docker-compose corrigees - Etat actuel des services et problemes persistants - Commandes utiles pour diagnostic
3.7 KiB
3.7 KiB
Diagnostic et résolution des problèmes Bitcoin Core
Problèmes identifiés et solutions appliquées
1. Répertoire wallets manquant
Problème : Bitcoin Core ne peut pas démarrer car le répertoire /home/bitcoin/.bitcoin/wallets n'existe pas.
Erreur :
Error: Specified -walletdir "/home/bitcoin/.bitcoin/wallets" does not exist
Solution appliquée :
sudo mkdir -p modules/bitcoin/data/wallets
sudo chown -R 101:101 modules/bitcoin/data/wallets
2. Mode debug problématique
Problème : Le mode debug (debug=1, loglevel=debug) génère trop de logs et peut causer des instabilités.
Solution appliquée :
#debug=1
#loglevel=debug
3. Configuration RPC signet
Configuration finale :
[signet]
listen=1
bind=bitcoin.local:38333
rpcbind=bitcoin.local:18443
rpcport=18443
fallbackfee=0.0001
blockfilterindex=1
datacarriersize=205
acceptnonstdtxn=1
dustrelayfee=0.00000001
minrelaytxfee=0.00000001
prune=0
signetchallenge=0020341c43803863c252df326e73574a27d7e19322992061017b0dc893e2eab90821
walletdir=/home/bitcoin/.bitcoin/wallets
wallet=mining
wallet=watchonly
maxtxfee=1
addnode=tlv2yqamflv22vfdzy2hha2nwmt6zrwrhjjzz4lx7qyq7lyc6wfhabyd.onion
4. Dépendances Docker Compose
Problème : Service blindbit-oracle dépendait de bitcoin.local au lieu de bitcoin.
Solution appliquée :
depends_on:
- bitcoin # au lieu de bitcoin.local
5. Configuration réseau Docker
Réseau autorisé pour RPC :
rpcallowip=172.20.0.0/16
Réseau Docker 4NK :
networks:
4nk_network:
driver: bridge
ipam:
config:
- subnet: 172.20.0.0/16
État actuel des services
Services stables
- ✅ 4nk-tor : Up (health: starting)
- ✅ 4nk-sdk-storage : Up (health: starting)
- ✅ 4nk-sdk-signer : Up (health: starting)
- ✅ 4nk-ihm-client : Up (health: starting)
- ✅ coffre-front : Up
- ✅ miniback-postgres : Up
Services en redémarrage
- ⚠️ bitcoin.local : Restarting (1)
- ⚠️ blindbit-oracle.local : Restarting (1)
- ⚠️ 4nk-sdk-relay1 : Restarting (1)
- ⚠️ 4nk-sdk-relay2 : Restarting (1)
- ⚠️ 4nk-sdk-relay3 : Restarting (1)
- ⚠️ coffre-back-mini : Restarting (1)
Problèmes persistants
Bitcoin Core redémarre en boucle
Symptômes :
- Bitcoin Core se ferme proprement (
Shutdown: done) - Le conteneur redémarre immédiatement
- Cycle de redémarrage continu
Causes possibles :
- Configuration Tor :
onion=tor:9050pourrait causer des problèmes de connectivité - Configuration signet : Paramètres signet incompatibles
- Problème de réseau : Conflit avec la configuration réseau Docker
- Configuration wallets : Wallets
miningetwatchonlyproblématiques
Services dépendants instables
Les services qui dépendent de Bitcoin Core (blindbit-oracle, sdk-relay*) redémarrent également car ils ne peuvent pas se connecter à l'API RPC Bitcoin.
Recommandations
- Investigation approfondie : Analyser les logs Bitcoin Core pour identifier la cause racine des redémarrages
- Configuration simplifiée : Tester avec une configuration Bitcoin minimale
- Tests de connectivité : Vérifier la connectivité réseau entre les conteneurs
- Documentation : Maintenir ce document à jour avec les nouvelles découvertes
Commandes utiles
# Vérifier les logs Bitcoin
docker-compose logs bitcoin
# Vérifier le statut des services
docker-compose ps
# Redémarrer Bitcoin uniquement
docker-compose restart bitcoin
# Vérifier les permissions
ls -la modules/bitcoin/data/
Date de création : 2025-09-10
Dernière mise à jour : 2025-09-10
Statut : En cours de diagnostic