Nitropyn asentaminen pipx:llä#
Tässä oppaassa kerrotaan, miten nitropy asennetaan pipx. pipx luo virtuaalisen ympäristön nitropylle. Tämä tarkoittaa, että nitropy ja sen riippuvuudet eivät ole ristiriidassa muiden järjestelmään asennettujen pakettien kanssa.
Muista
Windows-käyttäjille: Windows-tuki on vielä kokeellinen - käytä sitä varoen. Voit myös käyttää valmiiksi käännettyjä binääripaketteja tai MSI-asennusohjelmaa, katso Nitropyn asentaminen Windowsissa.
Asennus Linuxiin#
Ubuntu, Debian#
Voit asentaa nitropyn ja kaikki muut tarvittavat riippuvuudet käyttämällä:
sudo apt install pipx && pipx ensurepath && pipx install pynitrokey
Kun olet kirjautunut ulos tai käynnistänyt järjestelmän uudelleen, nitropy on nyt käytettävissä.
Arch#
Voit asentaa nitropyn ja kaikki muut tarvittavat riippuvuudet käyttämällä:
sudo pacman -S python python-pipx && pipx ensurepath && pipx install pynitrokey
Jos olet jo asentanut Pythonin järjestelmääsi, voit yksinkertaisesti ajaa:
sudo pacman -S python-pipx && pipx ensurepath && pipx install pynitrokey
Kun olet kirjautunut ulos tai käynnistänyt järjestelmän uudelleen, nitropy on nyt käytettävissä.
Asennus muihin jakelu-/käyttöjärjestelmiin#
Valmistelu#
Python 3.9, 3.10 tai 3.11.#
Python on jo asennettu useimpiin macOS- ja Linux-järjestelmiin tai sen voi ladata osoitteesta python.org. Katso lisätietoja Pythonin latausoppaasta.
pip#
Voit asentaa pipin järjestelmän paketinhallinnan avulla tai python3 -m ensurepip
. Katso lisätietoja pipin asennusoppaasta.
pipx#
Ennen nitropyn asentamista sinun on asennettava ja konfiguroitava pipx:
python3 -m pip install --user pipx
python3 -m pipx ensurepath
Lisätietoja on osoitteessa pipx Installation Guide.
Muista
Linux-käyttäjille - tällä hetkellä väliaikainen riippuvuus (oscrypto
) aiheuttaa ongelmia joissakin Linux-jakeluissa. Vastaava GitHub-ongelma dokumentoi tällä hetkellä tarvittavan ratkaisun:
pipx inject --pip-args="--upgrade --force" pynitrokey "oscrypto @ git+https://github.com/wbond/oscrypto.git@1547f535001ba568b239b8797465536759c742a3"
Asennus#
Nyt voit asentaa nitropyn pynitrokey-paketista:
pipx install pynitrokey
nitropy on nyt saatavilla polussasi:
nitropy --help
Päivitys#
Voit päivittää paketin seuraavalla komennolla:
pipx upgrade pynitrokey
Vianmääritys#
Jos kohtaat ongelmia, varmista, että käytät uusinta versiota vertaamalla nitropy version
:n tulosta julkaisuluetteloon GitHubissa. Jos päivitys ei asenna uusinta versiota, sinulla saattaa olla jokin seuraavista ongelmista.
Väärä Python-versio#
nitropy vaatii Python 3.9 tai 3.10. Jos oletusarvoinen Python-asennuksesi on vanhempi tai uudempi eikä sitä voi päivittää, sinun on lisäksi asennettava Python 3.9 ja määritettävä sen Python-ohjelman nimi, kun kutsut pipx:ää, esimerkiksi:
$ pipx install --python python3.9 pynitrokey
Käsivarsi Ei tuettu#
Tällä hetkellä viimeisimpiä nitropy-versioita ei voi asentaa Arm-alustoille riippuvuusongelman vuoksi (GitHub issue). Vaihtoehtona voit käyttää x86 Python-asennusta Rosetta-päätteessä, kuten on kuvattu tässä keskustelussa).
libusb-1.0.dylib ei löydy#
Kun käytät nitropy-ohjelmaa macOS:ssä, saatat nähdä virheilmoituksen, joka kertoo puuttuvasta libusb-1.0.dylib-tiedostosta. Tämä voidaan korjata asentamalla libusb manuaalisesti, esimerkiksi homebrew:
$ brew install libusb
Käyttöä koskevat huomautukset#
Kaikki alustat#
Jos haluat käyttää nitropyä Nitrokey Pro- tai Nitrokey Storage -laitteen kanssa, sinun on myös asennettava libnitrokey.
Windows#
Windows-tuki on vielä kokeellinen - käytä sitä varoen.
Sinun on ehkä suoritettava nitropy järjestelmänvalvojan oikeuksin voidaksesi muodostaa yhteyden laitteeseen.
Linux#
Linux-järjestelmissä tarvitset myös Nitrokey udev-säännöt. Nämä toimitetaan libnitrokey mukana. Vaihtoehtoisesti voit asentaa ne manuaalisesti:
wget https://raw.githubusercontent.com/Nitrokey/libnitrokey/master/data/41-nitrokey.rules
sudo mv 41-nitrokey.rules /etc/udev/rules.d/
Katso udev-sääntöjen määrittäminen lisätietoja.
Seuraavat vaiheet#
Näistä oppaista löydät lisätietoja nitropian käytöstä:
Linuxissa: Firmware-päivitys.
Macille: Firmware-päivitys.
Windows: Firmware-päivitys.