Установка nitropy с помощью pipx#
Это руководство объясняет, как установить nitropy с помощью pipx. pipx создает виртуальную среду для nitropy. Это означает, что nitropy и его зависимости не конфликтуют с другими пакетами, установленными в вашей системе.
Примечание
Для пользователей Windows: Поддержка Windows все еще является экспериментальной - пожалуйста, используйте ее с осторожностью. Вы также можете использовать предварительно скомпилированные двоичные файлы или программу установки MSI, смотрите …/windows/installation.
Подготовка#
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/libnitrokey/master/data/41-nitrokey.rules
sudo mv 41-nitrokey.rules /etc/udev/rules.d/
Дополнительную информацию см. в …/linux/udev.
Следующие шаги#
Более подробную информацию об использовании нитропида можно найти в этих руководствах:
Для Linux: …/…/…/nitrokey3/linux/firmware-update.
Для Mac: …/…/…/nitrokey3/mac/firmware-update.
Для Windows: …/…/…/nitrokey3/windows/firmware-update.