在本指南中，您将学习如何在树莓派上安装和运行 qBittorent 。
qBittorent 是您可以在 Pi 上使用的最受欢迎的 Torrent 客户端之一。
它以相对稳定的平台和良好的功能集而闻名，该功能集可在有限资源的设备 (如树莓派) 上很好地工作。
它是 Teluge 或 Transmission 等其他洪流客户端的完美替代方案。 。
除了向您展示如何安装 qBittorrent 之外，我们还将向您展示如何设置和配置 qBittorrent 。
通过设置网络界面，您可以轻松地从另一台设备控制树莓派的 qBittorrent 。
通过 Web 界面，您可以轻松地在无头树莓派上使用此客户端。无头是没有监视器，键盘或鼠标的设备。
设备
在下面，您可以查看我们用于在树莓派上运行 qBittorrent 的所有设备。
推荐的
树莓派
Micro SD 卡 (8GB +)
网络连接
可选的
树莓派外壳
USB 键盘
USB 鼠标
本教程已在树莓派 4 和 Pi 400 上进行了测试。运行树莓派 OS 的最新版本。
将 qBittorent 安装到树莓派
在使用 qBittorrent 之前，我们需要向您展示如何将 torrent 客户端安装到树莓派。
安装该 torrent 客户端是一个非常简单的过程，因此您将立即安装并运行该软件。
1 在安装 qBittorrent 之前，让我们确保我们的树莓派使用最新的软件包。
这样做可以确保我们在安装客户端时不太可能遇到问题。
要执行软件包的升级，您将需要使用以下两个命令。
sudo apt update
sudo apt full-upgrade2 接下来，我们可以在我们的树莓派上安装 qBittorrent 。
在这种情况下，我们有两个单独的命令可用于安装软件。
您要使用什么版本完全取决于您使用树莓派的方式。
qBittorrent 桌面树莓派
第一个命令用于那些想要使用该软件的完整桌面版本的用户。
此版本的 qBittorent 较重，不能用于运行无头树莓派的用户。
sudo apt install qbittorrent qBittorrent 用于无头树莓派
第二个命令将允许您安装 qBittorrent 的命令行版本。
此版本非常适合那些无头环境的用户，因为它使您可以轻松访问 Web 界面。
sudo apt install qbittorrent -nox** 3 ** 至此，您现在应该已经在树莓派上安装了 qBittorrent 软件。
现在，我们可以向您展示如何在台式机和命令行界面上设置 qBittorrent 。
使用桌面界面设置 qBittorent
在本节中，我们将向您展示各种内容，包括如何在树莓派上打开 qBittorrent 以及如何启用 Web 界面。
对于此部分，您需要将鼠标和键盘连接到树莓派。
如果您使用的是无头设置，请确保跳至我们的下一个设置部分。
在树莓派上打开 qBittorrent
在配置 qBittorrent 之前，我们需要首先在树莓派上打开该软件。
1 在树莓派界面上，您需要单击屏幕左上角的图标。
单击此图标将在屏幕上弹出开始菜单。
2 在开始菜单中，您需要将鼠标悬停在”Internet” 选项 (1 ) 上。
将鼠标悬停在此选项上将公开几个应用程序。在下拉菜单中，识别”qBittorrent“，然后单击它 (2 )。
3 首次在树莓派上运行 qBittorrent 时，您会看到一条法律声明，需要阅读后才能继续。
如果您对法律声明中提到的内容满意，请单击” 我同意 “按钮继续。
4 现在，您应该在树莓派上运行 qBittorrent 客户端。
现在，您可以继续添加种子并从设备中下载它们。
如果您想远程管理种子，可以使用该软件的 Web UI。
通过客户端软件启用 Web UI
本节将向您展示如何使用 qBittorrent 客户端的界面来启用其 Web 界面。
1 在树莓派上打开 qBittorrent 软件后，单击顶部工具栏中的” 工具” 选项 (1 )。
在下拉框中，单击”` 首选项” 选项 (2 )
2 在” 首选项” 菜单中，我们需要通过单击左侧边栏中的图标 (1 ) 更改为”Web UI“选项卡。
切换到 Web UI 菜单后，单击”Web 用户界面” 复选框以启用它 (2 )。
3 启用网络用户界面后，您将可以修改其设置。
您应该更改用于登录界面的用户名和密码 (1 )。
设置好身份验证详细信息后，单击”Apply“按钮完成设置 (2 )。
要了解如何访问和使用此 Web 界面，您可以查看下面的” 使用 qBittorrent Web 界面” 部分。
使用命令行设置 qBittorent
感谢我们使用的 Nox 客户端，从树莓派命令行使用 qBittorrent 是一个相当简单的过程。
在本节中，我们将向您展示几件事。首先是如何从树莓派终端运行 torrent 客户端。
然后，我们将向您展示如何设置服务，以便 qBittorent 在启动时启动。最后，我们将向您介绍 Web 界面。
在开始之前，需要注意的一件事是 qBittorrent 的命令行版本主要是通过其 Web 界面而非命令行本身配置的。
使用树莓派的终端启动 qBittorrent
在本节中，您将看到在树莓派上启动仅 Web 界面的 qBittorrent 版本是多么简单。
1 要在树莓派上启动 qBittorrent 的命令行版本，您需要做的就是运行以下命令。
qbittorrent-nox2 从命令行运行 qBittorrent 时，将看到以下消息。
此消息告诉您，您需要通过 Web 界面而不是树莓派的命令行来控制 torrent 客户端。
它还会告诉您 Web UI 管理员当前定义的用户名。默认情况下，该用户名将为”admin”。
********信息********
要控制 qBittorrent ，请访问 http ：//localhost：8080上的 Web UI
Web UI管理员用户名是：admin3 我们在树莓派上运行 qBittorrent 的当前问题是，一旦当前终端会话关闭，客户端也将关闭。
为了解决这个问题，我们将创建一个处理客户端操作的服务。
您可以通过按 CTRL + C 退出 torrent 客户端。
将 qBittorrent 作为服务运行
在下一部分中，我们将创建一个服务，该服务将在树莓派上运行和管理 qBittorrent 客户端。
1 在创建服务之前，我们应该先创建一个用户，供客户端在其下进行操作。
我们这样做的主要原因归结为提高树莓派的安全性。
让我们使用以下 useradd 命令创建我们的新用户。在本指南中，我们将这个新用户称为 qbittorrent 。
sudo useradd -r -m qbittorrent使用该命令，您会注意到我们使用了”-r“(--system) 参数。此参数告诉命令应将此用户设置为系统用户。
另外，我们使用”-m” 参数来告诉命令它应该为用户创建一个主目录。
这意味着该用户无法登录并只能作为系统用户。
2 为确保我们可以访问由新的”`qbittorrent” 用户创建的文件，我们将”pi” 用户添加到其组中。
为此，我们将使用 usermod 命令。在树莓派上运行以下命令，将 pi 用户添加到 qbittorrent 组。
sudo usermod -a -G qbittorrent pi“`-a” 参数告诉命令我们要向用户添加新属性。 “-G” 参数表示我们要添加一个组。
3 最后，我们可以继续创建服务本身。
为了在我们的树莓派上为 qBittorrent 软件编写此服务，我们将使用 nano 文本编辑器。
sudovim/etc/systemd/system/qbittorrent.service4 在此文件中，我们要输入以下文本行。这些行指示服务管理器如何运行 qBittorrent 。
[单元]
说明 = qBittorrent
之后 = network.target
[服务]
类型=分叉
用户= qbittorrent
组= qbittorrent
UMask = 002
ExecStart =/usr/bin/qbittorrent-nox -d --webui-port = 8080
重新启动=失败
[安装]
WantedBy =多用户目标我们创建的此服务需要指出两点。
首先是 qBittorrent 软件将在我们之前创建的用户和组下运行。
另外，我们向用户应用”UMask“，以便该用户创建的所有文件都将拥有以下 Linux 许可，即”rw-rw-r--“。
此权限意味着所有者和组可以读写该用户创建的所有文件。
最后，我们传递带有几个参数的 qBittorrent 可执行文件的路径。
第一个是”-d“，它告诉程序我们要将其作为” 守护程序” 运行。
其次，我们使用”--webui-port“参数传入我们希望 Web UI 可用的端口。
5 输入所有内容后，按 CTRL + X，然后按 Y ，再按 ENTER 键，保存文件。
6 现在，我们已经创建了文件，现在可以启动新创建的 qBittorrent 服务。
sudo systemctl启动 qbittorrent 7 我们可以使用以下命令来验证 qBittorrent 现在正在树莓派上运行。
sudo systemctl状态 qbittorrent 如果 torrent 客户端按预期运行，则应在此命令中看到以下文本。
活动：活动(运行中)8 最后，现在我们知道 qBittorrent 服务可以工作了，我们可以在树莓派启动时启动它。
您可以通过在设备上运行以下命令来启用启动功能。
sudo systemctl启用 qbittorrent 使用 qBittorrent Web 界面
在本节中，我们将向您展示如何访问 qBittorrent Web 界面以及在哪里可以找到其选项页
对于那些运行无头树莓派设置的用户，这是管理种子的唯一方法。
访问 qBittorrent 的 Web 界面
访问 qBittorrent 的 Web UI 是一个非常简单的过程。您只需要一个 Web 浏览器和树莓派的 IP 地址即可。
1 此时，您应该启用 qBittorrent Web 界面，无论是通过桌面客户端还是使用命令行版本的 qBittorrent 。
要进入该界面，您需要在您喜欢的网络浏览器中转到以下地址。
确保用” 树莓派的本地 IP 地址”(https://pimylifeup.com/raspberry-pi-ip-address/) 替换 "[[您的 IP 地址]””。
http：//[您的 IP 地址]：80802 访问 qBittorrent Web 界面时，您需要登录 (1 )。
如果您尚未更改身份验证详细信息，则此界面的默认用户名是”admin“，默认密码是”adminadmin“。
输入正确的详细信息后，您可以单击” 登录” 按钮 (2 )。
3 您现在可以使用网络界面来管理 torrent 客户端本身和 torrent 。
通过 Web 界面配置 qBittorrent
幸运的是，qBittorrent 的配置过程非常简单，尤其是通过其 Web 界面。
1 要进入选项，您需要单击顶部工具栏中的” 工具” 按钮 (1 )。
在下拉框中，单击” 选项 “按钮以打开对话框 (2 )。
2 使用选项对话框 (1 )，您可以配置 qBittorrent 的几乎每个元素。
您应该使用此界面配置的第一件事是您的用户名和密码 (2 )。
结论
希望在这一点上，您现在已经在树莓派上成功设置了 qBittorrent 。
它是树莓派最好的 Torrent 客户端之一，并且由于其出色的 Web 界面而非常适合无头设置。
如果您在使用本指南时遇到任何问题，或者感觉缺少某些内容，请在下面发表评论。
另外，请查看我们的其他一些树莓派大项目，以了解您还可以对设备进行哪些操作。