qBittorrent

出自 ArchWiki

qBittorrent 是一个开源且跨平台的 BitTorrent 客户端,使用 C++, QtPython (可选搜索引擎) 编写,并使用 libtorrent-rasterbar 库。

它快速、稳定且轻巧,支持 Unicode 并提供集成的搜索引擎。它自带 UPnP/NAT-PMP 端口转发、加密、FAST 扩展和 PeX 支持。

安装

官方仓库中有两个软件包可以安装 qBittorrent:

https://github.com/qbittorrent/qBittorrent || qbittorrent
  • qBittorrent-nox — 没有图形界面 (nox -> no X server)。
https://github.com/qbittorrent/qBittorrent || qbittorrent-nox
注意: 尽管 qbittorrent-nox 不直接依赖 Xorg,但它的依赖项 qt6-base 当前依赖于 X 工具和 Mesa,这将增加约 300M 的安装大小。为了最小化安装大小,请在安装 qbittorrent-nox 之前,安装 qt6-base-headlessAURqt6-base-noguiAUR 而不是 qt6-base

配置

配置文件在首次运行程序时创建于 ~/.config/qBittorrent/qBittorrent.conf

自动启动

提示: 要修改设置(即端口),请使用环境变量(对于端口,它是 QBT_WEBUI_PORT),方法是为其 systemd 单元使用drop-in 文件。运行 qbittorrent-nox --help 以了解有关其他环境变量的更多信息(此信息未在手册中说明)。

以软件包创建的 qbt 用户身份运行

截至 qbittorrent-nox-5.0.4-3,将在安装时创建一个非特权用户 qbt。该软件包还附带 qbittorrent-nox.service,其中硬编码了此用户。

要查看启动守护程序后 WebGUI 的 OTP,请查看 systemctl status qbittorrent-nox 的输出。

为了防止将法律声明写入 journalctl,请编辑 /var/lib/qbittorrent/.config/qBittorrent/qBittorrent.conf 并添加以下内容

[LegalNotice]
Accepted=true

以任何用户身份运行

另一种选择是运行 qbittorrent-nox@.service,其中 QBittorrent 将以定义的用户身份运行。

搜索引擎

可以通过菜单 查看 > 搜索引擎 启用可选的搜索引擎,这将打开搜索选项卡。

搜索插件

可以在搜索选项卡中添加/启用默认跟踪器,方法是使用搜索插件...(右下角)打开跟踪器窗口,然后按检查更新。更多非官方搜索插件可以在这里找到。

Web 界面

默认位置

默认情况下,qBittorrent 将监听端口 8080 上所有接口。因此,可以通过 http://HOST_IP:8080 访问它。

注意: 默认情况下未启用 HTTPS,因此无法访问 https://HOST_IP:8080

默认用户名和密码

默认用户名是 admin,5.0.0 之前的版本的默认密码是 adminadmin。5.0.0 及更高版本生成一个随机密码,该密码在控制台中可见,直到手动保存以防止未经授权的访问。有关此更改的更多信息,请参见此处

允许无需用户名和密码即可访问

在家庭环境中,通常希望允许访问 Web UI,而无需输入用户名和密码。这可以在使用默认用户名和密码登录后在 Web UI 本身中进行配置。

或者,为了避免首次登录,请将以下部分添加到 ~/.config/qBittorrent/qBittorrent.conf

[Preferences]
WebUI\AuthSubnetWhitelist=192.168.1.0/24
WebUI\AuthSubnetWhitelistEnabled=true
WebUI\UseUPnP=false

以上配置项将

  • 允许从 192.168.1.x 登录的客户端无需输入用户名和密码即可访问 Web UI。
  • 禁用 Web UI 的 UPnP,以便 Web UI 不会从网络外部访问。

之后,重新加载 qbittorrent-nox@username.service

反向代理配置

nginx

请参阅 qbittorrent wiki

主题

非官方主题

故障排除

qBittorrent 停止下载(重启后)

有时,关闭 qbittorrent 后,搜索引擎的 nova 组件不会终止。这样做会绑定相应的端口(如果已设置端口)。因此,必须手动终止 nova 插件

 $ killall nova

参见