Установка 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

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¶

Чтобы иметь возможность использовать PIV-функциональность нитропии (nitropy nk3 piv), вам необходимо установить зависимость pyscard:

pipx install pynitrokey[pcsc].

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

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