本指南以 Ubuntu 22.04.3LTS 系統為例演示安裝過程。
方法一：Snap 安裝
安裝 snap：
sudo apt install snapd在其他 Linux 系統上安裝 snap，請參閱連結：參考
以兩種方式安裝 OneKey 應用：
打開連結：https://snapcraft.io/onekey-wallet，並直接從 snap 商店安裝。
透過命令行安裝：
sudo snap install onekey-wallet
下載並安裝 bridge（下載連結）
下載後，切換到 bridge 所在目錄並執行以下命令進行安裝：
sudo dpkg -i onekey-bridge-2.2.0-amd64.deb
在瀏覽器中訪問地址 http://127.0.0.1:21320/status/，確保頁面打開並顯示“已連接設備：1”。
完成安裝。打開 OneKey 應用並選擇“連接硬件錢包”。
方法二：直接下載並運行 AppImage
如果在運行時遇到“缺少 X Server 或 $DISPLAY”的錯誤，請安裝相關圖形環境組件。對於 Ubuntu 或 Debian 系統，可以安裝 xorg。
Linux 無法檢測到硬件設備時的解決方案
在 Linux Mint 系統上使用 OneKey 硬件錢包時，需要安裝 UDEV 規則，以便應用能正確連接設備。
1.前往https://data.onekey.so/onekey.rules，複製UDEV規則
2.在 /etc/udev/rules.d/99-onekey.rules 新建文件，並且將上述規則複製並保存。
3.完成以上後，終端中輸入：
sudo udevadm control --reload-rules
不要手動更改 /dev 下設備文件的權限，例如使用 chmod 或 chown。
此類更改是臨時計的，在重啟或重新插入設備後不會保留，放寬權限可能帶來安全風險。