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
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¶
ニトロピのPIV機能（nitropy nk3 piv ）を使用できるようにするには、pyscard 依存関係もインストールする必要があります：
pipx install pynitrokey[pcsc].
次のステップ¶
nitropyの使用方法については、これらのガイドで詳しく説明しています。
For Linux: ファームウェアの更新
For Mac: ファームウェアの更新
For Windows: ファームウェアの更新