A nitropy telepítése pipx-szel#

Ez az útmutató elmagyarázza, hogyan kell a nitropy-t telepíteni a pipx segítségével. pipx létrehoz egy virtuális környezetet a nitropy számára. Ez azt jelenti, hogy a nitropy és függőségei nem ütköznek a rendszeredre telepített más csomagokkal.

Megjegyzés

Windows-felhasználóknak: A Windows-támogatás még kísérleti stádiumban van - kérjük, óvatosan használja. Használhat előre lefordított binárisokat vagy MSI telepítőt is, lásd A nitropy telepítése Windows alatt.

Telepítés Linuxon#

Ubuntu, Debian#

A nitropy-t az összes többi szükséges függőséggel együtt a következő módon telepítheti:

sudo apt install pipx && pipx ensurepath && pipx install pynitrokey

Kijelentkezés vagy a rendszer újraindítása után a nitropy elérhetővé válik.

Arch#

A nitropy-t az összes többi szükséges függőséggel együtt a következő módon telepítheti:

sudo pacman -S python python-pipx && pipx ensurepath && pipx install pynitrokey

Ha már telepítetted a Pythont a rendszeredre, akkor egyszerűen futtasd a következőt:

sudo pacman -S python-pipx && pipx ensurepath && pipx install pynitrokey

Kijelentkezés vagy a rendszer újraindítása után a nitropy elérhetővé válik.

Telepítés más elosztó/üzemeltetési rendszereken#

Előkészítés#

Python 3.9, 3.10 vagy 3.11#

A Python már telepítve van a legtöbb macOS és Linux rendszerre, vagy letölthető a python.org oldalról. További információkért lásd a A Python letöltési útmutató című dokumentumot.

pip#

A pip telepíthető a rendszer csomagkezelőjével vagy a python3 -m ensurepip segítségével. További információkért lásd a pip telepítési útmutató című dokumentumot.

pipx#

A nitropy telepítése előtt telepíteni és konfigurálni kell a pipx:

python3 -m pip install --user pipx
python3 -m pipx ensurepath

További információkért lásd a pipx telepítési útmutatót.

Megjegyzés

Linux felhasználóknak - jelenleg egy átmeneti függőség (oscrypto) okoz problémákat néhány Linux disztribúción. A vonatkozó GitHub issue dokumentálja a jelenleg szükséges megoldást:

pipx inject --pip-args="--upgrade --force" pynitrokey "oscrypto @ git+https://github.com/wbond/oscrypto.git@1547f535001ba568b239b8797465536759c742a3"

Telepítés#

Most már telepítheted a nitropy-t a pynitrokey csomagból:

pipx install pynitrokey

A nitropy mostantól elérhető az alábbi elérési útvonalon:

nitropy --help

Frissítés#

A csomagot a következő paranccsal frissítheti:

pipx upgrade pynitrokey

Hibaelhárítás#

Ha problémákat tapasztalsz, győződj meg róla, hogy a legújabb verziót használod, hasonlítsd össze a nitropy version kimenetét a kiadási listával a GitHubon. Ha a frissítés nem a legújabb verziót telepíti, akkor a következő problémák valamelyikével lehet, hogy gond van.

Rossz Python verzió#

A nitropy a Python 3.9 vagy 3.10-et igényli. Ha az alapértelmezett Python telepítése ennél régebbi vagy újabb, és nem frissíthető, akkor a Python 3.9-et is telepítenie kell, és a pipx hívásakor meg kell adnia a Python futtatható fájljának nevét, például:

$ pipx install --python python3.9 pynitrokey

Nem támogatott kar#

Jelenleg a legújabb nitropy verziók nem telepíthetők Arm platformokra egy függőségi probléma miatt (GitHub issue). Megoldásként használhatsz egy x86-os Python telepítést egy Rosetta terminálon, ahogyan azt a ebben a megbeszélésben) leírtuk.

libusb-1.0.dylib nem található#

A nitropy futtatásakor macOS alatt előfordulhat, hogy hibaüzenet jelenik meg a hiányzó libusb-1.0.dylib fájlról. Ez a libusb manuális telepítésével javítható, például a homebrew:

$ brew install libusb

Felhasználási megjegyzések#

Minden platform#

Ha a nitropy-t Nitrokey Pro vagy Nitrokey Storage eszközzel szeretné használni, akkor telepítenie kell a libnitrokey eszközt is.

Windows#

A Windows-támogatás még kísérleti stádiumban van - kérjük, használja óvatosan.

Előfordulhat, hogy a nitropy-t rendszergazdai jogokkal kell futtatnia ahhoz, hogy csatlakozni tudjon egy eszközhöz.

Linux#

Linux rendszereken a Nitrokey udev szabályaira is szükséged van. Ezeket a libnitrokey szállítja. Alternatívaként manuálisan is telepítheti őket:

wget https://raw.githubusercontent.com/Nitrokey/nitrokey-udev-rules/refs/heads/main/41-nitrokey.rules
sudo mv 41-nitrokey.rules /etc/udev/rules.d/

További információért lásd Az udev szabályok beállítása.

Usage of PIV features#

To be able to use the PIV functionality of nitropy (nitropy nk3 piv), you need to install the pyscard dependency too:

pipx install pynitrokey[pcsc]

Következő lépések#

A nitropiával kapcsolatos további információkat ezekben az útmutatókban talál: