查看“︁Qb的选项及操作 - 基于Docker”︁的源代码

== qbittorrent的安装 ==
> app市场搜索【'''qbittorrent'''】，直接用这个'''linuxserver'''版本的就行

<html><img loading="lazy" style="width: 800px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/01.avif' /></html>

最新版本是4.4.x的，如果是重度qb使用者，那么推荐用4.3及以下的版本，比如4.3.9的就行，前者会有一些奇奇怪怪的问题<sup>(避免使用新版本以规避成为新版本bug测试员的可能性)</sup>

> 上图中'''点击安装'''，跳转至'''配置'''页面

> 修改【'''Repository'''】的'''镜像源标签'''至你需要的版本

> 添加'''qb默认下载目录'''对应的共享文件夹

<html><img loading="lazy" style="width: 800px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/02.avif' /></html>

我这里是要下载4.3.9的所以标签（后缀）是【'''14.3.9'''】

你可以根据自己的需要变换标签来拉取不同的版本：https://hub.docker.com/r/linuxserver/qbittorrent/tags 

> 点击【'''apply'''】并等待镜像拉取完成，拉取完成后点击【'''done'''】即可

<html><img loading="lazy" style="width: 800px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/03.avif' /></html>

> 在【'''docker'''】面板中点击【'''qbittorrent'''】图标，在弹出的菜单中选择【'''web ui'''】进入web端

<html><img loading="lazy" style="width: 800px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/04.avif' /></html>

默认登录用户名：'''<code>admin</code>'''

默认登录密码：<code>'''adminadmin'''</code>

<html><img loading="lazy" style="width: 800px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/05.avif' /></html>

== qb的基础设置 ==

=== 1、设置自动启动qb ===
这样重启系统之后不用手动开启qb

<html><img loading="lazy" style="width: 800px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/06.avif' /></html>

=== 2、设置qb界面语言 ===
> 进入qb '''web ui'''

> 点击【'''tools'''（工具）】——【'''options'''（选项）】——【'''Web UI'''】的“'''lannguage'''（语言）”中选择系统语言为【'''简体中文'''】

> 拉到最下面点击【'''save'''（保存）】保存设置

<html><img loading="lazy" style="width: 800px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/07.avif' /></html>

示例：

<html><img loading="lazy" style="width: 800px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/08.avif' /></html>

=== 3、设置用户名密码和白名单 ===
> 在【'''选项'''】——【'''Web UI'''】中的“'''验证'''”中'''修改用户名和密码'''、'''白名单及安全策略'''

<html><img loading="lazy" style="width: 600px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/09.avif' /></html>

=== 4、添加tracker ===
> 在【'''选项'''】——【'''BitTorrent'''】中最后一个框里输入tracker链接：

* 可以参考：https://github.com/ngosang/trackerslist 、https://github.com/XIU2/TrackersListCollection 、https://newtrackon.com/

<html><img loading="lazy" style="width: 600px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/10.avif' /></html>

到这里你就可以直接开玩了，但是如果要玩的明白、玩的痛快，玩的舒服，你还要对qb有一个深入的认知（文末有我自己在设置的参数总结）：

== qb设置详解 ==

=== “下载”项 ===

==== 1、torrent内容布局 ====
<sup><code>Torrent content layout / torrent内容布局</code></sup>

* '''Original / 原始'''：种子文件结构长什么样就还是什么样
* '''Create subfolder / 创建子文件夹'''：下载无父目录的文件时，譬如就一个“电视.mp4”文件，就会自动创建一个子文件夹，就变成了“电视/电视.mp4”
* '''Don't create subfolder / 不创建子文件夹'''：跟上面相反，会取消掉一层子文件夹
** 把“电视/电视.mp4”变成“电视.mp4”
** 把“电视/历史剧/影视.mp4”变成“历史剧/影视.mp4”

无特殊需求用“原始”即可

如过想要 文件有其父目录 ，可以设置为“创建子文件夹”

如果想走高diy路线（比如自己对影视有一套自己的命名方式）可以设置为“不创建子文件夹”

ps：这个是默认选项，在添加种子时可以单独设置策略，种子添加后也可以在种子详情页右键目录修改目录名称
----'''不要自动开始下载'''：添加种子或磁力后不下载而是处在暂停状态，需要手动开启，一般不勾选

'''完成后删除 .torrent 文件'''：添加种子成功后自动删除种子文件，一般搭配【监控文件夹】使用，直接把种子推送到监控的文件夹，然后qb自动添加任务，任务添加完成后种子文件自动删除。
----'''为所有文件预分配磁盘空间'''：提前占用磁盘空间，以免磁盘空间不够，各种下载工具常见的策略，自己随心情设置即可，我是不勾选

'''为不完整的文件添加扩展名 .!qB'''：默认未下载完成的文件拓展名的正常的，开启后，未下载完成的文件会被加上qb的拓展名，可以提高辨识度

==== 2、保存管理 ====
<sup><code>Saving Management / 保存管理</code></sup>

'''默认 Torrent 管理模式'''：

* <u>手动</u>：手动设置，没什么好说的，下面的所有手动设置都一样，手动就是只有你手动修改时才会有变化，否则无变化
* <u>自动</u>：一般是配合Sonarr/Radarr这类工具跟流媒体平台搭配使用的自动化追影策略。也可以跟qb的其他设置联动，实现根据类别自动归类文件存储位置

'''当 Torrent 分类修改时'''：

* <u>重新定位 Torrent</u>：根据分类自动变更文件存储位置（仅限开启了自动管理的种子）
* <u>切换 Torrent 到手动模式</u>：不做更改，并把受影响的种子从自动管理切换至手动模式

'''当默认保存路径修改时、当分类保存路径修改时'''：

* <u>重新定位受影响的 Torrent</u>：自动根据默认路径或分类路径的新目录更变文件存储位置（仅限开启了自动管理的种子）
* <u>切换受影响的 torrent 至手动模式</u>：不做更改，并把受影响的种子从自动管理切换至手动模式

'''默认保存路径'''：默认保存的目录，qb默认设置的“/downloas/”这个目录是你在初配置时选择的目录，两者是映射关系，qb内的“/downloads/”就是那个目录，不要随意修改，后面也会介绍添加多条映射

'''保存未完成的 torrent 到'''：将未下载完成（包括下载中）的种子文件保存在指定的文件夹中，种子下载完成后会自动转移过来。一般是搭配固态硬盘玩的，让种子在固态盘读写，然后下载完成再一并移动入机械盘，可以减少对机械盘的读写时间，放置卡机械硬盘io，顺便减少些噪音（机械盘的炒豆子声音）

'''复制 .torrent 文件到'''：如果不想删除种子文件，勾选这里，并设置一个目录用来存放种子文件（**至于这个是单纯的复制还是移动，与一开始的自动删除是否冲突我试验了再说**）

'''复制下载完成的 .torrent 文件到'''：从字面意思上看，这条是只复制已经下载完成的种子文件，那么上一条就是不管是否下载完成都复制的。具体含义还是我试验了再说，先按字面意思理解即可

==== 3、自动从此处添加 torrent ====
<sup><code>Automatically add torrents from / 自动从此处添加 torrent（监控文件夹）</code></sup>

'''监控文件夹'''：要监控的文件夹，填写规范：“qb下载文件夹/文件夹”，示例“/downloads/设置的文件夹”

'''覆盖保存位置'''：

* <u>监控文件夹</u>：即监控的路径
* <u>默认保存位置</u>：系统设置的默认保存路径
* <u>其他……</u>：自定义指定一个路径

点击右侧的小文档图标即可添加一条规则

==== 4、下载完成时发送邮件通知 ====
<sup><code>Email notification upon download completion / 下载完成时发送电子邮件通知</code></sup>

'''从'''：发送信件的邮箱地址

'''到'''：接受信件的邮箱地址

'''SMTP服务器'''：这个看邮件服务商提供的地址

'''该服务需要安全链接（SSL）'''：一般都需要ssl验证

'''验证'''：勾选即可

* <u>用户名</u>：验证账户
* 密<u>码</u>：密码

这个其实很简单，就是普通的邮件转发功能，不同邮件服务商如果没有公示smtp服务器地址可以搜索引擎找或者联系客服。（**过段时间我会设置一套然后再贴出来，之前设置阿里云自建邮箱转发到谷歌邮箱时给阿里云客服要过相关的资料**）

==== 5、Torrent 完成时运行外部程序 ====
<sup><code>Run external program on torrent completion / Torrent 完成时运行外部程序</code></sup>

这个是跟脚本强联系的，用来自动化处理一些操作，比如复制、归类特定或特定类别、标签的文件等等（**目前用不到等用到了研究一下再贴**）

=== “链接”项 ===

==== 1、监听端口 ====
<sup><code>Listening Port / 监听端口</code></sup>

'''用于传入连接的端口'''：这个建议随机一个端口，因为bt常用的一些端口很容易被封，连通性差

'''使用我的路由器的 UPnP / NAT-PMP 功能来转发端口'''：UPnP的好处是自动打开所需要的端口，来提高连通性，而不用你自己费尽心思的设置端口转发，建议开启。但前提是要有公网ip。因为UPnP包括nat转发归根结底是减少数据的中转和冗余，大内网情况下，设置与否意义不大。

'''Use different port on each startup'''：每次启动时使用不同的端口，规避被禁端口的一种策略，开启了UPnP的情况下，他自己变端口也是不影响连通性的，不过对于一直在线的玩家来说意义不太大，但也不是没有，长期某端口大量流量导致被运营商针对也不是啥新鲜事，属于尝鲜的设置，可以根据需要选择是否开启。

==== 2、连接限制 ====
<sup><code>Connections Limits / 连接限制</code></sup>

'''全局最大连接数'''：所有种子连接的用户（节点，下均称“节点”）数量限制

'''每 torrent 最大连接数'''：单个种子连接的节点数量限制

'''全局上传窗口数上限'''：

'''每个 torrent 上传窗口数上限'''：
----代理服务器就不说了
----

==== 3、ip过滤 ====
<sup><code>IP Filtering / ip过滤</code></sup>

这个怎么说，说神就神，说鸡肋就鸡肋

因为全球都是动态ip的天下，固定ip少之又少，不过可以禁用ip段，毕竟比如吸血雷和一些isp审查方或者机构再者某区域的ip段都是固定或很难改变的

可以用来防吸血，现在的话这项功能的存在感也是越来越弱了

这里也就不展开说了

=== “速度”项 ===
这项就是对速度的限制，默认是不限速的。如果需要的话可以设置限速。或者对指定时间段进行速度限制

※ 不过要注意如果限制了下行速度为0，或许也会使上行速度为0(或极小)，pt玩家或会通过此设置规避跑下载量，但或也会因此设置被判定为极端限速。

=== “BitTorrent”项 ===

==== 1、隐私 ====
<sup><code>Privacy / 隐私</code></sup>

'''启用 DHT (去中心化网络) 以找到更多用户'''：如果你是专门玩pt则这项不需要开启，如果顺便下载公网种子，建议开启此项，可以在tracke未尽之处尽量寻找到更多的节点，又因为现在的种子客户端的管理策略都很成熟了，私人种子会自动禁用dht等功能的，不必担心冲突

'''启用用户交换 (PeX) 以找到更多用户'''：同上

'''启用本地用户发现以找到更多用户'''：字面意思理解是本地节点，用作于大型局域网比较方便（比如学校和大公司），提高传输速度并且减少对互联网（公网）的依赖，流量在局域网内部，不经由isp服务商，也可以规避版权审查等问题。但是一般人用不到，我好奇的是那些德国战车们用的是不是一家的，如果是且它们开启了这个选项的话，有没有一种可能，真的就盒子跟盒子玩？毕竟本地节点有限度肯定高于外部节点

'''加密模式'''：

* <u>允许加密</u>：默认设置，允许未加密和加密的客户端连接，较为开放
* <u>强制加密</u>：仅限加密的流量连接，常用来隐藏自己的流量，因为强制仅允许同样加密的流量的节点连接，ips服务商理论上只能看到你有流量传输出去（对方节点也有流量传出去），但不知道具体用来做什么，可以规避版权审查。如果允许未加密的流量/节点，则可以通过查看对方的流量走向来审查到你，并且这里的加密并不是数据加密，而是数据混淆。具体原理谷歌吧
* <u>禁用加密</u>：完全开放，不建议设置

'''启用匿名模式 (更多信息)'''：没有了解

ps：不管是加密还是代理，绝大多数情况下都是国外isp版权审查比较严格的产物，用来规避审查的，因为国外的isp服务商会封禁掉玩bt的用户的宽带，国外对版权管理的比较严。国内相对基本等于没有管控，所以不用太过在意

==== 2、Torrent排队 ====
<sup><code>Torrent Queueing / Torrent排队</code></sup>

设置'''最大下载'''/'''上传'''或'''总活动'''的种子数量，超出数量限制就显示“排队中”，本意也是资源控制策略，但是一般我们不需要所以

==== 3、做种限制 ====
<sup><code>Seeding Limits / 做种限制</code></sup>

当'''做种分享率'''/'''做种时间'''到指定值后'''暂停'''/'''删除种子任务'''/'''删除种子任务及文件'''/'''启用超级做种'''的自动处理规则

==== 4、自动添加tracker ====
<sup><code>Automatically add these trackers to new downloads / 自动添加以下tracker到新的torrent</code></sup>

见[[#4、添加tracker]]

=== “RSS”项 ===
这个等我研究透了、过几天研究流媒体平台时再详细写

=== “Web ui”项 ===
'''语言'''见[[#2、设置qb界面语言]]

'''web用户界面（远程控制）'''：'''ip地址'''默认星号即可，代表本地地址，不要随意修改，'''端口'''是访问时要加的端口，可以在docker里设置也可以直接在这里设置

如果需要用'''https访问'''并且有证书可以勾选并填写证书和密钥即可，若无不用管

验证见[[#3、设置用户名密码和白名单]]

==== 1、使用备用 Web UI ====
如果你觉得当前的webui样式不好看，可以网上找一套webui配置文件，并且放在qb可访问的目录下，在文件路径里指定存放配置文件的目录即可

一些WebUI项目：https://github.com/qbittorrent/qBittorrent/wiki/List-of-known-alternate-WebUIs

==== 2、验证 ====
'''启用“点击劫持”保护'''：点击劫持是一种恶意攻击方式，就是假装一个很正常的元素，实际上却隐藏了很多恶意代码，你点击的话表面上看是触发了无关紧要的东西，实际上可能是给予了其莫大的权限，开启点击劫持可以大幅度规避此风险。具体原理可以搜索“点击劫持”关键词查询

'''启用跨站请求伪造 (CSRF) 保护'''：跟上面差不多，具体搜索关键词查询，两个都是默认开启的，上面保持开启就行，这个建议关闭，因为诸如ptpp等需要从外界直接控制qb（远程提交下载任务）就属于跨站请求，开启了的话会导致下载失败。

'''启用cookie安全标志（需要HTTPS）'''：默认无法选中，因为没有https，不用管它

'''启用 Host header 属性验证'''：如果你有公网ip建议关闭，开启会导致无法通过公网ip访问qb webui，并且一定不要填写或修改里面的内容，会导致你内网也无法访问，只能修改配置文件，修改完配置文件还会有各种bug，别问我怎么知道的，都是泪
----'''更新我的动态域名'''：一个内置的ddns服务，不过用处不大，直接路由器端口转发就行，开启了也不知道会不会有什么冲突

=== “高级”选项 ===
见：https://github.com/qbittorrent/qBittorrent/wiki/Explanation-of-Options-in-qBittorrent#Advanced 

　

== 我的设置 ==
总结一下，基本的设置也就是：

==== 下载 ====
> 添加种子文件时：内容布局为'''创建子文件夹'''（谨慎使用，因为可能会不利于转移种子到其他平台以及管理，如果是普通pt玩家，注重日后转移、交叉做种请用“原始”）、'''完成后删除种子文件'''。

> 保存管理：管理模式为'''自动'''、三项参数修改时均'''重新定位种子文件'''

> 自动从此处添加种子：设置'''监控文件夹'''及对应目录

<html><img loading="lazy" style="width: 500px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/11.avif' /></html>

<html><img loading="lazy" style="width: 500px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/12.avif' /></html>

==== 链接 ====
> 监听端口：设置'''端口'''和'''开启upnp'''

<html><img loading="lazy" style="width: 500px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/13.avif' /></html>

==== 速度 ====
> 取消速度限制/或根据需要添加速度限制

<html><img loading="lazy" style="width: 500px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/14.avif' /></html>

==== bittorrent ====
> 隐私设置、关闭排队和各种限制（我这个不跑bt，所以没有添加torrent，你也不跑的话可以关掉dht，我是懒得弄，因为开着也无所谓）

<html><img loading="lazy" style="width: 500px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/15.avif' /></html>

==== WebUI ====
> 设置语言

> 设置用户名

> 设置ip白名单（根据需要设置）

> 开启点击劫持保护、关闭跨站请求伪造保护

> 关闭host验证

<html><img loading="lazy" style="width: 500px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/16.avif' /></html>

==== 高级 ====
里面其实不用怎么设置，但有一点，如果私人tracker连接不上的情况下可以尝试把“'''验证 HTTPS tracker 证书'''”取消勾选，因为一些站点是没有https的或者证书失效

<html><img loading="lazy" style="width: 500px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/17.avif' /></html>

具体的话有时间了再根据自己的理解本土化更新一波

因为本系列是学以致用、温故知新的目的，而不是纯粹的科普，我也没到那个级别

== qb进阶操作 ==

==== 1、添加多条下载路径映射 ====
<html><img loading="lazy" style="width: 900px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/18.avif' /></html>

<html><img loading="lazy" style="width: 800px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/19.avif' /></html>

<html><img loading="lazy" style="width: 900px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/20.avif' /></html>

下载时根据需要把默认的“/downloads/……”变成“/收藏/……”即可

==== 2、恢复保种/备份数据 ====
无旧存档：

需要存储路径一致，直接添加种子就行了

如果英文路径请注意区分大小写，不然可能会有奇奇怪怪的bug，比如我刚刚损失了一百多G的一个包

直接添加种子会进入校验状态，校验完毕后即可恢复保种状态

如果种子数量多，只能手动慢慢的恢复或者写脚本，目前没有较好的解决方案

最多也就是设置监控文件夹，省去一个手动添加种子的步骤
----有旧存档 / 新备份：

在appdata文件夹中找到qbittorrent目录备份如下文件/文件夹

> '''BT_backup'''：种子存档，就是你当前做种的所有种子文件，备份该文件夹，导入新qb的目录中，即可恢复做种的种子，而无需重新下载添加

> '''qBittorrent-data.conf'''：保存了统计数据，按照需要备份即可，可有可无

> '''qBittorrent.conf'''：qb的配置文件，qb的设置，按照需要备份即可

<html><img loading="lazy" style="width: 800px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/21.avif' /></html>

==== 3、更改种子名称 ====
> '''选择目标种子'''--在详情栏的内容框中'''右键需要重命名的目录'''、'''文件'''--'''选择重命名'''--'''输入名称'''--'''保存'''即可 

<html><img loading="lazy" style="width: 800px;" src='https://scio.eu.org/WIKI/图片/互联网漫游/Unraid/qb的选项及操作/22.avif' /></html>

==== 4、开启upnp后可连接为否 ====
开启upnp后可链接还是为否

这个具体原理我也不太清楚，应该是站点检测模式的问题，或者部分tracker服务器的问题

想要解决这个问题的话，可以路由器手动设置端口映射

把qb的链接端口手动转发出去，可连接就是“是”了

至于对速度的影响吗，这个真不好说，反正我感知下区别不大

==== 5、种子被删了怎么排查 ====
这个通常出现在pt领域 ，不同于tr连不上tracker会红种，qb没有任何提示，一些站点会在剧集完结后出一个合集删掉之前发的分集，因此有些人不知道怎么删掉那些分级

其实很简单，做种人数排序，为零的就是喽（注意哪些是网络质量问题，哪些是需要删的，凡是莫无脑操作）
[[Category:名词]]