Comment configurer un nœud Kaspa à l'aide de Docker ? (Synchronisation rapide)

Conditions préalables au déploiement du nœud Kaspa

1. Un système hôte basé sur Linux avec Docker Engine 20.10 ou version ultérieure installé et exécuté.

2. Au moins 32 Go de RAM et 2 To d'espace de stockage SSD NVMe rapide alloués à la base de données blockchain.

3. Une connexion Internet active avec une bande passante de téléchargement/téléchargement stable supérieure à 100 Mbps.

4. Autorisations utilisateur pour exécuter des commandes Docker sans sudo ou accès sudo approprié configuré.

5. Synchronisation de l'heure activée via systemd-timesyncd ou ntpd pour garantir une validation précise de l'horodatage sur les couches de consensus.

Sélection et vérification d'images Docker

1. Extrayez l'image complète du nœud Kaspa officielle du référentiel Docker Hub vérifié : kaspanet/kaspad .

2. Vérifiez l'intégrité de l'image en vérifiant son résumé SHA256 par rapport au hachage publié sur la page des versions de Kaspa GitHub.

3. Marquez l'image extraite localement avec une étiquette versionnée telle que kaspanet/kaspad:v0.18.0 pour éviter les mises à niveau accidentelles pendant les fenêtres de maintenance.

4. Inspectez les métadonnées du conteneur à l'aide de l'image docker inspect kaspanet/kaspad:v0.18.0 pour confirmer les ports exposés et le comportement du point d'entrée par défaut.

5. Assurez-vous qu'aucun conteneur en conflit n'est lié au port TCP 16111 (P2P) ou 16110 (RPC) avant de continuer.

Stratégie de configuration de synchronisation rapide

1. Montez un volume dédié sur /root/.kaspa/data pour conserver l'état de la chaîne lors des redémarrages du conteneur.

2. Transmettez l'indicateur --fastsync en tant que variable d'environnement ou argument CLI pour déclencher un téléchargement accéléré du bloc initial.

3. Configurez KASPA_LOG_LEVEL=info pour surveiller la progression de la synchronisation sans surcharger la sortie du journal.

4. Utilisez --pruning=auto pour activer l'élagage dynamique qui conserve uniquement les données UTXO essentielles tout en supprimant les en-têtes de bloc obsolètes.

5. Définissez --maxpeers=128 pour maximiser les connexions homologues simultanées pendant la phase d'amorçage sans surcharger les ressources locales.

Exécution et surveillance du runtime

1. Lancez le conteneur en mode détaché avec des limites de ressources : docker run -d --name kaspa-node --restart=unless-stopped --memory=28g --cpus=8 -v kaspa-data:/root/.kaspa/data -p 16111:16111 -p 16110:16110 -e KASPA_LOG_LEVEL=info kaspanet/kaspad:v0.18.0 --fastsync --pruning=auto --maxpeers=128 .

2. Diffusez les journaux en temps réel à l'aide de docker logs -f kaspa-node pour observer la progression de la hauteur de synchronisation et l'état de la négociation entre pairs.

3. Interrogez l'état du nœud via RPC à l'aide de curl : curl -X POST -H 'Content-Type: application/json' --data '{'jsonrpc':'1.0','method':'getinfo','params':[],'id':1}' http://localhost:16110 .

4. Surveillez les E/S du disque et la pression de la mémoire à l'aide de docker stats kaspa-node pour détecter les anomalies pendant les phases de croissance rapide de la chaîne.

5. Validez l'achèvement de la synchronisation finale en confirmant « syncstatus » : « synchronisé » et en faisant correspondre la hauteur de bloc actuelle avec les explorateurs publics.

Foire aux questions

Q : Puis-je exécuter plusieurs nœuds Kaspa sur le même hôte à l'aide de Docker ? R : Oui, à condition que chaque instance utilise des mappages de ports hôtes uniques et des volumes Docker isolés. Évitez de partager le même répertoire de données entre les conteneurs.

Q : Est-il sécuritaire d’arrêter et de redémarrer le conteneur pendant une synchronisation rapide ? R : Oui, le nœud reprend à partir de la dernière hauteur de bloc validée. Aucun nouveau téléchargement n'est requis, sauf si une corruption se produit dans le volume de données.

Q : La synchronisation rapide valide-t-elle toutes les signatures et preuves historiques ? R : Non, la synchronisation rapide télécharge les en-têtes de blocs compacts et valide uniquement les preuves récentes critiques par consensus. La validation complète se produit progressivement une fois la synchronisation terminée.

Q : Comment puis-je sauvegarder le portefeuille et la configuration de mon nœud Kaspa ? R : Copiez le contenu du chemin du volume monté /root/.kaspa/data , en particulier wallet.dat et kaspawallet.conf , vers un emplacement hors site crypté.