Инсталиране на nitropy с pipx¶

Това ръководство обяснява как да инсталирате nitropy с pipx. pipx създава виртуална среда за nitropy. Това означава, че nitropy и неговите зависимости не влизат в конфликт с други пакети, инсталирани във вашата система.

Note

За потребителите на Windows: Поддръжката на Windows все още е експериментална - моля, използвайте я с повишено внимание. Можете също така да използвате предварително компилирани двоични файлове или инсталатор MSI, вижте Инсталиране на nitropy в Windows.

Инсталиране под Linux¶

Ubuntu, Debian¶

Можете да инсталирате nitropy заедно с всички други необходими зависимости, като използвате:

$ sudo apt install pipx libpython3-dev libudev-dev && pipx ensurepath && pipx install pynitrokey

След като излезете от системата или я рестартирате, nitropy вече ще бъде достъпна.

Arch¶

Можете да инсталирате nitropy заедно с всички други необходими зависимости, като използвате:

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

Ако вече сте инсталирали Python в системата си, можете просто да стартирате:

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

След като излезете от системата или я рестартирате, nitropy вече ще бъде достъпна.

Fedora¶

Можете да инсталирате nitropy заедно с всички други необходими зависимости, като използвате:

$ sudo dnf install python pipx python3-devel libudev-devel && pipx ensurepath && pipx install pynitrokey

Ако вече сте инсталирали Python в системата си, можете просто да стартирате:

$ sudo dnf install pipx python3-devel libudev-devel && pipx ensurepath && pipx install pynitrokey

След като излезете от системата или я рестартирате, nitropy вече ще бъде достъпна.

Mageia¶

Можете да инсталирате nitropy заедно с всички други необходими зависимости, като използвате:

$ sudo dnf install python python3-pip && pip install --user pipx && pipx ensurepath && pipx install pynitrokey

Ако вече сте инсталирали Python в системата си, можете просто да стартирате:

$ sudo dnf install python3-pip && pip install --user pipx && pipx ensurepath && pipx install pynitrokey

After logging our or restarting your system, nitropy will now be available.

Инсталиране в други разпределителни/оперативни системи¶

Подготовка¶

Python¶

Python is already installed on most macOS and Linux systems or can be downloaded from python.org. Currently the supported Python versions are 3.9, 3.10, 3.11, 3.12 and 3.13. See the Downloading Python Guide for more information.

pip¶

Можете да инсталирате pip с помощта на системния си мениджър на пакети или с python3 -m ensurepip. За повече информация вижте ръководството за инсталиране на pip.

pipx¶

Преди да инсталирате nitropy, трябва да инсталирате и конфигурирате pipx:

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

За повече информация вижте Ръководството за инсталиране на pipx.

Инсталиране на приложението Nitrokey¶

Сега можете да инсталирате nitropy от пакета pynitrokey:

$ pipx install pynitrokey

nitropy вече е наличен във вашия път:

$ nitropy --help

Надграждане¶

Можете да обновите пакета със следната команда:

$ pipx upgrade pynitrokey

Отстраняване на неизправности¶

Ако срещнете проблеми, моля, уверете се, че използвате най-новата версия, като сравните изхода на nitropy version със списъка на версиите в GitHub. Ако при обновяването не се инсталира най-новата версия, може би се сблъсквате с един от следните проблеми.

Грешна версия на Python¶

If your default Python installation is not in the supported versions list above, you need to specify an alternative to pipx. Install a supported version of Python and specify the name of its Python executable when calling pipx, for example:

$ pipx install --python python3.9 pynitrokey

libusb-1.0.dylib не е намерен¶

При стартиране на nitropy в macOS може да се появи съобщение за грешка, което показва, че липсва файл libusb-1.0.dylib. Това може да бъде поправено чрез ръчно инсталиране на libusb, например с Homebrew:

$ brew install libusb

Бележки за употреба¶

Всички платформи¶

Ако искате да използвате nitropy с устройство Nitrokey Pro или Nitrokey Storage, трябва също да инсталирате libnitrokey.

Windows 10¶

Поддръжката на Windows все още е експериментална - моля, използвайте я с повишено внимание.

Може да се наложи да стартирате nitropy с администраторски права, за да можете да се свържете с дадено устройство.

Linux¶

В системите Linux се нуждаете и от правилата Nitrokey udev. Те се доставят с libnitrokey. Като алтернатива можете да ги инсталирате ръчно:

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

Вижте Създаване на правилата на udev за повече информация.

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]

Следващи стъпки¶

Можете да намерите повече информация за използването на nitropy в тези ръководства: