前言
在日常学习、工作与生活中，资源下载早已成为刚需场景。无论是高清影视剧集、专业学习课件、开源软件安装包，还是各类小众优质素材、大容量备份文件，我们时常需要通过BT协议获取优质网络资源。但绝大多数普通用户的下载体验，始终充斥着各类痛点与局限：主流下载工具广告弹窗泛滥、会员限速严重，免费下载动辄卡顿断连；传统客户端只能绑定单台电脑使用，外出、出差时无法远程管控下载任务，回家后错过资源更新、下载超时是常态；同时还存在文件分类混乱、无法自动批量更新、隐私安全性不足等诸多问题，极大拉低了资源获取的效率与体验。
相较于商业化下载工具的套路化限制，qBittorrent-webui网页BT下载服务凭借开源免费、无广告、无强制限速的核心优势，成为个人与家庭资源圈的刚需神器。区别于传统桌面客户端，其核心亮点在于搭载完整网页可视化管理界面，彻底打破设备与场景壁垒，无需局限于本地电脑，手机、平板、任意电脑浏览器均可随时随地远程登录，一键新增、暂停、排序、清理下载任务，完美适配居家、办公、外出等全场景使用需求。
对于学生党而言，它可以自动RSS订阅学习资源合集，批量下载网课资料、学术文献，无需手动蹲守更新；对于影音爱好者，能够高速稳定下载高清无压缩影视资源，支持文件分类存储、优先级调整，告别画质压缩与资源缺失问题；对于办公人群、NAS与家庭服务器用户，可7×24小时挂机稳定下载，后台静默运行不占用设备性能，还能通过节点过滤、加密连接保障下载隐私，搭配智能队列管理、自定义存储路径，让大容量资源下载、归档、管理井然有序。
无需复杂的专业技术，通过简单的搭建部署，即可拥有一款纯净、高效、可控的专属BT下载工具。彻底摆脱商业软件的限速捆绑、广告骚扰与设备限制，实现真正意义上的自由下载、远程管控、智能管理。本文将从零出发，结合真实使用场景，详细讲解qBittorrent-webui网页BT下载服务的完整搭建流程，帮助每一位用户搭建专属私人资源下载站，轻松解决日常资源下载的各类难题。
1.qBittorrent是什么？
qBittorrent是一款开源免费、无广告的 BT (P2P) 下载客户端，用来下载磁力链接、torrent种子文件，替代迅雷这类商业下载软件，跨平台支持Windows、Linux、macOS、NAS，自带WebUI网页管理功能。
核心特点
- 完全开源免费，没有广告，没有会员限速 没有付费套路，不会偷偷限速，也不会弹窗推送广告，这是它最核心的优势。
- 支持WebUI网页界面（qBittorrent‑webui） 这也是我们搭建服务的关键：开启WebUI之后，不用坐在本机操作。手机、别的电脑浏览器输入地址，就可以远程添加、暂停、管理下载任务，适合服务器 / NAS 7×24 小时挂机下载。
- 完整 BT 功能
- 支持种子文件、磁力链接
- RSS 订阅自动下载，追剧集、更新资源非常好用
- 设置下载 / 上传限速、任务队列、分类保存路径
- IP过滤、连接加密，丰富的高级参数
- 轻量低占用 资源消耗小，可以放在NAS、低功耗小主机后台长期挂机跑下载任务。
qBittorrent 和 qBittorrent‑webui 的关系
- qBittorrent：本体程序，桌面版是本地软件；Linux部署版本可以只跑后台服务。
- qBittorrent‑webui：就是它自带的网页控制面板。
简单理解：qBittorrent是下载引擎，webui是远程操作它的网页控制台。
适合哪些人
- 厌烦商业下载软件广告、限速的普通用户
- NAS / 家庭服务器玩家，想要7×24小时挂机下载
- 需要远程在外手机操控家里下载任务
- 需要RSS自动批量拉取资源
2.安装前提条件
2.1ssh远程连接到飞牛
- 开启【SSH服务】
- 使用终端（Windows PowerShell / Mac Terminal）登录：
在设置—>SSH中开启SSH服务：
2.2验证docker是否开启
使用命令：
docker -v
systemctl status -v
也可以直接在飞牛主页查看（其他机器也是这样的哦~）
3.安装qBittorrent
首先创建一下安装所需要的目录并进入到该目录：
mkdir -p /docker/qbittorrent/config
mkdir -p /docker/qbittorrent/downloads
cd qbittorrent/
创建并编辑 docker-compose.yml文件：
vi docker-compose.yml
services:
qbittorrent:
image: lscr.io/linuxserver/qbittorrent:latest
container_name: qbittorrent
environment:
- PUID=1000
- PGID=1000
- TZ=Asia/Shanghai
- WEBUI_PORT=8860
volumes:
- ./config:/config
- ./downloads:/downloads
ports:
- "8860:8860"
- "6881:6881"
- "6881:6881/udp"
restart: unless-stopped
启动容器：
docker-compose up -d
验证docker状态：
docker ps
查找qbittorrent的日志，查看登录密码：
docker logs qbittorrent
部署完成后，在浏览器中输入 http://极空间IP:8860 就能看到qBittorrent‑webui的界面：
4.使用qBittorrent
4.1 初始化
用上面搜索日志，查到的密码进行登录：
成功登录到主页啦！
修改系统自带密码：
qBittorrent的设置界面，点开顶部齿轮设置图标，切换到BitTorrent选项卡，图中红框标注了「Automatically append trackers from URL to new downloads」（从URL自动为新下载任务追加tracker服务器）配置项，可以勾选该选项并填入tracker订阅链接，实现新建种子自动追加远程获取的Tracker列表，用来提升BT下载的连接与做种能力。
该图展示qBittorrent设置的BitTorrent标签页，已经勾选“从URL自动为新下载追加tracker”选项，填入公开tracker订阅地址https://cf.trackerslist.com/all.txt，配置完成后点击Save保存，后续新增BT任务会自动拉取远程Tracker列表，改善种子的连接、下载与做种效果。
qBittorrent的设置界面，点击顶部齿轮设置图标后切换到WebUI选项卡，红框标注了启用替代WebUI的配置项，勾选Use alternative WebUI并指定文件路径/docker/qbittorrent/webui，用于加载自定义第三方网页界面，替换qBittorrent原版Web管理页面。
qBittorrent设置窗口，点击顶部齿轮图标进入设置后切换到Behavior（行为）标签页，红框标出用户界面语言选择项设置为简体中文，该页面还包含界面主题、双击动作、日志保存路径等相关界面与日志行为配置，用来调整软件的显示语言与交互习惯。
4.2 下载操作
qBittorrent的WebUI操作界面，点击左上角红框标记的从URL下载按钮，弹出 “从URL下载” 弹窗，红框为链接输入区域，界面中已有一个Ubuntu镜像任务处于下载元数据阶段，该弹窗支持粘贴磁力链接、种子直链或者哈希值来批量添加BT下载任务。
qBittorrent的操作界面，用户点击左上角加号准备导入85KB的.magent种子文件，弹窗选中该torrent文件：
也可以上传所有文件哦~
qBittorrent作为强大的BT下载工具，搭配cpolar内网穿透可以突破局域网限制，无需公网IP，就能把NAS上的qBittorrent WebUI安全暴露到公网，随时随地在外网浏览器访问下载管理界面，远程添加种子、监控下载进度、调整任务参数，不用繁琐配置路由器端口映射，简单部署即可实现异地操控家庭内网的BT下载服务。
5.安装cpolar实现随时随地开发
5.1 什么是cpolar？
cpolar是一款安全高效的内网穿透工具，无需公网IP或复杂配置，只需一条命令，即可将本地服务器、Web服务或任意端口映射到公网，让你随时随地远程访问内网应用，特别适合开发调试、远程运维和应急部署等场景。
5.2 部署cpolar
cpolar可以将你本地电脑中的服务（如SSH、Web、数据库）映射到公网。即使你在家里或外出时，也可以通过公网地址连接回本地运行的开发环境。
❤️以下是安装cpolar步骤：
使用一键脚本安装命令：
sudo curl https://get.cpolar.sh | sh
安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）
sudo systemctl status cpolar
Cpolar安装和成功启动服务后，在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面，使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：
打开浏览器访问本地9200端口，使用cpolar账户密码登录即可,登录后即可对隧道进行管理。
6.配置公网地址
登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道：
- 隧道名称：可自定义，本例使用了：qBittorrent，注意不要与已有的隧道名称重复
- 协议：http
- 本地地址：8860
- 域名类型：随机域名
- 地区：选择China Top
创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址，接下来就可以在其他电脑或者移动端设备（异地)上，使用地址访问。
访问成功。
7.保留固定公网地址
使用cpolar为其配置二级子域名（cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站），该地址为固定地址，不会随机变化。
点击左侧的预留，选择保留二级子域名，地区选择china Top，然后设置一个二级子域名名称，我使用的是qBittorrent，大家可以自定义。填写备注信息，点击保留。
登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道，点击右侧的编辑。
修改隧道信息，将保留成功的二级子域名配置到隧道中
- 域名类型：选择二级子域名
- Sub Domain：填写保留成功的二级子域名
- 地区: China Top
点击更新
更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。
最后，我们使用固定的公网地址在任意设备的浏览器中访问，可以看到成功访问的页面，这样一个永久不会变化的二级子域名公网网址即设置好了。
总结
本篇教程主要讲解在NAS/Linux环境部署qBittorrent‑webui网页版BT下载服务，借助Docker快速完成容器化安装，通过网页端即可完成种子、磁力链接的下载管理；同时结合cpolar内网穿透工具，无需公网IP、不用配置路由器端口转发，轻松将内网qBittorrent WebUI发布至公网，实现外网随时随地远程添加种子、查看下载进度、管控下载任务。搭建过程中需要重点留意系统磁盘空间、目录权限、UID/GID配置问题，避免因根分区占满引发下载0速度、磁盘识别异常等故障，完成部署后就拥有一套可异地访问、功能完备的私有BT下载工具。
感谢您对本篇文章的喜爱，有任何问题欢迎留言交流。cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站
