用pipx安装nitropy¶
本指南解释了如何用`pipx <https://pypa.github.io/pipx/>`__安装nitropy。 pipx为nitropy创建一个虚拟环境。这意味着nitropy和它的依赖项不会与你系统上安装的其他软件包冲突。
在 Linux 上安装¶
Ubuntu, Debian¶
您可以使用: 来安装 nitropy 和所有其他所需的依赖项：
$ sudo apt install pipx && pipx ensurepath && pipx install pynitrokey
注销或重启系统后，即可使用硝化甘油。
拱门¶
您可以使用: 来安装 nitropy 和所有其他所需的依赖项：
$ sudo pacman -S python python-pipx && pipx ensurepath && pipx install pynitrokey
如果系统中已经安装了 Python，则只需运行：：
$ sudo pacman -S python-pipx && pipx ensurepath && pipx install pynitrokey
注销或重启系统后，即可使用硝化甘油。
Fedora¶
您可以使用: 来安装 nitropy 和所有其他所需的依赖项：
$ sudo dnf install python pipx && pipx ensurepath && pipx install pynitrokey
如果系统中已经安装了 Python，则只需运行：：
$ sudo dnf install pipx && pipx ensurepath && pipx install pynitrokey
After logging our or restarting your system, nitropy will now be available.
玛吉雅¶
您可以使用: 来安装 nitropy 和所有其他所需的依赖项：
$ sudo dnf install python python3-pip && pip install --user pipx && pipx ensurepath && pipx install pynitrokey
如果系统中已经安装了 Python，则只需运行：：
$ 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.
安装在其他配电/操作系统上¶
准备工作¶
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.
琵琶¶
你可以用你的系统软件包管理器或用``python3 -m ensurepip``安装pip。请参阅`pip安装指南<https://pip.pypa.io/en/stable/installation/>`__了解更多信息。
琵琶网¶
在安装nitropy之前，你必须安装和配置pipx：。
$ python3 -m pip install --user pipx
$ python3 -m pipx ensurepath
更多信息，请参见`pipx 安装指南<https://pipx.pypa.io/stable/>`__。
安装¶
现在你可以从pynitrokey软件包中安装nitropy：。
$ pipx install pynitrokey
nitropy现在可以在你的路径：。
$ nitropy --help
升级¶
你可以用以下命令升级该软件包：。
$ pipx upgrade pynitrokey
故障排除¶
如果你遇到问题，请通过比较``nitropy version``和GitHub上的`release list <https://github.com/Nitrokey/pynitrokey/releases>`_的输出来确保你使用了最新版本。 如果升级没有安装最新版本，你可能遇到了以下问题。
错误的Python版本¶
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
未找到 libusb-1.0.dylib¶
在macOS上运行nitropy时，你可能会看到一个错误信息，表明缺少libusb-1.0.dylib文件。 这可以通过手动安装libusb来解决，比如用homebrew:
$ brew install libusb
使用说明¶
所有平台¶
如果你想用Nitrokey Pro或Nitrokey存储设备使用nitropy，你还必须安装`libnitrokey <https://github.com/Nitrokey/libnitrokey>`__。
窗户¶
对Windows的支持仍然是试验性的 -- 请谨慎使用。
你可能必须以管理员权限运行nitropy，才能连接到设备。
基础设施¶
在Linux系统上，你还需要Nitrokey的udev规则。这些规则与`libnitrokey <https://github.com/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/
更多信息见:doc:.../linux/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的信息。