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
146 lines
3.7 KiB
Markdown
146 lines
3.7 KiB
Markdown
# 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** :
|
|
```bash
|
|
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** :
|
|
```ini
|
|
#debug=1
|
|
#loglevel=debug
|
|
```
|
|
|
|
### 3. Configuration RPC signet
|
|
|
|
**Configuration finale** :
|
|
```ini
|
|
[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** :
|
|
```yaml
|
|
depends_on:
|
|
- bitcoin # au lieu de bitcoin.local
|
|
```
|
|
|
|
### 5. Configuration réseau Docker
|
|
|
|
**Réseau autorisé pour RPC** :
|
|
```ini
|
|
rpcallowip=172.20.0.0/16
|
|
```
|
|
|
|
**Réseau Docker 4NK** :
|
|
```yaml
|
|
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** :
|
|
1. **Configuration Tor** : `onion=tor:9050` pourrait causer des problèmes de connectivité
|
|
2. **Configuration signet** : Paramètres signet incompatibles
|
|
3. **Problème de réseau** : Conflit avec la configuration réseau Docker
|
|
4. **Configuration wallets** : Wallets `mining` et `watchonly` problé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
|
|
|
|
1. **Investigation approfondie** : Analyser les logs Bitcoin Core pour identifier la cause racine des redémarrages
|
|
2. **Configuration simplifiée** : Tester avec une configuration Bitcoin minimale
|
|
3. **Tests de connectivité** : Vérifier la connectivité réseau entre les conteneurs
|
|
4. **Documentation** : Maintenir ce document à jour avec les nouvelles découvertes
|
|
|
|
## Commandes utiles
|
|
|
|
```bash
|
|
# 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
|