Εγκαθιστώντας το 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

Βραχίονας Δεν υποστηρίζεται#

Επί του παρόντος, οι πρόσφατες εκδόσεις του 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, χρειάζεστε επίσης τους κανόνες 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#

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]

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

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