qBittorrent - Arch Linux 中文维基

跳转到内容

# qBittorrent

来自 Arch Linux 中文维基

翻译状态：

- 本文（或部分内容）译自 qBittorrent，最近一次同步于 2024-01-16，若英文版本有所更改，则您可以帮助同步与翻译更改的内容。
- 您可以在 ArchWiki 的对应页面找到本文翻译的原始修订历史。
- 本文可能与英文原文存在出入。

qBittorrent是一个用C++、Qt和Python（可选搜索引擎）编写的开源跨平台BitTorrent 客户端，使用libtorrent-rasterbar包库。

它速度快，稳定性高，体积轻，支持unicode并提供集成搜索引擎。它支持UPnP端口转发 / NAT-PMP，加密（与Vuze兼容），FAST扩展（主线）和PeX支持（与uTorrent兼容）。

## 安装

在官方仓库中有两个软件包可以用于安装qBittorrent：

- qBittorrent — 具有Qt图形界面和#Web 界面。

  https://github.com/qbittorrent/qBittorrent || qbittorrent包

- qBittorrent-nox — 无图形界面的版本(nox -> no X server)。

  https://github.com/qbittorrent/qBittorrent || qbittorrent-nox包

## 配置

在第一次运行程序时，配置文件会保存在`~/.config/qBittorrent/qBittorrent.conf`中。

### 自启动

如果你安装了qbittorrent-nox包，你将会得到一个systemd单元模板：`qbittorrent-nox@.service`。

如果你启用、启动`qbittorrent-nox@username.service`，QBittorrent 将以用户 `username`运行。参见[1]。

默认的下载文件夹会是该用户的`Downloads`目录。

提示：

- 如果你把它作为一个可以访问的服务运行，可以添加一个叫做qbittorrent的用户并让它在那个用户下运行，使得该服务可以在程序退出后重新启动。
- 要修改设置（例如端口），你可以为它的systemd单元添加一个环境变量（例如端口的变量就是QBT_WEBUI_PORT）。执行`qbittorrent-nox --help`可以查看更多其他的环境变量（此信息在手册中并未给出）。

## 搜索引擎

你可以通过菜单视图> 搜索引擎启用可选搜索引擎，这将启用搜索标签页。

### 搜索插件

默认的搜索插件可通过下面的操作添加/启用：转到搜索标签页，中打开追踪器窗口后通过搜索插件...（右下角按钮），并点击查找更新。

更多非官方的搜索插件可以在这里找到。

## 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@用户名.service`。

### 反向代理配置

#### nginx

请参考qbittorrent wiki

## 主题

### 非官方主题

- 如何使用自定义UI主题
- 已知的qBittorrent主题列表

## 故障排查

## 另见

- qBittorrent官方网站
- qBittorrent在GitHub的wiki
- Wikipedia:qBittorrent

分类：​

- BitTorrent

qBittorrent
添加话题