用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
注销或重启系统后，即可使用硝化甘油。
安装在其他配电/操作系统上¶
准备工作¶
Python 3.9、3.10 或 3.11¶
Python 已经安装在大多数 macOS 和 Linux 系统上，或者可以从 python.org <https://python.org>`__下载。请参阅 `下载 Python 指南 了解更多信息。
琵琶¶
你可以用你的系统软件包管理器或用``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/>`__。
备注
对于 Linux 用户 - 目前，一个短暂的依赖关系 (oscrypto) 在某些 Linux 发行版上产生了问题。`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现在可以在你的路径：。
nitropy --help
升级¶
你可以用以下命令升级该软件包：。
pipx upgrade pynitrokey
故障排除¶
如果你遇到问题，请通过比较``nitropy version``和GitHub上的`release list <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文件。 这可以通过手动安装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¶
要使用硝酸盐的 PIV 功能 (nitropy nk3 piv)，还需要安装``pyscard`` 依赖项：
pipx install pynitrokey[pcsc]
接下来的步骤¶
你可以在这些指南中找到更多关于使用nitropy的信息。