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

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

Note

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

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

Ubuntu, Debian#

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

sudo apt install pipx && 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 вече ще бъде достъпна.

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

Подготовка#

Python 3.9, 3.10 или 3.11#

Python вече е инсталиран на повечето системи MacOS и Linux или може да бъде изтеглен от python.org. За повече информация вижте Наръчник за изтегляне на Python.

pip#

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

pipx#

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

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

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

Note

За потребителите на Linux - в момента преходна зависимост (oscrypto) създава проблеми в някои дистрибуции на Linux. Съответният проблем на GitHub документира необходимото в момента решение:

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

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

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

pipx install pynitrokey

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

nitropy --help

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

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

pipx upgrade pynitrokey

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

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

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

nitropy изисква Python 3.9 или 3.10. Ако инсталацията на Python по подразбиране е по-стара или по-нова и не може да бъде актуализирана, трябва допълнително да инсталирате Python 3.9 и да посочите името на изпълнимия файл на Python при извикването на pipx, например:

$ pipx install --python python3.9 pynitrokey

Ръката не се поддържа#

Понастоящем последните версии на nitropy не могат да бъдат инсталирани на платформи Arm поради проблем със зависимостта (GitHub issue). Като заобиколен вариант можете да използвате инсталация на x86 Python в терминал Rosetta, както е описано в тази дискусия).

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 в тези ръководства: