Nitropy instalēšana ar pipx#

Šajā rokasgrāmatā ir izskaidrots, kā instalēt nitropy ar pipx. pipx izveido nitropy virtuālo vidi. Tas nozīmē, ka nitropy un tās atkarības nekonfliktē ar citām sistēmā instalētajām pakotnēm.

Piezīme

Sistēmas Windows lietotājiem: Windows atbalsts joprojām ir eksperimentāls - lūdzu, izmantojiet to piesardzīgi. Varat izmantot arī iepriekš kompilētas binārijas programmas vai MSI instalatoru, skatiet Nitropy instalēšana operētājsistēmā Windows.

Uzstādīšana operētājsistēmā Linux#

Ubuntu, Debian#

Jūs varat instalēt nitropy kopā ar visām citām nepieciešamajām atkarībām, izmantojot:

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

Pēc izrakstīšanās vai sistēmas restartēšanas tagad būs pieejama nitropija.

Arch#

Jūs varat instalēt nitropy kopā ar visām citām nepieciešamajām atkarībām, izmantojot:

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

Ja jūsu sistēmā jau ir instalēts Python, varat vienkārši palaist:

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

Pēc izrakstīšanās vai sistēmas restartēšanas tagad būs pieejama nitropija.

Uzstādīšana citās sadales/darbības sistēmās#

Sagatavošana#

Python 3.9, 3.10 vai 3.11#

Python jau ir instalēts vairumā macOS un Linux sistēmu vai arī to var lejupielādēt no python.org. Lai iegūtu vairāk informācijas, skatiet Python lejupielādes rokasgrāmatu.

pip#

Jūs varat instalēt pip, izmantojot sistēmas pakotņu pārvaldnieku vai python3 -m ensurepip. Lai iegūtu vairāk informācijas, skatiet pip instalēšanas rokasgrāmatu.

pipx#

Pirms nitropy instalēšanas ir jāinstalē un jākonfigurē pipx:

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

Lai iegūtu vairāk informācijas, skatiet pipx instalēšanas rokasgrāmatu.

Piezīme

Linux lietotājiem - pašlaik pārejoša atkarība (oscrypto) rada problēmas dažās Linux distrubucijās. Attiecīgajā GitHub jautājumā ir dokumentēts pašlaik nepieciešamais risinājums:

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

Uzstādīšana#

Tagad varat instalēt nitropy no pynitrokey paketes:

pipx install pynitrokey

nitropy tagad ir pieejams jūsu ceļā:

nitropy --help

Atjaunināšana#

Pakotni var atjaunināt, izmantojot šādu komandu:

pipx upgrade pynitrokey

Problēmu novēršana#

Ja rodas problēmas, pārliecinieties, ka izmantojat jaunāko versiju, salīdzinot nitropy version izvades rezultātu ar izlaides sarakstu GitHub. Ja jaunināšana neinstalē jaunāko versiju, iespējams, ir kāda no šādām problēmām.

Nepareiza Python versija#

Nitropy nepieciešama Python 3.9 vai 3.10. Ja jūsu noklusējuma Python instalācija ir vecāka vai jaunāka un to nav iespējams atjaunināt, jums papildus jāinstalē Python 3.9 un, izsaucot pipx, jānorāda tā Python izpilddatora nosaukums, piemēram:

$ pipx install --python python3.9 pynitrokey

Rokas nav atbalstītas#

Pašlaik jaunākās nitropy versijas nav iespējams instalēt Arm platformās atkarības problēmas dēļ (GitHub issue). Kā apiešanas iespēju var izmantot x86 Python instalāciju Rosetta terminālī, kā aprakstīts šajā diskusijā).

nav atrasts libusb-1.0.dylib#

Palaižot nitropy operētājsistēmā macOS, var parādīties kļūdas paziņojums, kas norāda, ka trūkst libusb-1.0.dylib faila. To var novērst, manuāli instalējot libusb, piemēram, ar homebrew:

$ brew install libusb

Lietošanas piezīmes#

Visas platformas#

Ja vēlaties izmantot nitropy ar Nitrokey Pro vai Nitrokey krātuves ierīci, ir jāinstalē arī libnitrokey.

Windows#

Windows atbalsts joprojām ir eksperimentāls - lūdzu, izmantojiet to piesardzīgi.

Lai varētu izveidot savienojumu ar ierīci, var būt nepieciešams palaist nitropy ar administratora tiesībām.

Linux#

Linux sistēmās ir nepieciešami arī Nitrokey udev noteikumi. Tie tiek piegādāti ar libnitrokey. Alternatīvi tos var instalēt manuāli:

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

Vairāk informācijas skatiet Udev noteikumu iestatīšana.

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]

Turpmākie soļi#

Vairāk informācijas par nitropijas lietošanu atradīsiet šajos ceļvežos: