Εγκαθιστώντας το nitropy με pipx

Αυτός ο οδηγός εξηγεί πώς να εγκαταστήσετε το nitropy με pipx. pipx δημιουργεί ένα εικονικό περιβάλλον για το nitropy. Αυτό σημαίνει ότι το nitropy και οι εξαρτήσεις του δεν έρχονται σε σύγκρουση με άλλα πακέτα που είναι εγκατεστημένα στο σύστημά σας.

Σημείωση

Για τους χρήστες των Windows: Η υποστήριξη των Windows είναι ακόμα πειραματική - παρακαλούμε χρησιμοποιήστε την με προσοχή. Μπορείτε επίσης να χρησιμοποιήσετε προ-μεταγλωττισμένα δυαδικά αρχεία ή ένα πρόγραμμα εγκατάστασης MSI, δείτε Εγκατάσταση του nitropy στα Windows.

Εγκατάσταση σε Linux

Ubuntu, Debian

Μπορείτε να εγκαταστήσετε το nitropy μαζί με όλες τις άλλες απαιτούμενες εξαρτήσεις χρησιμοποιώντας:

sudo apt install pipx && pipx ensurepath && pipx install pynitrokey

Μετά την αποσύνδεση ή την επανεκκίνηση του συστήματός σας, το nitropy θα είναι πλέον διαθέσιμο.

Arch

Μπορείτε να εγκαταστήσετε το nitropy μαζί με όλες τις άλλες απαιτούμενες εξαρτήσεις χρησιμοποιώντας:

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

Αν έχετε ήδη εγκαταστήσει την Python στο σύστημά σας, μπορείτε απλά να εκτελέσετε:

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

Μετά την αποσύνδεση ή την επανεκκίνηση του συστήματός σας, το nitropy θα είναι πλέον διαθέσιμο.

Εγκατάσταση σε άλλα συστήματα διανομής/λειτουργίας

Προετοιμασία

Python 3.9, 3.10 ή 3.11

Η Python είναι ήδη εγκατεστημένη στα περισσότερα συστήματα macOS και Linux ή μπορεί να μεταφορτωθεί από τη διεύθυνση python.org. Ανατρέξτε στον Οδηγό λήψης της Python για περισσότερες πληροφορίες.

pip

Μπορείτε να εγκαταστήσετε το pip με τον διαχειριστή πακέτων του συστήματός σας ή με python3 -m ensurepip. Ανατρέξτε στον Οδηγό εγκατάστασης του pip για περισσότερες πληροφορίες.

pipx

Πριν από την εγκατάσταση του nitropy, πρέπει να εγκαταστήσετε και να ρυθμίσετε το pipx:

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

Για περισσότερες πληροφορίες ανατρέξτε στο pipx Installation Guide.

Σημείωση

Για χρήστες 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 με τη λίστα εκδόσεων ` <https://github.com/Nitrokey/pynitrokey/releases>`_ στο 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, χρειάζεστε επίσης τους κανόνες udev του Nitrokey. Αυτοί παραδίδονται με το 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/

Δείτε το Ρύθμιση των κανόνων udev για περισσότερες πληροφορίες.

Usage of PIV features

Για να μπορέσετε να χρησιμοποιήσετε τη λειτουργία PIV του nitropy (nitropy nk3 piv), πρέπει να εγκαταστήσετε και την εξάρτηση pyscard:

pipx install pynitrokey[pcsc]

Επόμενα βήματα

Μπορείτε να βρείτε περισσότερες πληροφορίες σχετικά με τη χρήση της νιτροπίας σε αυτούς τους οδηγούς: