Anwendungsbereich

Dieser Artikel richtet sich an Benutzer, die die OneKey App auf einem Linux-System installieren und ausführen möchten.

Die Abhängigkeiten und Berechtigungsrichtlinien können je nach Linux-Distribution variieren. Dieser Artikel verwendet Ubuntu / Debian als Hauptbeispiel und bietet gleichzeitig eine universelle Methode zur Konfiguration von udev-Regeln.

Vorbereitung vor der Installation: udev-Regeln konfigurieren

Unter Linux werden udev-Regeln verwendet, damit das System das OneKey Hardware-Wallet korrekt erkennt. Unabhängig davon, ob Sie Snap oder AppImage verwenden, wird empfohlen, diesen Schritt zuerst durchzuführen.

Laden Sie die OneKey udev-Regeln herunter und installieren Sie sie:
```
sudo curl -fsSL https://data.onekey.so/onekey.rules -o /etc/udev/rules.d/99-onekey.rules
```
Wenn curl auf Ihrem System nicht installiert ist, können Sie zuerst Folgendes ausführen:
```
sudo apt update 
sudo apt install curl
```

Laden Sie die udev-Regeln neu:

sudo udevadm control --reload-rules sudo udevadm trigger

Trennen Sie das OneKey Hardware-Wallet und schließen Sie es wieder an. Öffnen Sie erst danach die OneKey App.

Methode 1: Installation über Snap

Snap installieren:
```
sudo apt update 
sudo apt install snapd
```
Wenn Sie eine andere Linux-Distribution verwenden, lesen Sie die offizielle Snap-Dokumentation zur Installation von snapd.
OneKey App installieren:
```
sudo snap install onekey-wallet
```
Sie können die Installation auch über die Snap Store-Seite durchführen: https://snapcraft.io/onekey-wallet
Der OneKey App den Zugriff auf USB-Geräte erlauben:
```
sudo snap connect onekey-wallet:raw-usb
```
Öffnen Sie die OneKey App und wählen Sie die Verbindung mit dem Hardware-Wallet aus.

Wenn die Snap-Version nicht startet

Wenn beim Starten ein ähnlicher Fehler auftritt:

error while loading shared libraries: libgbm.so.1: cannot open shared object file

Dies bedeutet in der Regel, dass im aktuellen Snap-Paket Abhängigkeiten für Grafikbibliotheken fehlen.

Da Snap einen Sandbox-Isolationsmechanismus verwendet, kann die Snap-Anwendung die Grafikbibliotheken des Host-Systems möglicherweise selbst dann nicht lesen, wenn libgbm1 auf dem Host-System installiert ist.

Wenn dieses Problem auftritt, wird empfohlen, vorübergehend auf die AppImage-Version auszuweichen oder zu warten, bis OneKey das Snap-Installationspaket aktualisiert, bevor Sie die Snap-Version verwenden.

Methode 2: AppImage herunterladen und ausführen

Gehen Sie auf die offizielle OneKey-Website, um die Linux-AppImage-Datei herunterzuladen: https://onekey.so/download
Erforderliche Abhängigkeiten für AppImage installieren:
Unter Ubuntu / Debian können Sie Folgendes ausführen:
```
sudo apt update sudo apt install libfuse2
```
Wenn Ihr System meldet, dass libfuse2 nicht gefunden werden kann, installieren Sie bitte das entsprechende Paket gemäß den AppImage- / FUSE-Abhängigkeitsanweisungen Ihrer aktuellen Distribution.
Wechseln Sie in das Verzeichnis, in dem sich die AppImage-Datei befindet, zum Beispiel:
```
cd ~/Downloads
```
Geben Sie der AppImage-Datei Ausführungsrechte:
```
chmod +x OneKey-Wallet-*.AppImage
```
OneKey App ausführen:
```
./OneKey-Wallet-*.AppImage
```

Was tun, wenn die App unter Ubuntu 24.04 oder höher nicht startet?

In Ubuntu 24.04 und höher sind standardmäßig strengere Einschränkungen für unprivilegierte Benutzernamensräume aktiviert. Einige AppImage-Anwendungen starten möglicherweise nicht, weil die Electron- / Chromium-Sandbox-Initialisierung fehlschlägt.

Wenn beim Ausführen des AppImage ein ähnlicher Fehler auftritt:

The SUID sandbox helper binary was found, but is not configured correctly

oder eine Meldung über eine chrome-sandbox-Berechtigungsanomalie angezeigt wird, versuchen Sie, die App mit dem folgenden Befehl zu starten:

./OneKey-Wallet-*.AppImage --no-sandbox

Stellen Sie sicher, dass der Befehl in dem Verzeichnis ausgeführt wird, in dem sich die AppImage-Datei befindet.

Häufig gestellte Fragen (FAQ)

AppImage meldet fehlenden X-Server oder DISPLAY

Wenn beim Ausführen ein Fehler bezüglich eines fehlenden X-Servers oder von $DISPLAY auftritt, bedeutet dies in der Regel, dass dem aktuellen System eine grafische Desktop-Umgebung oder zugehörige Komponenten fehlen.

Für Ubuntu- / Debian-Systeme können Sie die entsprechenden Komponenten für die grafische Umgebung installieren und die Ausführung erneut versuchen.

Hardware-Wallet wird trotz Konfiguration der udev-Regeln nicht erkannt

Bitte überprüfen Sie Folgendes der Reihe nach:

Wurde das Hardware-Wallet getrennt und wieder angeschlossen?
Wurde sudo udevadm control --reload-rules ausgeführt?
Wurde sudo udevadm trigger ausgeführt?
Hat die OneKey App Zugriff auf USB-Geräte erhalten?

Wenn Sie die Snap-Version verwenden, stellen Sie sicher, dass Sie Folgendes ausgeführt haben:

sudo snap connect onekey-wallet:raw-usb

Verwandte Artikel

So installieren Sie die OneKey App unter Linux