需按系统类型选择安装方式并完成四项初始设置:Windows双击.exe安装、Ubuntu通过PPA安装、macOS拖拽.dmg至应用程序;首次启动后须接受协议、设置下载路径、配置速度限制、启用UPnP并确认端口映射成功。

如果您刚接触qBittorrent,希望快速完成下载、安装及基础配置以开始使用,则需按系统类型选择对应安装方式,并在首次启动后完成关键初始化设置。以下是适用于主流操作系统的具体操作流程:
一、下载qBittorrent安装包
qBittorrent提供官方版、增强版和便携版三种类型,均支持Windows、Linux与macOS系统。官方版纯净无修改;增强版预置反吸血规则与自动Tracker更新功能;便携版无需安装,解压即用。所有版本均适配当前最新系统环境。
1、访问网盘下载地址:https://pan.quark.cn/s/a527d49bed68 或 https://pan.quark.cn/s/87ecd713af3e。
2、根据操作系统选择对应文件:Windows用户下载.exe结尾文件;macOS用户下载.dmg文件;Linux用户可选.tar.gz或通过PPA安装。
3、下载完成后,确认文件完整性,避免使用第三方镜像站提供的非签名安装包。
二、Windows系统安装qBittorrent
Windows平台安装过程简洁,依赖项由安装程序自动处理,无需手动配置运行环境。
1、双击已下载的.exe文件启动安装向导。
2、若弹出Windows Defender SmartScreen警告,点击“更多信息”,再点击“仍要运行”。
3、连续点击“Next”,接受许可协议,保持默认安装路径(C:\Program Files\qBittorrent)。
4、勾选“创建桌面图标”与“将qBittorrent添加到PATH(高级用户)”,点击“Install”完成安装。
5、安装结束后勾选“Launch qBittorrent”,点击“Finish”直接启动软件。
三、Ubuntu系统通过PPA安装qBittorrent
Ubuntu默认仓库中的qBittorrent版本较旧,推荐添加官方PPA以获取稳定更新版本,确保支持最新协议与Web UI特性。
1、打开终端,执行更新命令:sudo apt update && sudo apt upgrade -y。
2、安装必要依赖:sudo apt install -y software-properties-common apt-transport-https。
3、添加官方PPA源:sudo add-apt-repository ppa:qbittorrent-team/qbittorrent-stable。
4、再次更新软件包列表:sudo apt update。
5、安装qBittorrent:sudo apt install qbittorrent -y。
6、安装完成后,在应用菜单中搜索“qBittorrent”并启动。
四、macOS系统安装qBittorrent
macOS用户应通过官方签名的.dmg镜像安装,以确保Gatekeeper校验通过并避免权限阻断问题。
1、双击下载得到的.dmg文件,挂载为虚拟磁盘。
2、将qBittorrent图标拖拽至“应用程序”文件夹内。
3、首次运行时若提示“无法验证开发者”,需前往“系统设置→隐私与安全性”,在“安全性”区域点击“仍要打开”。
4、右键Dock中qBittorrent图标→“选项→在登录时打开”,实现开机自启。
五、首次启动后的初始设置
首次运行qBittorrent会弹出“协议”窗口与设置向导,必须完成以下四项关键配置,否则可能影响下载性能与端口连通性。
1、阅读并勾选“我接受本软件的许可证协议”,点击“下一步”。
2、在“下载”设置页中,点击“浏览”按钮,将默认保存路径改为D:\Downloads(Windows)或~/Downloads(macOS/Linux),确保路径存在且有写入权限。
3、进入“工具→选项→速度”,将“全局下载速度限制”设为0(表示无限制),上传限制设为总带宽的70%,避免上行拥塞影响网络响应。
4、切换至“连接”页,勾选“使用UPnP/NAT-PMP”,在“监听端口”处输入45682,点击右侧“随机”按钮;观察状态灯由黄色变为绿色,表明端口映射成功。











