Namestitev nitropy s pipxom

V tem priročniku je razloženo, kako namestiti nitropy z ` pipx <https://pypa.github.io/pipx/>`__. pipx ustvari virtualno okolje za nitropy. To pomeni, da nitropy in njegove odvisnosti niso v nasprotju z drugimi paketi, nameščenimi v vašem sistemu.

Opomba

Za uporabnike sistema Windows: Podpora za sistem Windows je še vedno poskusna - uporabljajte jo previdno. Uporabite lahko tudi predkompilirane binarne datoteke ali namestitveni program MSI, glejte Namestitev nitropija v operacijskem sistemu Windows.

Namestitev v operacijskem sistemu Linux

Ubuntu, Debian

Nitropy lahko namestite skupaj z vsemi drugimi potrebnimi odvisnostmi z uporabo:

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

Po odjavi ali ponovnem zagonu sistema bo zdaj na voljo aplikacija nitropy.

Arch

Nitropy lahko namestite skupaj z vsemi drugimi potrebnimi odvisnostmi z uporabo:

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

Če ste v svoj sistem že namestili Python, lahko preprosto zaženete:

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

Po odjavi ali ponovnem zagonu sistema bo zdaj na voljo aplikacija nitropy.

Namestitev v druge distribucijske/operativne sisteme

Priprava

Python 3.9, 3.10 ali 3.11

Python je že nameščen v večini sistemov macOS in Linux ali pa ga lahko prenesete s python.org. Za več informacij glejte Priročnik za prenos Pythona.

pip

Pip lahko namestite s sistemskim upraviteljem paketov ali s python3 -m ensurepip. Za več informacij glejte priročnik za namestitev pipa.

pipx

Pred namestitvijo nitropyja morate namestiti in konfigurirati pipx:

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

Za več informacij glejte pipx Vodnik za namestitev.

Opomba

Za uporabnike Linuxa - trenutno prehodna odvisnost (oscrypto) povzroča težave na nekaterih distribucijah Linuxa. V ustrezni izdaji GitHuba je dokumentirana trenutno potrebna rešitev:

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

Namestitev

Zdaj lahko nitropy namestite iz paketa pynitrokey:

pipx install pynitrokey

nitropy je zdaj na voljo v vaši poti:

nitropy --help

Nadgradnja

Paket lahko nadgradite z naslednjim ukazom:

pipx upgrade pynitrokey

Odpravljanje težav

Če naletite na težave, se prepričajte, da uporabljate najnovejšo različico, tako da primerjate izpis nitropy version s seznamom izdaj na GitHub. Če nadgradnja ne namesti najnovejše različice, se morda srečujete z eno od naslednjih težav.

Napačna različica programa Python

nitropy zahteva Python 3.9 ali 3.10. Če je vaša privzeta namestitev Pythona starejša ali novejša in je ni mogoče posodobiti, morate dodatno namestiti Python 3.9 in pri klicu pipx navesti ime njegove izvršilne datoteke Python, na primer:

$ pipx install --python python3.9 pynitrokey

libusb-1.0.dylib ni bil najden

Ko zaženete nitropy v sistemu macOS, se lahko prikaže sporočilo o napaki, ki označuje manjkajočo datoteko libusb-1.0.dylib. To lahko popravite z ročno namestitvijo libusb, npr. s homebrew:

$ brew install libusb

Opombe o uporabi

Vse platforme

Če želite nitropy uporabljati z napravo Nitrokey Pro ali Nitrokey Storage, morate namestiti tudi libnitrokey.

Windows

Podpora za Windows je še vedno poskusna - uporabljajte jo previdno.

Morda boste morali zagnati nitropy s skrbniškimi pravicami, da se boste lahko povezali z napravo.

Linux

V sistemih Linux potrebujete tudi pravila Nitrokey udev. Ta so dobavljena z libnitrokey. Namestite jih lahko tudi ročno:

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

Za več informacij glej Nastavitev pravil udev.

Usage of PIV features

Da bi lahko uporabljali funkcionalnost PIV sistema nitropy (nitropy nk3 piv), morate namestiti tudi odvisnost pyscard:

pipx install pynitrokey[pcsc]

Naslednji koraki

Več informacij o uporabi nitropije najdete v teh vodnikih: