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

Nepalaikoma ranka#

Šiuo metu naujausių „nitropy“ versijų negalima įdiegti „Arm“ platformose dėl priklausomybės problemos („GitHub“ problema). Kaip apeinamąją priemonę galite naudoti x86 „Python“ diegimą „Rosetta“ terminale, kaip aprašyta šioje diskusijoje).

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#

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]

Tolesni žingsniai#

Daugiau informacijos apie nitropijos naudojimą rasite šiuose vadovuose: