pipxでnitropyをインストールする#

このガイドは、pipx を使って nitropy をインストールする方法を説明します。 pipx は nitropy のために仮想環境を作成します。これは、nitropyとその依存関係が、あなたのシステムにインストールされている他のパッケージと衝突しないことを意味します。

注釈

Windowsユーザーの方へ: Windowsのサポートはまだ実験的なものです -- 慎重に使用してください。プリコンパイルされたバイナリやMSIインストーラを使用することもできます。

Linuxへのインストール#

Ubuntu、Debian#

他のすべての必要な依存関係とともに、nitropy をインストールするには次のようにします：

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

ログアウトするかシステムを再起動すると、nitropyが利用できるようになります。

アーチ#

他のすべての必要な依存関係とともに、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 からダウンロードすることが可能です。詳しくは Downloading Python Guide を参照してください。

ピップ#

pipはシステムのパッケージマネージャ、または``python3 -m ensurepip``でインストールすることができます。詳しくは pip インストールガイドを参照してください。

ピップス#

nitropyをインストールする前に、pipx:をインストールし、設定する必要があります。

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

詳細については、`pipxインストールガイド<https://pipx.pypa.io/stable/>`__を参照してください。

注釈

Linux ユーザーの皆様へ - 現在、一時的な依存関係 (oscrypto) が、一部の Linux distrubutions で問題を発生させています。それぞれの`GitHub issue<https://github.com/Nitrokey/pynitrokey/issues/431#issuecomment-1937704327>`__ に、現在必要とされている回避策が記載されています：

pipx inject --pip-args="--upgrade --force" pynitrokey "oscrypto @ git+https://github.com/wbond/oscrypto.git@1547f535001ba568b239b8797465536759c742a3"

インストール#

これで、pynitrokeyパッケージからnitropyをインストールすることができます:

pipx install pynitrokey

nitropyがpath:で使用できるようになりました。

nitropy --help

アップグレード#

以下のコマンドで、パッケージをアップグレードできます。

pipx upgrade pynitrokey

トラブルシューティング#

問題が発生した場合は、nitropy version の出力と GitHub のリリースリスト <https://github.com/Nitrokey/pynitrokey/releases>`_ を比較して最新版を使用しているかどうか確認して下さい。アップグレードで最新版がインストールされない場合、以下のような問題が発生している可能性があります。

Pythonのバージョンが違う#

nitropyはPython 3.9または3.10を必要とします。もし、デフォルトでインストールされているPythonがそれより古いか新しく、アップデートできない場合は、追加でPython 3.9をインストールし、pipxを呼ぶときにそのPython実行ファイルの名前を指定する必要があります、例えば:

$ pipx install --python python3.9 pynitrokey

アーム非対応#

` <https://github.com/Nitrokey/pynitrokey/issues/265>`ー現在のー現在のー現在ーーーーーーー最近のーーー最近のーーー最近のーー最近のーー最近のー最近のー最近のー最近のー最近のー最近のー最近のー最近のー最近のー最近のー最近のー最近のー最近のー最近のー最近のー最近のー最近のー最近のー最近のー最近のー最近のー最近のーー（ーーーー）ー`このー<https://stackoverflow.com/questions/71691598/how-to-run-python-as-x86-with-rosetta2-on-arm-macos-machine>`_ でーーでーー x86のー Pythonーー）

libusb-1.0.dylib が見つかりません。#

macOS で nitropy を実行すると、libusb-1.0.dylib ファイルがないことを示すエラーメッセージが表示されることがあります。これは、homebrew:.NET を使って手動で libusb をインストールすれば直ります。

$ brew install libusb

使用上の注意#

すべてのプラットフォーム#

Nitrokey Pro や Nitrokey Storage デバイスで nitropy を使用する場合は、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/

詳しくは 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]

次のステップ#

nitropyの使用方法については、これらのガイドで詳しく説明しています。