跳转到内容

qBittorrent安装

1. 简介

qBittorrent 是一款基于 Qt 库和 libtorrent-rasterbar 开发的开源下载软件，以其简洁的界面、低资源占用和强大的功能（如搜索、RSS、Web 控制台）成为替代迅雷等闭源软件的首选。

2. 部署指南 (Docker Compose)

推荐使用 LinuxServer.io 维护的镜像，其配置灵活且更新及时。

services:
  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qbittorrent
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - WEBUI_PORT=8088
      - TORRENTING_PORT=6881
    volumes:
      - ./config:/config
      - /mnt/data/downloads:/downloads # 映射下载目录
    ports:
      - 8088:8088
      - 6881:6881
      - 6881:6881/udp
    networks:
      - media_network
    restart: unless-stopped

networks:
  media_network:
    external: true

3. 账户与安全管理

3.1. 获取初始密码

在新版本中，默认密码是随机生成的，可以通过查看容器日志获取：

docker logs qbittorrent | grep "The WebUI password is"

3.2. 重置密码

如果忘记了 WebUI 密码且无法通过日志找回，可以采取以下“暴力”方案：

方案 A：删除配置文件重置（会丢失部分设置）：
Terminal window
```
rm config/qBittorrent/qBittorrent.conf
```
方案 B：手动编辑 qBittorrent.conf，找到 WebUI\Password_PBKDF2 行并删除，重启容器后会恢复默认弱密码或重新生成。

4. 进阶技巧：BT 与 PT

BT (Public)：公开种子，人人可下。在没有公网 IP 的情况下，速度可能较慢。
PT (Private Tracker)：私有资源站。有严格的分享率要求（上传量需达到下载量的一定比例），通常能跑满带宽，适合高质量影视资源收集。
端口映射：为了获得最佳上传/下载速度，强烈建议 在路由器上开启 6881 端口的 TCP/UDP 转发。

5. 参考资料