Instalowanie nitropii za pomocą pipx¶
Ten przewodnik wyjaśnia jak zainstalować nitropy za pomocą pipx. pipx tworzy wirtualne środowisko dla nitropy. Oznacza to, że nitropy i jego zależności nie są w konflikcie z innymi pakietami zainstalowanymi w systemie.
Informacja
Dla użytkowników Windows: Wsparcie dla Windows jest wciąż eksperymentalne - prosimy o ostrożność. Możesz także użyć prekompilowanych plików binarnych lub instalatora MSI, zobacz Instalacja nitropy w systemie Windows.
Instalacja w systemie Linux¶
Ubuntu, Debian¶
Możesz zainstalować nitropy wraz ze wszystkimi innymi wymaganymi zależnościami za pomocą:
$ sudo apt install pipx libpython3-dev libudev-dev && pipx ensurepath && pipx install pynitrokey
Po wylogowaniu lub ponownym uruchomieniu systemu, nitropy będzie teraz dostępna.
Arch¶
Możesz zainstalować nitropy wraz ze wszystkimi innymi wymaganymi zależnościami za pomocą:
$ sudo pacman -S python python-pipx && pipx ensurepath && pipx install pynitrokey
Jeśli masz już zainstalowany Python w swoim systemie, możesz po prostu uruchomić:
$ sudo pacman -S python-pipx && pipx ensurepath && pipx install pynitrokey
Po wylogowaniu lub ponownym uruchomieniu systemu, nitropy będzie teraz dostępna.
Fedora¶
Możesz zainstalować nitropy wraz ze wszystkimi innymi wymaganymi zależnościami za pomocą:
$ sudo dnf install python pipx && pipx ensurepath && pipx install pynitrokey
Jeśli masz już zainstalowany Python w swoim systemie, możesz po prostu uruchomić:
$ sudo dnf install pipx && pipx ensurepath && pipx install pynitrokey
After logging our or restarting your system, nitropy will now be available.
Mageia¶
Możesz zainstalować nitropy wraz ze wszystkimi innymi wymaganymi zależnościami za pomocą:
$ sudo dnf install python python3-pip && pip install --user pipx && pipx ensurepath && pipx install pynitrokey
Jeśli masz już zainstalowany Python w swoim systemie, możesz po prostu uruchomić:
$ 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.
Instalacja na innych dystrybucjach/systemach operacyjnych¶
Przygotowanie¶
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¶
Możesz zainstalować pip za pomocą systemowego menedżera pakietów lub za pomocą python3 -m ensurepip. Więcej informacji można znaleźć w przewodniku instalacji pip.
pipx¶
Przed zainstalowaniem nitropy należy zainstalować i skonfigurować pipx:
$ python3 -m pip install --user pipx
$ python3 -m pipx ensurepath
Więcej informacji można znaleźć w pipx Installation Guide.
Instalacja¶
Teraz można zainstalować nitropy z pakietu pynitrokey:
$ pipx install pynitrokey
nitropy jest teraz dostępna w ścieżce użytkownika:
$ nitropy --help
Aktualizacja¶
Pakiet można uaktualnić za pomocą następującego polecenia:
$ pipx upgrade pynitrokey
Rozwiązywanie problemów¶
Jeśli napotkasz problemy, upewnij się, że używasz najnowszej wersji, porównując wyjście nitropy version z listą release na GitHubie. Jeśli aktualizacja nie zainstaluje najnowszej wersji, możesz napotkać jeden z następujących problemów.
Nieprawidłowa wersja Pythona¶
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
nie znaleziono libusb-1.0.dylib¶
Podczas uruchamiania nitropy na macOS, możesz zobaczyć komunikat o błędzie wskazujący na brak pliku libusb-1.0.dylib. Można to naprawić poprzez ręczne zainstalowanie libusb, np. za pomocą homebrew:
$ brew install libusb
Uwagi o użytkowaniu¶
Wszystkie platformy¶
Jeśli chcesz używać nitropy z Nitrokey Pro lub Nitrokey Storage, musisz również zainstalować libnitrokey.
Windows¶
Obsługa systemu Windows jest nadal eksperymentalna - należy zachować ostrożność.
Aby móc połączyć się z urządzeniem, konieczne może być uruchomienie programu nitropy z prawami administratora.
Linux¶
W systemach Linux, potrzebujesz również reguł udev Nitrokey. Są one dostarczane z libnitrokey. Alternatywnie możesz je zainstalować ręcznie:
$ wget https://raw.githubusercontent.com/Nitrokey/nitrokey-udev-rules/refs/heads/main/41-nitrokey.rules
$ sudo mv 41-nitrokey.rules /etc/udev/rules.d/
Więcej informacji na ten temat można znaleźć w Konfigurowanie reguł udev.
Korzystanie z funkcji PIV¶
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]
Następne kroki¶
Więcej informacji na temat używania nitropii można znaleźć w tych przewodnikach:
Dla Linuksa: ../../../nitrokey/nitrokey3/firmware-update.
Dla komputerów Mac: ../../../nitrokey/nitrokey3/firmware-update.
Dla Windows: ../../../nitrokey/nitrokey3/firmware-update.