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.

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 žr. 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/libnitrokey/master/data/41-nitrokey.rules
sudo mv 41-nitrokey.rules /etc/udev/rules.d/

Daugiau informacijos žr. Udev taisyklių nustatymas.

Tolesni žingsniai#

Daugiau informacijos apie nitropijos naudojimą rasite šiuose vadovuose: