Установка nitropy с помощью pipx¶

Это руководство объясняет, как установить nitropy с помощью pipx. pipx создает виртуальную среду для nitropy. Это означает, что nitropy и его зависимости не конфликтуют с другими пакетами, установленными в вашей системе.

Примечание

Для пользователей Windows: Поддержка Windows все еще является экспериментальной - пожалуйста, используйте ее с осторожностью. Вы также можете использовать предварительно скомпилированные двоичные файлы или программу установки MSI, смотрите …/windows/installation.

Установка в Linux¶

Ubuntu, Debian¶

Вы можете установить nitropy вместе со всеми остальными необходимыми зависимостями, используя:

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

После выхода из системы или ее перезагрузки нитропия станет доступной.

Арх¶

Вы можете установить nitropy вместе со всеми остальными необходимыми зависимостями, используя:

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

Если вы уже установили Python в своей системе, вы можете просто запустить:

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

После выхода из системы или ее перезагрузки нитропия станет доступной.

Fedora¶

Вы можете установить nitropy вместе со всеми остальными необходимыми зависимостями, используя:

$ sudo dnf install python pipx && pipx ensurepath && pipx install pynitrokey

Если вы уже установили Python в своей системе, вы можете просто запустить:

$ sudo dnf install pipx && pipx ensurepath && pipx install pynitrokey

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

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 Installation Guide.

pipx¶

Перед установкой nitropy необходимо установить и настроить pipx:

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

Дополнительные сведения см. в руководстве по установке pipx.

Установка¶

Теперь вы можете установить 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¶

Поддержка 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/

Дополнительную информацию см. в …/linux/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]

Следующие шаги¶

Более подробную информацию об использовании нитропида можно найти в этих руководствах: