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

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

Примечание

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

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

Ubuntu, Debian#

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

sudo apt install pipx && 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

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

Установка на других распределительных/операционных системах#

Подготовка#

Python 3.9, 3.10 или 3.11#

Python уже установлен на большинстве систем macOS и Linux или может быть загружен с сайта python.org. Дополнительную информацию см. в Руководстве по загрузке Python.

pip#

Вы можете установить pip с помощью менеджера пакетов вашей системы или с помощью python3 -m ensurepip. Дополнительную информацию см. в pip Installation Guide.

pipx#

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

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

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

Примечание

Для пользователей Linux - в настоящее время переходная зависимость (oscrypto) вызывает проблемы на некоторых дистрибутивах Linux. Соответствующий GitHub выпуск документирует необходимое на данный момент обходное решение:

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

Установка#

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

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

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

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