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

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¶

Ahhoz, hogy a nitropy PIV funkcióit (nitropy nk3 piv) használni tudja, telepítenie kell a pyscard függőséget is:

pipx install pynitrokey[pcsc]

Következő lépések¶

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