Verbinde die BitBoxApp mit deiner eigenen Bitcoin-Full-Node, um Bitcoin-Kontostände und den Transaktionsverlauf über deine eigene Infrastruktur statt über öffentliche Server abzurufen.
Du kannst eine Onion-Adresse für die Verbindung über Tor verwenden oder die BitBoxApp direkt verbinden, wenn sie sich im selben lokalen Netzwerk wie deine Node befindet. Verbindungsmethode und Port hängen von deiner Node-Software ab.
Bevor du beginnst
Stelle sicher, dass deine Node-Konfiguration Folgendes umfasst:
- Eine vollständig synchronisierte Bitcoin-Full-Node, zum Beispiel Bitcoin Core.
- Einen vollständig synchronisierten Electrum-kompatiblen Server, zum Beispiel Electrs, Electrum Personal Server (EPS) oder Bitcoin Wallet Tracker (BWT).
- Den von deiner Node-Software bereitgestellten Verbindungsendpunkt. Dieser besteht normalerweise aus einem Hostnamen oder einer IP-Adresse und einem Port.
- Die neueste Version der BitBoxApp.
Die BitBoxApp verbindet sich nicht direkt mit Bitcoin Core. Stattdessen verbindet sie sich mit einem Electrum-kompatiblen Server. Dieser bereitet die Blockchain-Daten so auf, dass die BitBoxApp Bitcoin-Kontostände und den Transaktionsverlauf schnell abrufen kann.
Falls der Electrum-Server seine Daten noch aufbereitet, warte, bis er als vollständig synchronisiert angezeigt wird.
Verbindungsmethode auswählen
Verwende immer die Verbindungsdaten, die deine Node-Software bereitstellt. Ersetze den angegebenen Port nicht durch 50001 oder 50002, sofern dich die Anleitung deiner Node nicht ausdrücklich dazu auffordert.
| Wann solltest du diese Verbindung verwenden? | Geeignete Verbindung |
|---|---|
| Die BitBoxApp und deine Node befinden sich im selben lokalen Netzwerk und deine Node stellt einen lokalen Endpunkt bereit | Stelle über die lokale IP-Adresse oder den Hostnamen und den angegebenen Port eine direkte Verbindung her. |
| Deine Node stellt eine Onion-Adresse bereit | Stelle über Tor und den vollständigen Onion-Endpunkt eine Verbindung her. Diese Methode funktioniert sowohl zu Hause als auch unterwegs. |
| Du möchtest dich von unterwegs verbinden und deine Node unterstützt den Zugriff über ein VPN | Verbinde dich über das VPN mit deinem Heimnetzwerk und verwende anschließend den von deiner Node-Software bereitgestellten VPN-Endpunkt. |
Empfohlene Verbindungsmethode
- Lokales Netzwerk: Die beste Wahl, wenn sich die BitBoxApp und deine Node im selben lokalen Netzwerk befinden.
- VPN: Empfohlen für den sicheren Zugriff auf dein Heimnetzwerk von unterwegs. Viele Nutzer verwenden VPN-Lösungen wie Tailscale, sofern ihre Node-Software diese unterstützt.
- Tor: Eine gute Alternative, wenn deine Node einen Onion-Endpunkt bereitstellt oder du eine Verbindung über Tor bevorzugst.
Manche Node-Pakete stellen mehrere Verbindungsmethoden bereit. Zu Hause kannst du dich normalerweise über das lokale Netzwerk verbinden. Unterwegs kannst du Tor oder ein unterstütztes VPN verwenden. Leite den Port deines Electrum-Servers nicht direkt ins öffentliche Internet weiter.
Um einen Endpunkt hinzuzufügen, öffne Einstellungen → Erweiterte Einstellungen → Eigenen Full Node verbinden.
Über Tor verbinden
Verwende diese Schritte, wenn deine Node eine Adresse mit der Endung .onion bereitstellt.
Tor-Proxy einrichten
Tor muss auf demselben Computer wie die BitBoxApp installiert sein und ausgeführt werden.
- Öffne den Tor Browser und verbinde ihn mit Tor oder starte deinen Tor-Hintergrunddienst.
- Öffne die BitBoxApp.
- Wähle Einstellungen.
- Öffne Erweiterte Einstellungen.
- Wähle Tor Proxy aktivieren.
- Aktiviere den Proxy.
- Gib die zu deiner Tor-Konfiguration passende Proxy-Adresse ein:
- Der Tor Browser verwendet normalerweise
127.0.0.1:9150. - Ein Tor-Hintergrunddienst verwendet normalerweise
127.0.0.1:9050.
- Der Tor Browser verwendet normalerweise
- Wähle Proxy Adresse eingeben.
- Schließe die BitBoxApp vollständig und öffne sie erneut.
Weitere Informationen zur Proxy-Einstellung und zu Fehlern wie connection refused findest du in der Anleitung zum Konfigurieren der BitBoxApp mit Tor.
Onion-Endpunkt hinzufügen
- Öffne in deiner Node-Software die Seite mit den Verbindungsdaten für Wallets oder Electrum-Clients.
- Kopiere den vollständigen Onion-Endpunkt einschließlich Port. Das Format sieht ungefähr so aus:
deine-node-onion-adresse.onion:port. - Wähle in der BitBoxApp Einstellungen.
- Öffne Erweiterte Einstellungen.
- Wähle Eigenen Full Node verbinden.
- Füge den Onion-Endpunkt in das Endpunktfeld ein.
- Falls deine Node den Endpunkt als TLS-Endpunkt kennzeichnet, befolge ihre Anweisungen zum Zertifikat. Ändere den angegebenen Port nicht.
- Wähle Prüfen.
- Warte, bis die BitBoxApp bestätigt, dass die Verbindung erfolgreich hergestellt wurde.
- Wähle Hinzufügen.
Tor muss ausgeführt werden, solange sich die BitBoxApp mit dem Onion-Endpunkt verbindet. Wenn du den Tor Browser als Proxy verwendest, muss er geöffnet und mit Tor verbunden sein.
Im lokalen Netzwerk verbinden
Verwende diese Schritte, wenn sich die BitBoxApp und deine Node im selben lokalen Netzwerk befinden und deine Node einen lokalen Endpunkt bereitstellt.
Bei einer TLS-Verbindung muss die BitBoxApp dem Zertifikat deiner Node vertrauen, bevor eine sichere Verbindung hergestellt werden kann.
- Öffne in deiner Node-Software die Seite mit den Verbindungsdaten für Wallets oder Electrum-Clients.
- Kopiere den vollständigen lokalen Endpunkt. Das Format sieht ungefähr so aus:
lokale-IP-oder-hostname:port. - Öffne die BitBoxApp.
- Wähle Einstellungen.
- Öffne Erweiterte Einstellungen.
- Stelle sicher, dass Tor Proxy aktivieren deaktiviert ist, wenn sich die BitBoxApp direkt über das lokale Netzwerk verbinden soll.
- Wähle Eigenen Full Node verbinden.
- Füge den lokalen Endpunkt in das Endpunktfeld ein.
- Falls deine Node einen TLS-Endpunkt bereitstellt, wähle Remote-Zertifikat herunterladen.
- Wähle Prüfen.
- Warte, bis die BitBoxApp bestätigt, dass die Verbindung erfolgreich hergestellt wurde.
- Wähle Hinzufügen.
Der lokale Endpunkt funktioniert normalerweise nur, solange die BitBoxApp mit demselben Heimnetzwerk oder lokalen Netzwerk wie deine Node verbunden ist.
Von unterwegs über ein VPN verbinden
Wenn du deine Bitcoin-Full-Node von außerhalb deines Heimnetzwerks verwenden möchtest, kannst du dich über ein VPN mit deinem lokalen Netzwerk verbinden.
Manche Node-Pakete, zum Beispiel Umbrel, unterstützen VPN-Lösungen wie Tailscale. Sobald dein Computer mit dem VPN verbunden ist, kann sich die BitBoxApp normalerweise über die VPN-IP-Adresse mit deiner Node verbinden – ähnlich wie im selben lokalen Netzwerk.
Auch bei einer VPN-Verbindung benötigt deine Node weiterhin einen Electrum-kompatiblen Server.
Folge für die Einrichtung der Dokumentation deiner Node-Software oder VPN-Lösung.
Ausschließlich die eigene Full Node verwenden
Wenn du die Standard-BitBox-Server entfernst, ruft die BitBoxApp Bitcoin-Kontostände und den Transaktionsverlauf ausschließlich über deine eigene Bitcoin-Infrastruktur ab. Falls deine Node nicht verfügbar ist, kann die BitBoxApp deine Bitcoin-Konten erst wieder aktualisieren, nachdem die Verbindung wiederhergestellt wurde.
Prüfe zunächst, ob die BitBoxApp erfolgreich eine Verbindung herstellt und deine Bitcoin-Konten über den neuen Endpunkt lädt.
Wenn die BitBoxApp ausschließlich deine eigene Node verwenden soll, entferne die Standard-BitBox-Server aus den Full-Node-Einstellungen, nachdem die neue Verbindung funktioniert.
Verbindungsprobleme beheben
Die Verbindungsprüfung schlägt fehl oder wird wegen einer Zeitüberschreitung beendet
Prüfe Folgendes:
- Die Bitcoin-Full-Node ist vollständig synchronisiert.
- Der Electrum-Server ist installiert, wird ausgeführt und hat seine Daten vollständig aufbereitet.
- Du hast den vollständigen Endpunkt und Port aus deiner Node-Software kopiert.
- Die Node ist über dein aktuelles Netzwerk erreichbar, zum Beispiel über dein lokales Netzwerk, Tor oder ein VPN.
- Du hast den angegebenen Port nicht aufgrund einer Anleitung für eine andere Node ersetzt.
Die BitBoxApp zeigt bei der Verwendung von Tor connection refused an
Die BitBoxApp kann den lokalen Tor-Proxy nicht erreichen.
- Stelle sicher, dass der Tor Browser oder der Tor-Hintergrunddienst ausgeführt wird.
- Prüfe, ob die vollständige Proxy-Adresse zu deiner Tor-Konfiguration passt: normalerweise
127.0.0.1:9150für den Tor Browser oder127.0.0.1:9050für einen Hintergrunddienst. - Schließe die BitBoxApp vollständig und öffne sie erneut.
Das Remote-Zertifikat kann nicht heruntergeladen werden
Prüfe, ob deine Node-Software den Endpunkt als TLS-Endpunkt kennzeichnet. Ein Endpunkt ohne TLS stellt kein TLS-Zertifikat bereit.
Falls deine Node separate TCP- und TLS-Endpunkte bereitstellt, kopiere den TLS-Endpunkt genau wie angezeigt, anstatt den Port selbst zu ändern.
Bitcoin-Konten werden nicht mehr aktualisiert
Falls du die Standard-BitBox-Server entfernt hast, kann die BitBoxApp deine Bitcoin-Konten nicht aktualisieren, solange die Verbindung zu deiner eigenen Node nicht verfügbar ist.
Prüfe je nach Verbindung deine Node, den Electrum-Server, das lokale Netzwerk, das VPN und den Tor-Proxy. Um den Zugriff vorübergehend wiederherzustellen, kannst du die Standard-BitBox-Server erneut hinzufügen oder die Full-Node-Verbindungseinstellungen auf die Standardwerte zurücksetzen.
Häufig gestellte Fragen
Wirkt sich die Verbindung mit meiner eigenen Node auf meine bitcoin aus?
Nein. Wenn du die BitBoxApp mit deiner eigenen Bitcoin-Full-Node verbindest, ändert sich lediglich, von welcher Bitcoin-Infrastruktur die BitBoxApp Bitcoin-Kontostände und den Transaktionsverlauf abruft. Deine Bitcoin bleiben durch deine BitBox geschützt und werden weder verschoben noch verändert.
Was passiert, wenn meine Node offline ist?
Wenn die BitBoxApp ausschließlich deine eigene Node verwendet, können die Bitcoin-Konten erst wieder aktualisiert werden, sobald die Node-Verbindung verfügbar ist. Deine Bitcoin und die auf deiner BitBox gespeicherte Wallet sind davon nicht betroffen.
Kann ich Umbrel, Start9 oder ein anderes Node-Paket verwenden?
Ja. Die BitBoxApp funktioniert mit jeder Bitcoin-Full-Node-Konfiguration, die einen Electrum-kompatiblen Server und den erforderlichen Verbindungsendpunkt bereitstellt. Verwende immer die Verbindungsdaten deiner Node-Software.
Benötige ich Tor, wenn sich die BitBoxApp und meine Node im selben Netzwerk befinden?
Nein. Du kannst einen lokalen Endpunkt verwenden, wenn deine Node-Software einen solchen bereitstellt. Du kannst im selben Netzwerk auch den Onion-Endpunkt deiner Node verwenden, wenn dein Node-Paket diese Verbindungsmethode bereitstellt oder empfiehlt. Eine VPN-Verbindung mit deinem Heimnetzwerk ist eine weitere Möglichkeit, sofern deine Node-Software sie unterstützt.
Sollte ich Port 50001 oder 50002 verwenden?
Verwende genau den Port, den deine Node-Software anzeigt. Portnummern stehen häufig für unterschiedliche Verbindungstypen, sind aber nicht bei allen Node-Paketen und Konfigurationen gleich.
Ersetzt Tor die eigene Full Node?
Nein. Tor verändert lediglich den Kommunikationsweg zwischen der BitBoxApp und dem Server. Die Verbindung mit deiner eigenen Bitcoin-Full-Node bestimmt hingegen, über welche Bitcoin-Infrastruktur Bitcoin-Kontostände und der Transaktionsverlauf abgerufen werden.