qBittorrent 是一款功能强大的开源 BitTorrent 客户端，它提供轻量级、用户友好的界面，同时提供集成搜索、RSS 订阅支持和内置媒体播放器等高级功能。它以高效和广泛的功能而闻名，是需要可靠且强大的 torrent 客户端的用户的首选。对于运行 Ubuntu 的用户，qBittorrent 有稳定版和不稳定版，允许用户在最受测试的版本或最新功能之间进行选择。
在 Ubuntu 24.04、22.04 或 20.04 上，您可以使用“qBittorrent Team”Launchpad PPA 安装 qBittorrent，它为普通用户提供最新稳定版本的访问权限，或为有兴趣测试新功能的用户提供不稳定版本的访问权限。此外，对于 Ubuntu 服务器用户，本指南将演示如何安装 qBittorrent-nox，这是一个没有图形界面的版本，旨在通过 Web UI 进行管理，为服务器环境提供轻量级解决方案。本指南将引导您完成桌面版和 nox 版的安装过程，确保您拥有最适合您需求的设置。
导入 qBittorrent PPA 以获取最新稳定版本或预发布版本
在安装 qBittorrent 之前更新 Ubuntu
在我们开始之前，必须更新您的 Ubuntu 系统以确保所有软件包都是最新的，这有助于避免在 qBittorrent 安装期间发生冲突。
首先，通过运行以下命令更新包列表：
sudo apt update接下来，使用以下命令继续升级任何过时的软件包：
sudo apt upgrade安装 qBittorrent 的初始软件包
在系统更新后，您必须安装 qBittorrent 所需的依赖项。这些软件包可确保您的 Ubuntu 系统可以安全地访问和导入 qBittorrent PPA。运行以下命令：
sudo apt install dirmngr ca-certificates software-properties-common apt-transport-https此命令将安装必要的软件包或检查它们是否已经安装。
导入 qBittorrent PPA
要安装 qBittorrent，我们必须导入 “qBittorrent 团队” 包含最新软件版本的 PPA。您可以在稳定 PPA 和不稳定 PPA 之间进行选择。稳定 PPA 包含经过充分测试的版本，而不稳定 PPA 包含可能未经彻底测试的最新功能。
运行以下命令来导入您选择的 PPA：
选项 1：导入 qBittorrent 稳定 PPA：
sudo add-apt-repository ppa:qbittorrent-team/qbittorrent-stable -y选项 2：导入 qBittorrent 不稳定 PPA：
sudo add-apt-repository ppa:qbittorrent-team/qbittorrent-unstable -y导入 qBittorrent PPA 后更新软件包列表
导入 qBittorrent PPA 后，更新软件包列表以包含新添加的 PPA。这可确保您的系统在安装期间可以访问 qBittorrent 软件包。运行以下命令：
sudo apt update安装 qBittorrent 桌面客户端
在本节中，我们将在您的 Ubuntu 系统上安装 qBittorrent 桌面客户端并首次启动它。下一节适用于那些需要 qBittorrent 的 Web 界面版本的人，该版本最常在 Ubuntu 服务器上运行。
通过 APT 命令安装 qBittorrent 桌面客户端
现在您的系统具有必要的依赖项和 qBittorrent PPA，是时候安装 qBittorrent 桌面客户端了。通过执行以下命令，使用更新的软件包列表安装 qBittorrent：
sudo apt install qbittorrent此命令将从 PPA 获取适当的 qBittorrent 包并将其安装到您的系统上。
通过 CLI 命令启动 qBittorrent 桌面客户端
安装 qBittorrent 后，您可以启动并开始使用该应用程序。要启动 qBittorrent 桌面客户端（稳定版或不稳定版，取决于您导入的 PPA），您可以在终端会话中使用以下命令：
qbittorrent此命令将打开 qBittorrent 客户端，您可以开始管理您的种子。
或者，如果您更喜欢使用应用程序图标而不是终端来启动 qBittorrent，则可以通过系统的应用程序菜单访问它。为此，请按照以下路径操作：
Activities > Show Applications > qBittorrent
首次使用 qBittorrent 程序时，您将看到一个显示法律声明的弹出窗口。此声明可保护 qBittorrent 免于承担法律责任，因为 torrent 在当今未经授权的下载中扮演着重要角色。
一旦您同意法律声明，新安装的 qBittorrent 软件的主窗口将出现并可供使用。
为无头环境安装 qBittorrent-nox Web-UI（Ubuntu 服务器）
qBittorrent-nox 允许您在无头 Ubuntu 服务器或远程访问的桌面上安装 qBittorrent。借助 WebUI 界面，您可以使用自己喜欢的浏览器高效地管理 qBittorrent。
通过 APT 命令安装 qBittorrent-nox
要安装 qBittorrent-nox，请运行以下命令：
sudo apt install qbittorrent-noxqBittorrent-nox 专为无头客户端而设计，可通过默认本地主机位置的 Web 界面访问：http://localhost:8080。默认情况下，Web UI 访问是安全的。默认用户名是 admin，默认密码是 adminadmin。
为 qbittorrent-nox 创建系统用户和组
您不需要使用终端命令运行 qBittorrent-nox，而是创建一个在后台运行并在系统启动时启动的 systemd 服务单元。
首先，创建一个 qbittorrent-nox 用户和组，以便该服务可以作为非特权用户运行：
sudo adduser --system --group qbittorrent-nox这 --system 标志意味着您正在创建系统用户而不是普通用户。
示例输出：
添加系统用户“qbittorrent-nox”（UID 129）... 添加新用户“qbittorrent-nox”（UID 129）和组“qbittorrent-nox”... 创建主目录“/home/qbittorrent-nox”...
将用户名添加到 qBittorrent 组
接下来，使用以下命令将您的用户名添加到 qbittorrent-nox 用户组：
sudo adduser your-username qbittorrent-nox使用我的用户名的示例：
sudo adduser joshua qbittorrent-nox为 qbittorrent-nox 创建 Systemd 服务文件
创建 systemd 服务文件 qbittorrent-nox:
sudo nano /etc/systemd/system/qbittorrent-nox.service将以下行复制并粘贴到文件中：
[Unit]
Description=qBittorrent Command Line Client
After=network.target
[Service]
Type=forking
User=qbittorrent-nox
Group=qbittorrent-nox
UMask=007
ExecStart=/usr/bin/qbittorrent-nox -d --webui-port=8080
Restart=on-failure
[Install]
WantedBy=multi-user.target保存文件（CTRL+O），然后退出（CTRL+X）。
为 qbittorrent-nox 重新加载 Systemd 守护进程
重新加载 systemd 守护程序以使更改生效：
sudo systemctl daemon-reload启动并启用 qBittorrent-nox
使用以下命令启动 qBittorrent-nox：
sudo systemctl start qbittorrent-nox要让 qBittorrent-nox 在启动时自动启动，请使用以下命令：
sudo systemctl enable qbittorrent-nox继续之前，请检查状态以确保一切正常：
systemctl status qbittorrent-nox访问 qBittorrent Web UI
使用 Web UI，您可以通过本地网络的浏览器访问 qBittorrent。输入服务器的内部 IP 地址，后跟端口号 (8080)，例如 192.168.55.156:8080。如果本地托管，请使用本地主机地址 127.0.0.1:8080。
默认用户名是admin，默认密码是adminadmin。
在采取任何进一步的行动之前，更改默认用户名和密码以保护您的 qBittorrent Web UI 至关重要。要更新登录详细信息，请浏览以下路线：
Tools > Options > Web UI > Authentication此时，您可以将用户名和密码修改为所需的组合。这样做将确保您的 qBittorrent Web UI 保持安全，并且只有获得适当授权的人才能访问。
其他 qBittorrent 命令
更新 qBittorrent 或 qBittorrent-nox
虽然使用命令行终端可能需要更多努力，但它通常是保持系统最新的最有效方法。要更新 qBittorrent 或 qBittorent-nox，请运行以下命令：
sudo apt update如果有 qBittorrent 或 qBittorrent-nox 可用的更新，请执行以下命令继续升级：
sudo apt upgrade删除 qBittorrent 或 qBittorrent-nox
如果您希望卸载 qBittorrent，请按照以下简单步骤操作。首先，如果您按照上一个教程安装了自定义 PPA，请将其删除。
要删除您导入的 PPA，请使用以下命令：
删除 qBittorrent 稳定 PPA：
sudo add-apt-repository --remove ppa:qbittorrent-team/qbittorrent-stable -y删除 qBittorrent 不稳定 PPA：
sudo add-apt-repository --remove ppa:qbittorrent-team/qbittorrent-unstable -y接下来，使用以下命令卸载 qBittorrent：
sudo apt remove qbittorrent对于已经安装 qBittorrent-nox 的用户，请使用以下命令将其删除：
sudo apt remove qbittorrent-nox结论
通过“qBittorrent Team”Launchpad PPA 在您的 Ubuntu 系统上安装 qBittorrent 可确保您可以根据自己的偏好访问最新的稳定或不稳定版本。此方法提供了灵活性，可让您随时掌握最新功能或维护稳定、可靠的种子下载环境。对于服务器管理员，安装 qBittorrent-nox 可让您通过 Web UI 高效管理种子下载，使其成为无头服务器的理想选择。通过 PPA 定期更新将使您的 qBittorrent 安装保持安全且最新，从而确保在 Ubuntu 上获得流畅、高效的种子下载体验。
有用的链接
以下是一些与使用 qBittorrent 相关的有用链接：
- qBittorrent 官方网站：访问 qBittorrent 官方网站，了解有关该应用程序、其功能和下载选项的信息。
- qBittorrent GitHub 存储库：访问 qBittorrent GitHub 存储库以查看源代码、报告问题并为开发做出贡献。
- 维基百科：探索 qBittorrent wiki，获取有关使用 qBittorrent 的详细文档、教程和指南。
- qBittorrent 论坛：加入 qBittorrent 论坛讨论问题、分享解决方案并获得社区支持。
很棒的指南，能够用它设置远程 Web UI qBittorrent 服务器。谢谢！🙂