Nitropy diegimas naudojant pipx

Šiame vadove paaiškinama, kaip įdiegti nitropy naudojant pipx. pipx sukuria virtualią nitropy aplinką. Tai reiškia, kad nitropy ir jo priklausomybės nekonfliktuoja su kitais jūsų sistemoje įdiegtais paketais.

Pastaba

„Windows“ naudotojams: „Windows“ palaikymas vis dar eksperimentinis - naudokite atsargiai. Taip pat galite naudoti iš anksto parengtas dvejetaines programas arba MSI diegimo programą, žr. Nitropy diegimas „Windows“ sistemoje.

Diegimas „Linux“ sistemoje

Ubuntu, Debian

Nitropy kartu su visomis kitomis reikalingomis priklausomybėmis galite įdiegti naudodami:

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

Atsijungus arba iš naujo paleidus sistemą, dabar bus galima naudotis „nitropy“.

Arch

Nitropy kartu su visomis kitomis reikalingomis priklausomybėmis galite įdiegti naudodami:

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

Jei savo sistemoje jau esate įdiegę „Python“, galite tiesiog paleisti:

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

Atsijungus arba iš naujo paleidus sistemą, dabar bus galima naudotis „nitropy“.

Įrengimas kitose paskirstymo ir (arba) eksploatavimo sistemose

Paruošimas

Python 3.9, 3.10 arba 3.11

Daugumoje „MacOS“ ir „Linux“ sistemų „Python“ jau yra įdiegtas arba jį galima atsisiųsti iš python.org. Daugiau informacijos rasite „Python“ atsisiuntimo vadove.

pip

Pip galite įdiegti naudodami sistemos paketų tvarkyklę arba python3 -m ensurepip. Daugiau informacijos rasite pip diegimo vadove.

pipx

Prieš diegdami nitropy, turite įdiegti ir sukonfigūruoti pipx:

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

Daugiau informacijos rasite pipx diegimo vadove.

Pastaba

„Linux“ naudotojams - šiuo metu dėl laikinos priklausomybės (oscrypto) kai kuriose „Linux“ distribucijose kyla problemų. Atitinkamoje „GitHub“ numeryje dokumentuojamas šiuo metu reikalingas problemos sprendimo būdas:

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

Įrengimas

Dabar galite įdiegti nitropy iš pynitrokey paketo:

pipx install pynitrokey

nitropy dabar yra jūsų kelyje:

nitropy --help

Atnaujinti

Paketą galite atnaujinti naudodami šią komandą:

pipx upgrade pynitrokey

Trikčių šalinimas

Jei kyla problemų, įsitikinkite, kad naudojate naujausią versiją, palygindami nitropy version išvestį su išleidimų sąrašu „GitHub“. Jei atnaujinus neįdiegiama naujausia versija, gali būti, kad susidūrėte su viena iš toliau nurodytų problemų.

Netinkama „Python“ versija

nitropy reikalauja Python 3.9 arba 3.10. Jei jūsų numatytasis Python diegimas yra senesnis ar naujesnis ir jo negalima atnaujinti, turite papildomai įdiegti Python 3.9 ir, skambindami pipx, nurodyti jo Python vykdomosios programos pavadinimą, pvz:

$ pipx install --python python3.9 pynitrokey

nerasta libusb-1.0.dylib

Paleidžiant „nitropy“ „MacOS“ sistemoje gali būti rodomas klaidos pranešimas, kad trūksta libusb-1.0.dylib failo. Tai galima ištaisyti rankiniu būdu įdiegiant libusb, pvz., naudojant homebrew:

$ brew install libusb

Naudojimo pastabos

Visos platformos

Jei norite naudoti „nitropy“ su „Nitrokey Pro“ arba „Nitrokey Storage“ įrenginiu, taip pat turite įdiegti libnitrokey.

Windows

„Windows“ palaikymas vis dar eksperimentinis - naudokite atsargiai.

Kad galėtumėte prisijungti prie įrenginio, gali tekti paleisti „nitropy“ su administratoriaus teisėmis.

Linux

„Linux“ sistemose taip pat reikia „Nitrokey udev“ taisyklių. Jos tiekiamos su libnitrokey. Arba galite jas įdiegti rankiniu būdu:

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

Daugiau informacijos žr. Udev taisyklių nustatymas.

Usage of PIV features

Kad galėtumėte naudotis nitropy PIV funkcijomis (nitropy nk3 piv), turite įdiegti ir pyscard priklausomybę:

pipx install pynitrokey[pcsc]

Tolesni žingsniai

Daugiau informacijos apie nitropijos naudojimą rasite šiuose vadovuose: