qBittorrent 配置指南
qBittorrent 是开源免费的 BT 下载客户端，界面类似 µTorrent，无广告。
这篇文档更适合当“安装后第一轮配置清单”使用：先把路径、端口、限速、RSS 和 Web UI 理顺，再开始长期使用，会比后面出问题再回头补设置轻松很多。
安装
winget install qBittorrent.qBittorrent
安装后优先做什么
- 先规划下载盘和分类目录
- 再设置监听端口和上传限速
- 确认是否需要 Web UI 远程管理
- 最后再配置 Tracker、RSS 和搜索插件
基础设置
下载路径
设置 → 下载 → 默认保存路径：选择你的下载目录。
建议至少分开：
- 临时下载
- 长期保种
- 自动订阅
- 不同资源类型分类目录
连接设置
设置 → 连接：
- 监听端口：随机或固定一个端口（如 45000）
- 如果使用路由器，需要在路由器中做端口转发
固定端口更适合长期使用和排障，改来改去只会增加定位成本。
速度限制
设置 → 速度：
- 上传限制：根据带宽设置（建议不超过上行带宽的 80%）
- 可设置计划限速（如工作时间限速）
如果你的网络还承担游戏、视频会议或 NAS 访问，计划限速会非常有用。
Tracker 配置
添加公共 Tracker
设置 → BitTorrent → 勾选「自动添加以下 tracker 到新的 torrent」：
常用 Tracker 列表：
https://trackerslist.com/best.txt
或使用 trackerslist 项目的列表。
公共 Tracker 更适合公开资源环境；对私有站点，不要随意把公共 Tracker 混入种子。
手动添加 Tracker
右键种子 → Trackers → 添加新 Tracker。
RSS 订阅
自动下载新发布的资源：
- 视图 → RSS 阅读器
- 添加 RSS 源 URL
- 设置下载规则：RSS → 下载规则 → 新建规则
- 配置关键词过滤和保存路径
RSS 的关键不是“能不能订”，而是规则是否清晰。建议先用一条简单规则验证，再逐步细化过滤条件。
进阶设置
Web UI
远程管理下载任务：
设置 → Web UI：
- 勾选「启用 Web 用户界面」
- 设置端口（默认 8080）
- 设置用户名和密码
访问 http://localhost:8080 即可远程管理。
如果你要开放到局域网或公网，至少补上强密码、访问范围限制和反向代理保护。
搜索插件
工具 → 搜索引擎 → 安装搜索插件：
- 支持 Nyaa、1337x 等站点
- 插件仓库：qBittorrent 搜索插件
分类管理
右键 → 分类 → 新建分类：
按类型（电影、音乐、软件等）自动分类到不同文件夹。
Docker 部署适合谁
- 想把下载器和主系统隔离
- 已经有 NAS、Docker 主机或家庭服务器
- 希望配置和容器一起迁移、备份、重建
如果只是本机偶尔下载，桌面版通常更直接。
Docker 部署
services:
qbittorrent:
image: linuxserver/qbittorrent
container_name: qbittorrent
environment:
- PUID=1000
- PGID=1000
- WEBUI_PORT=8080
volumes:
- ./config:/config
- /path/to/downloads:/downloads
ports:
- 8080:8080
- 45000:45000
- 45000:45000/udp
restart: unless-stopped
常见问题
速度慢或连不上 peers
- 先确认端口是否真的打通
- 检查是否被系统防火墙、路由器或运营商限制
- 再看种子本身是否冷门、无人做种
Web UI 打不开
- 先确认程序是否运行、端口是否被占用
- 检查是否改过监听地址或访问白名单
- Docker 场景下再检查端口映射和容器状态
RSS 规则误抓了一堆不想要的资源
先把规则拆小，不要一条规则同时负责多个站点、多个关键词和多个分类。
参考链接
- qBittorrent 官网 — 下载
- qBittorrent GitHub — 源码
- Trackerslist — 公共 Tracker 列表
- PT 站点与资源 — 如果你需要的是站点与下载生态整理